A Laravel/Lumen package for working with Google API Web Services.
- Place Search return a list of places based on a user's location or search string.
- Place Details requests return more detailed information about a specific Place, including user reviews.
- Place Autocomplete can be used to automatically fill in the name and/or address of a place as you type.
- Query Autocomplete can be used to provide a query prediction service for text-based geographic searches, by returning suggested queries as you type.
- Place Add can be used to add a place to Google's Place database
Install it with composer
composer require mrjonleek/laravel-google-api
Set up the service provider and facade in the config\app.php
'providers' => [
....
....
Mrjonleek\GoogleApi\Providers\PlacesServiceProvider::class,
];
'aliases' => [
....
....
'GooglePlaces' => Mrjonleek\GoogleApi\Facades\Places::class,
];
publish the config file with following artisan command
php artisan vendor:publish --provider="Mrjonleek\GoogleApi\Providers\PlacesServiceProvider"
This will create google.php file in the config directory.
Set the API KEY in this config file or in .env
as GOOGLE_API_KEY.
Start using the package using Facade.
$response = GooglePlaces::placeAutocomplete('some city');
The response returned is a Laravel's Collection so that you can perform any of the available collection methods on it.
location
— The latitude/longitude around which to retrieve place information. This must be specified as latitude, longitude.- 'radius' — Defines the distance (in meters) within which to return place results. The maximum allowed radius is 50 000 meters. Note that
radius
must not be included ifrankby=distance
(described under Optional parameters below) is specified. - If
rankby=distance
(described under Optional parameters below) is specified, then one or more ofkeyword
,name
, ortypes
is required. params
- Optional Parameters You can refer all the available optional parameters on the Google's Official Webpage
query
— The text string on which to search, for example: "restaurant". The Google Places service will return candidate matches based on this string and order the results based on their perceived relevance.params
- Optional Parameters You can refer all the available optional parameters on the Google's Official Webpage
location
— The latitude/longitude around which to retrieve place information. This must be specified as latitude, longitude.radius
— Defines the distance (in meters) within which to return place results. The maximum allowed radius is 50 000 meters.params
- Optional Parameters You can refer all the available optional parameters on the Google's Official Webpage
Note: A Radar Search request must include at least one of keyword
, name
, or types
.
placeId
— A textual identifier that uniquely identifies a place, returned from a Place Search.params
- Optional Parameters You can refer all the available optional parameters on the Google's Official Webpage
input
— The text string on which to search. The Place Autocomplete service will return candidate matches based on this string and order results based on their perceived relevance.params
- Optional Parameters You can refer all the available optional parameters on the Google's Official Webpage
input
— The text string on which to search. The Places service will return candidate matches based on this string and order results based on their perceived relevance.params
- Optional Parameters You can refer all the available optional parameters on the Google's Official Webpage
params
- The set of key-value parameters necessary to add a place to Google. You can refer to the fields on Google's Official Webpage regarding Place Add
This will return the status of the response send by google api. Use it after making any request.
This will return the API KEY
been used with the requests.
This will set the API KEY
.
Feel free to report issues or make Pull Requests. If you find this document can be improved in any way, please feel free to open an issue for it.
The Google Places Api is open-sourced software licensed under the MIT license