Google Map Places

Google Map Places API endpoints

• GET/textsearch

  textsearch

  # Google Places API - Text Search The **Text Search** request in the **Google Places API Web Service** returns information about a set of places based on a string query, such as "pizza in New York" or "shoe stores near Mumbai". ## 🔗 API Endpoint ``` /textsearch ``` --- ## 🧾 Request Parameters | Parameter | Required | Description | |-----------------|----------|-------------| | `query` | ✅ Yes | The text string on which to search (e.g. "restaurants in Paris"). | | `location` | ❌ Optional | Latitude/longitude around which to retrieve results. | | `radius` | ❌ Optional | Distance (in meters) within which to return results. | | `language` | ❌ Optional | Language code (e.g. `en`, `fr`). | | `minprice` / `maxprice` | ❌ Optional | Price level from 0 (most affordable) to 4 (most expensive). | | `opennow` | ❌ Optional | Restrict results to places that are open now. | | `type` | ❌ Optional | Restrict results to places matching a type (e.g. `restaurant`). | | `pagetoken` | ❌ Optional | Token to retrieve the next page of results. | | `region` | ❌ Optional | Region code to influence results (e.g. `us`, `in`). | --- ## ✅ Sample Request ```http textsearch?query=pizza+in+New+York ``` --- ## 📤 Sample Response (Truncated) ```json { "results": [ { "formatted_address": "123 Main St, New York, NY", "geometry": { "location": { "lat": 40.7128, "lng": -74.0060 } }, "name": "Joe's Pizza", "opening_hours": { "open_now": true }, "place_id": "abc123def456", "rating": 4.7, "types": ["restaurant", "food", "point_of_interest", "establishment"] } ], "status": "OK" } ``` --- ## 📄 Response Fields - `results[]`: Array of matching places. - `name`: Name of the place. - `formatted_address`: Address of the place. - `geometry.location`: Latitude and longitude of the place. - `place_id`: Unique identifier. - `rating`: Average u

• GET/nearbysearch

  nearbysearch

  # Google Places API - Nearby Search The **Nearby Search** request in the **Google Places API Web Service** returns a list of places (e.g. restaurants, stores, attractions) based on a user's location. ## 🔗 API Endpoint ``` /nearbysearch ``` --- ## 🧾 Request Parameters | Parameter | Required | Description | |---------------|----------|-------------| | `location` | ✅ Yes | The latitude/longitude around which to retrieve place information. Format: `lat,lng` | | `radius` | ✅ Yes (or `rankby=distance`) | Defines the distance (in meters) within which to return results. | | `rankby` | ❌ Optional | Specifies ranking method. One of: `prominence` (default), `distance`. | | `keyword` | ❌ Optional | A term to match against all content that Google has indexed. | | `language` | ❌ Optional | Language code (e.g. `en`, `fr`). | | `minprice` / `maxprice` | ❌ Optional | Price level from 0 (most affordable) to 4 (most expensive). | | `opennow` | ❌ Optional | Restrict results to places that are open now. | | `type` | ❌ Optional | Restricts results to places matching a type (e.g. `restaurant`, `hospital`). | | `pagetoken` | ❌ Optional | Token for retrieving the next page of results. | > 💡 If you use `rankby=distance`, **you must omit `radius`** and include one or more of the following: `keyword`, `name`, or `type`. --- ## ✅ Sample Request ```http GET /nearbysearch?location=37.7749,-122.4194&radius=1500&type=restaurant ``` --- ## 📤 Sample Response (Truncated) ```json { "results": [ { "geometry": { "location": { "lat": 37.773, "lng": -122.431 } }, "name": "Sample Restaurant", "opening_hours": { "open_now": true }, "place_id": "abcd1234", "rating": 4.5, "types": ["restaurant", "food", "point_of_interest", "establishment"], "vicinity": "123 Main St, San Francisco" } ], "status": "OK" } ``` --- ## 📄 Response Fields - `results[]`: Array of pl

