This is a PHP wrapper for Google Places API Web Service. And is Laravel Framework friendly.
About Package
With just 2 lines of code you can request to any google places api feature. No need to manually perform any curl requests.
The following place requests are available:
Place Search This service gives a list of places based on a user's location or search string.
Place Details This service gives more detailed information about a specific Place, including user reviews.
Place Autocomplete This service is Used to automatically fill in the name and/or address of a place as you type.
Query Autocomplete This service is Used to provide a query prediction service for text-based geographic searches, by returning suggested queries as you type.
Place Photo This gives you access to the millions of photos stored in the Google's Places database
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 if rankby=distance (described under Optional parameters below) is specified.
If rankby=distance (described under Optional parameters below) is specified, then one or more of keyword, name, or types is required.
params - Optional Parameters You can refer all the available optional parameters on the Google's Official Webpage
textSearch($query, $params = [])
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
findPlace($input, $inputType, $params = [])
input — The text input specifying which place to search for (for example, a name, address, or phone number).
inputType — The type of input. This can be one of either textquery or phonenumber. Phone numbers must be in international format (prefixed by a plus sign ("+"), followed by the country code, then the phone number itself).
params - Optional Parameters You can refer all the available optional parameters on the Google's Official Webpage
Place Details
placeDetails($placeId, $params = [])
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
Place Autocomplete
placeAutocomplete($input, $params = [])
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
Query Autocomplete
queryAutocomplete($input, $params = [])
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
To have custom headers set for every call, you can pass 3rd parameter as the headers to class constructor.
Note: For Laravel Users, you can set this in config file with key headers
Additional Methods
getStatus()
This will return the status of the response send by google api. Use it after making any request.
getKey()
This will return the API KEY been used with the requests.
setKey($key)
This will set the API KEY.
verifySSL($verifySSL = true)
You can pass false to disable Verification of SSL Certification.
Note: For Laravel Users, you can set this in config file with key verify_ssl
Or You can Pass the path to the certificate.
Exceptions
Google Places API may throw various exceptions based on the given $params or response and is located in the SKAgarwal\GoogleApi\Exceptions namespace.
A GooglePlacesApiException is thrown when no API KEY is provided or $params is invalid.
Note: This is the parent class for the preceding exceptions.
A InvalidRequestException is thrown when the response status is INVALID_REQUEST
A OverQueryLimitException is thrown when the response status is OVER_QUERY_LIMIT
A RequestDeniedException is thrown when the response status is REQUEST_DENIED
A UnknownErrorException is thrown when the response status is UNKNOWN_ERROR
A NotImplementedException is thrown when the response cannot be determined.
If any of these exception has been thrown, you can use the getErrorMessage() method to get the error_message field from the response if any is provided.
Note:error_message field is not guaranteed to be always present, and its content is subject to change.
Contribution
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.
License
The Google Places Api is open-sourced software licensed under the MIT license
请发表评论