README

This PHP wrapper provides an easy-to-use interface for interacting with the Google Places API. It simplifies the process of making API requests for place searches, place details, and autocomplete features. The wrapper handles API authentication, request formatting, and response parsing, allowing developers to integrate Google Places functionality into their PHP applications with minimal effort.

Features

Nearby Search: Search for places near a specified location within a given radius.
Place Details: Retrieve detailed information about a specific place using its place ID.
Text Search: Search for places based on a text query.
Autocomplete: Get place suggestions based on partial user input.

Installation

To use this wrapper, you'll need to have Composer installed.

composer require mustafakucuk/google-places

Usage

Initialization

Before you can make any requests, you need to initialize the client with your Google Places API key:

use GooglePlaces\Client;

$client = new Client('your_api_key_here');

Nearby Search

Search for places near a specified location within a given radius:

$location = '37.7749,-122.4194'; // Latitude, Longitude
$radius = 500; // Radius in meters
$params = [
    'includedTypes' => ['restaurant'],
    'fields' => ['places.id', 'places.displayName'],
];

$places = $client->near_by_search($location, $radius, $params);
print_r($places);

Place Details

Retrieve detailed information about a specific place using its place ID:

$place_id = 'ChIJlYL0Wa-BhYARJi6qr49Ncv1';
$fields = ['displayName', 'id', 'googleMapsUri', 'formattedAddress'];

$place_details = $client->get_place($place_id, $fields);
print_r($place_details);

Text Search

Search for places based on a text query:

$query = 'restaurants in Sydney';
$fields = ['places.id', 'places.displayName'];

$places = $client->search_text($query, $fields);
print_r($places);

Autocomplete

Get place suggestions based on partial user input:

$input = 'Pizza';
$params = [
    'includedPrimaryTypes' => ['mexican_restaurant'],
];
$suggestions = $client->autocomplete($input, $params);
print_r($suggestions);

Methods

`prepare_fields(array|string $fields, bool $clean_prefix = false): string`

Formats and prepares the fields parameter for API requests.

$fields: The fields to be included in the API request. Can be provided as an array or a comma-separated string. Defaults to '*' if empty.
$clean_prefix: Optional. If true, removes the places. prefix from field names. Defaults to false.
Returns: A formatted, comma-separated string of fields.

`near_by_search(string $location, int $radius, array $params = []): array`

Performs a nearby search for places.

$location: A comma-separated string representing the latitude and longitude (e.g., "37.7749,-122.4194").
$radius: The radius (in meters) within which to search for places.
$params: Optional. Additional parameters for the API request.
Returns: An associative array of places.

`get_place(string $place_id, array $fields = []): array`

Retrieves details about a specific place using its place ID.

$place_id: The unique identifier of the place.
$fields: Optional. An array of fields to include in the response.
Returns: An associative array with place details.

`search_text(string $query, array $fields = []): array`

Performs a text-based search for places.

$query: The search query text.
$fields: Optional. An array of fields to include in the response.
Returns: An associative array of places.

`autocomplete(string $input, array $params = []): array`

Provides autocomplete suggestions based on user input.

$input: The partial text input from the user.
$params: Optional. Additional parameters for the API request.
Returns: An array of autocomplete suggestions.

Error Handling

The wrapper throws exceptions when it encounters errors. Ensure you handle exceptions in your implementation:

try {
    $places = $client->near_by_search($location, $radius, $params);
} catch (\Exception $e) {
    // Handle errors
}

mustafakucuk / google-places

Maintainers

Details