• GET/findplacefromtext

  findplacefromtext

  # Google Places API - Find Place The **Find Place** request in the **Google Places API Web Service** returns a place based on a text input (like name, address, or phone number). ## 🔗 API Endpoint ``` /findplacefromtext ``` --- ## 🧾 Request Parameters | Parameter | Required | Description | |-----------------|----------|-------------| | `input` | ✅ Yes | The text string to search for (e.g. name, address). | | `inputtype` | ✅ Yes | The type of input. Must be one of: `textquery` or `phonenumber`. | | `fields` | ✅ Yes | A comma-separated list of fields to return (e.g. `place_id`, `name`, `geometry`). | | `language` | ❌ Optional | The language code (e.g. `en`, `fr`). | | `locationbias` | ❌ Optional | Bias results to a specified area. Can be one of: `ipbias`, `point:lat,lng`, `circle:radius@lat,lng`, or `rectangle:lat,lng|lat,lng`. | --- ## ✅ Sample Request ```http GET /findplacefromtext?input=Google%20Plex&inputtype=textquery&fields=place_id,name,geometry ``` --- ## 📄 Response Fields - `candidates[]`: An array of matching places. - `name`: Name of the place. - `place_id`: A unique identifier for the place. - `geometry.location`: Latitude and longitude of the place. - `status`: API response status (e.g. `OK`, `ZERO_RESULTS`, `INVALID_REQUEST`). --- ## 📚 Learn More - [Official Docs](https://developers.google.com/maps/documentation/places/web-service/search-find-place) - [Fields List](https://developers.google.com/maps/documentation/places/web-service/fields) ---

• GET/details

  details

  # Google Places API - Place Details The **Place Details** request in the **Google Places API Web Service** returns comprehensive information about a specific place, identified by its `place_id`. ## 🔗 API Endpoint ``` /details ``` --- ## 🧾 Request Parameters | Parameter | Required | Description | |-----------------|----------|-------------| | `place_id` | ✅ Yes | A unique identifier for a place. | | `fields` | ✅ Yes | A comma-separated list of fields to return (see list below). | | `language` | ❌ Optional | The language code (e.g. `en`, `fr`). | | `region` | ❌ Optional | Region code (e.g. `us`, `in`) to bias the results. | > **Tip:** Specifying only the fields you need will improve performance and reduce cost. --- ## 📝 Supported Fields You can request any of the following fields (among others): - `address_component` - `adr_address` - `formatted_address` - `geometry` - `icon` - `name` - `permanently_closed` - `photo` - `place_id` - `plus_code` - `type` - `url` - `utc_offset` - `vicinity` - `opening_hours` - `rating` - `reviews` - `user_ratings_total` - `website` For the full list, see the [Fields documentation](https://developers.google.com/maps/documentation/places/web-service/fields). ---

• GET/placeautocomplete

  placeautocomplete

  # Google Places API - Place Autocomplete The **Place Autocomplete** service in the **Google Places API Web Service** returns place predictions in response to a user's search query. This is ideal for creating search boxes that offer predictive location typing. --- ## 🔗 API Endpoint ``` /placeautocomplete ``` --- ## 🧾 Request Parameters | Parameter | Required | Description | |-------------------|----------|-------------| | `input` | ✅ Yes | The text string on which to search. | | `sessiontoken` | ❌ Recommended | A unique token for tracking user sessions. Improves billing and relevance. | | `types` | ❌ Optional | Restrict results to a specific place type (e.g. `geocode`, `establishment`). | | `location` | ❌ Optional | Bias results toward a location (lat,lng). | | `radius` | ❌ Optional | Distance in meters to bias the results around `location`. | | `components` | ❌ Optional | Restrict results to specific countries using `country:xx`. | | `language` | ❌ Optional | The language code to return results in (e.g. `en`, `fr`). | | `strictbounds` | ❌ Optional | Limits the results strictly within the provided `location` and `radius`. | --- ## 📚 Learn More - [Official Docs](https://developers.google.com/maps/documentation/places/web-service/autocomplete) --- ## 🛑 Note - Use the `place_id` from the response with the **Place Details API** to retrieve complete place data. - Biasing with `location` and `radius` can significantly improve relevance.

