You're all set!

To start developing, please head over to our developer documentation.

Activate the Google Places API Web Service

To get you started we'll guide you through the Google Developers Console to do a few things first:

  1. Create or choose a project
  2. Activate the Google Places API Web Service
  3. Create appropriate keys
Continue

Place IDs

Place IDs uniquely identify a place in the Google Places database and on Google Maps.

  1. Overview
  2. Retrieve place details using the place ID
  3. Handle multiple place IDs and place ID scoping
  4. Find the ID of a particular place
  5. Save place IDs for later use

Find the ID of a particular place

Are you looking for the place ID of a specific place? Use the place ID finder below to search for a place and get its ID:

Alternatively, you can view the place ID finder with its code in the Google Maps JavaScript API documentation.

Overview

A place ID is a textual identifier that uniquely identifies a place. It looks similar to the following example (the length of the identifier may vary):

ChIJrTLr-GyuEmsRBfy61i59si0

Place IDs are available for most locations, including businesses, landmarks, parks, and intersections. These IDs are stable, meaning that once you've identified the place ID for a place, you can reuse that value when you next look up that place.

You can use the same place ID across the Google Places API and a number of Google Maps APIs. For example, you can use the same place ID to reference a place in the Places API, the Google Maps JavaScript API, the Google Maps Geocoding API, the Google Maps Embed API and the Google Maps Roads API.

Retrieve place details using the place ID

The place ID provides a reliable means of referencing information for a particular place. A common way of using place IDs is to search for a place (using the Google Places API Web Service or the Places library in the Google Maps JavaScript API, for example) then use the returned place ID to retrieve place details. You can also store the place ID and use it to retrieve the same place details later.

Example using the Places API Web Service

Using the Google Places API Web Service, you can find a place ID by doing a Place Search request.

The following example is a search request for places of type 'restaurant' within a 500m radius of a point in Sydney, Australia, containing the word 'cruise' in their name:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=500&type=restaurant&name=cruise&key=YOUR_API_KEY

The response includes a place ID in the place_id field, as shown in this snippet:

{
  "html_attributions" : [],
  "results" : [
    {
      "geometry" : {
        "location" : {
          "lat" : -33.870775,
          "lng" : 151.199025
        }
      },
      ...
      "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
      ...
    }
  ],
  "status" : "OK"
}

For a description of all the fields in the response, see the Place Search documentation.

Now you can send a Place Details request, putting the place ID in the placeid parameter:

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJrTLr-GyuEmsRBfy61i59si0&key=YOUR_API_KEY

Handle multiple place IDs and place ID scoping

Each place ID can refer to only one place, but a single place can have more than one place ID. The most common case for handling multiple IDs for a place is when you've added a place that's initially scoped to your application, and then receives a Google-wide scope.

When you add a place using the Places API Web Service, you receive a place ID for the new place immediately. This place ID is scoped for your application only. The place then enters a moderation queue, awaiting approval for addition to the Google Places database. If approved, the place will receive a new place ID, available to all applications and on Google Maps. See the documentation on adding a place for more details.

There are other circumstances which may cause a place to get a new place ID. For example, this may happen if a business moves to a new location.

The following diagram shows one possible scenario where a place has more than one place ID:

Retrieving a place with multiple IDs

When a place has multiple IDs, it will have no impact on a Places API request. However, it will affect the response.

When you request a place by specifying a place ID, you can be confident that you will always receive the same place in the response (if the place still exists).

Note, however, that the response may contain more than one place ID for the requested place, or it may contain a place ID that is different from the one in your request.

  • Behavior in the Places API Web Service: If the place has multiple IDs, the Places API Web Service will return the primary ID for the place, and an array containing all the alternative IDs for that place. See the documentation on place details and place search.
  • Behavior in the Places JavaScript library and other APIs: When you request place details for a specific place ID, you receive the details for the requested place. Note however that the place ID may be different, if the place has received a new ID since your previous request. You can safely continue to use the original place ID to access the place, but it's recommended that you swap to using the most recently-returned place ID whenever possible.

Save place IDs for later use

Place IDs are exempt from the caching restrictions stated in Section 10.5.d of the Google Maps APIs Terms of Service. You can therefore store place ID values indefinitely.

Send feedback about...

location_on
Google Places API Web Service