• GET/queryautocomplete

  queryautocomplete

  # Google Places API - Query Autocomplete The **Query Autocomplete** service of the **Google Places API Web Service** is used to provide type-ahead search suggestions for text-based geographic queries, such as addresses and business names. This is ideal for search boxes that need to suggest full search queries rather than just place names. --- ## 🔗 API Endpoint ``` /queryautocomplete ``` --- --- ## 🧾 Request Parameters | Parameter | Required | Description | |----------------|----------|-------------| | `input` | ✅ Yes | The user's input text string for the search query. | | `language` | ❌ Optional | The language code (e.g., `en`, `fr`) for the results. | | `location` | ❌ Optional | Coordinates to bias results near a point (`lat,lng`). | | `radius` | ❌ Optional | Radius in meters to bias search results. | | `offset` | ❌ Optional | The character position in `input` up to which predictions are considered. | --- ## ✅ Sample Request ```http GET /queryautocomplete?input=pizza+near+New+York ``` --- ## 🛑 Note - Unlike **Place Autocomplete**, **Query Autocomplete** is optimized for full search phrases. - Use `place_id` from the response to retrieve detailed data via the Place Details API.

• GET/geocode

  geocode

  # Google Maps Geocoding API - Geocoding Requests The **Geocoding API** converts addresses into geographic coordinates (latitude/longitude) and vice versa. It is part of the **Google Maps Platform**. --- ## 🔗 API Endpoint ``` /geocode ``` --- ## 📥 Request Parameters | Parameter | Required | Description | |----------------|----------|-------------| | `address` | ✅ Yes (for forward geocoding) | The address you want to geocode. | | `latlng` | ✅ Yes (for reverse geocoding) | The latitude/longitude value to reverse geocode (e.g., `40.714224,-73.961452`). | | `components` | ❌ Optional | A component filter (e.g., `country:US`). | | `bounds` | ❌ Optional | Bias results within specified viewport (`southwest_lng,southwest_lat|northeast_lng,northeast_lat`). | | `region` | ❌ Optional | Country code (e.g., `us`) to bias results. | | `language` | ❌ Optional | Language code for results (e.g., `en`, `fr`). | | `result_type` | ❌ Optional | Filter results by type (e.g., `street_address`, `postal_code`). | | `location_type`| ❌ Optional | Filter results by location accuracy (e.g., `ROOFTOP`, `APPROXIMATE`). | > **Note:** Either `address` or `latlng` must be specified, not both. --- ## 📌 Forward Geocoding Sample Request ```http GET /geocode?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA ``` ## 📌 Reverse Geocoding Sample Request ```http GET /geocode?latlng=40.714224,-73.961452 ``` --- ## 🛑 Note - The accuracy of geocoding results depends on the level of detail in the input. - Always check `location_type` to verify the quality of geocoding.

• GET/timezone

  timezone

  # Google Maps Time Zone API The **Google Maps Time Zone API** provides time offset data for locations on the Earth's surface. Given a location and timestamp, it returns the time zone's name, UTC offset, and daylight savings offset. --- ## 🔗 API Endpoint ```http GET /timezone?location=39.6034810%2C-119.6822510 &timestamp=1733428634 ``` ## 🧾 Request Parameters | Parameter | Required | Description | |-------------|----------|-------------| | `location` | ✅ Yes | The latitude/longitude (e.g., `39.6034810,-119.6822510`). | | `timestamp` | ✅ Yes | Seconds since midnight, January 1, 1970 UTC (Unix time). | | `language` | ❌ Optional | Returns results in the specified language (e.g., `en`, `fr`). | --- ## 🛑 Note - This API is useful for determining time zone context in mapping apps. - Always pass an accurate `timestamp` to get the correct DST offset. - The Time Zone API does not return local time directly—calculate it using the formula above.