Select platform: [Android](https://developers.google.com/maps/documentation/places/android-sdk/place-id.md.txt "View this page for the Android platform docs.") [iOS](https://developers.google.com/maps/documentation/places/ios-sdk/place-id.md.txt "View this page for the iOS platform docs.") [JavaScript](https://developers.google.com/maps/documentation/javascript/place-id.md.txt "View this page for the JavaScript platform docs.") [Web Service](https://developers.google.com/maps/documentation/places/web-service/place-id.md.txt "View this page for the Web Service platform docs.") **European Economic Area (EEA) developers** > [!NOTE] > If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](https://developers.google.com/maps/comms/eea/faq.md.txt). ## Introduction Place IDs uniquely identify a place in the Google Places database and on Google Maps. Place IDs are accepted in requests to the following Maps APIs: - Retrieving an address for a Place ID in the Geocoding API and Geocoding Service, Maps JavaScript API. - Specifying origin, destination and intermediate waypoints in the Routes API and Directions API (Legacy) and Directions Service, Maps JavaScript API (Legacy). - Specifying origins and destinations in the Routes API and Distance Matrix API (Legacy) and Distance Matrix Service, Maps JavaScript API (Legacy). - Retrieving Place Details in Places API (New), Places SDK for Android (New), Places SDK for iOS (New), and Places Library. - Using Place ID parameters in Maps Embed API. - Retrieving search queries in Maps URLs. - Displaying speed limits in Roads API. - Finding and styling boundary polygons in data-driven styling for boundaries. ## 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](https://developers.google.com/maps/documentation/javascript/examples/places-placeid-finder) with its code in the Maps JavaScript API documentation. ### Find place IDs from code or an AI agent The place ID finder looks up one place at a time in a browser. To look up place IDs from an app, a script, or an AI agent, call an API instead: - **From your code:** Send a [Text Search (New)](https://developers.google.com/maps/documentation/places/android-sdk/text-search.md.txt) request with the field list set to [`Place.Field.ID`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place.Field.md.txt#ID). Requests that return only place IDs are billed under the [Places API Text Search Essentials (IDs Only)](https://developers.google.com/maps/billing-and-pricing/sku-details/places#places_text-search-id-only-ess-sku) SKU. - **From an AI agent or LLM app:** Use the [Resolution API](https://developers.google.com/maps/ai/maps-experience-agent-tools/resolution-api.md.txt) in [Maps Experience agent tools](https://developers.google.com/maps/ai/maps-experience-agent-tools.md.txt). The [`resolve_names`](https://developers.google.com/maps/ai/maps-experience-agent-tools/reference/mcp/resolve_names.md.txt) and [`resolve_maps_urls`](https://developers.google.com/maps/ai/maps-experience-agent-tools/reference/mcp/resolve_maps_urls.md.txt) MCP tools resolve up to 20 place names, addresses, or Google Maps URLs to place IDs in each request. The same methods are available as the [`resolveNames`](https://developers.google.com/maps/ai/maps-experience-agent-tools/reference/rest/v1/TopLevel/resolveNames.md.txt) and [`resolveMapsUrls`](https://developers.google.com/maps/ai/maps-experience-agent-tools/reference/rest/v1/TopLevel/resolveMapsUrls.md.txt) REST methods. ## Overview A place ID is a textual identifier that uniquely identifies a place. The length of the identifier may vary (there is no maximum length for place IDs). Examples: - ` ChIJgUbEo8cfqokR5lP9_Wh_DaM ` - ` GhIJQWDl0CIeQUARxks3icF8U8A ` - ` EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN ` - ` EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E ` - ` IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ ` Place IDs are available for most locations, including businesses, landmarks, parks, and intersections. It is possible for the same place or location to have multiple different place IDs. Place IDs may change over time. You can use the same place ID across the Places API and a number of Google Maps Platform APIs. For example, you can use the same place ID to reference a place in the [Places API](https://developers.google.com/maps/documentation/places), the [Maps JavaScript API](https://developers.google.com/maps/documentation/javascript/places), the [Geocoding API](https://developers.google.com/maps/documentation/geocoding), the [Maps Embed API](https://developers.google.com/maps/documentation/embed) and the [Roads API](https://developers.google.com/maps/documentation/roads/speed-limits.md.txt). ## Retrieve place details using the place ID A common way of using place IDs is to search for a place by using the [Places API](https://developers.google.com/maps/documentation/places/web-service) or the [Places library](https://developers.google.com/maps/documentation/javascript/places#place_searches) in the Maps JavaScript API. Then, use the returned place ID to retrieve place details. You can store the place ID and use it to retrieve the same place details later. Read about [saving place IDs](https://developers.google.com/maps/documentation/places/android-sdk/place-id.md.txt#save-id) later in this document. ### Example using the Places SDK for Android (New) In the Places SDK for Android (New), you can retrieve the ID of a place by calling [`Place.getId()`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place.md.txt#getId()). The [Place Autocomplete (Legacy)](https://developers.google.com/maps/documentation/places/android-sdk/place-autocomplete.md.txt) service also returns a place ID for each place that matches the supplied search query and filter. Use the place ID to retrieve the [`Place`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place.md.txt) object again later. To get a place by ID, call [`PlacesClient.fetchPlace()`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/net/PlacesClient.md.txt#fetchPlace(com.google.android.libraries.places.api.net.FetchPlaceRequest)), passing a [`FetchPlaceRequest`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/net/FetchPlaceRequest.md.txt). The API returns a [`FetchPlaceResponse`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/net/FetchPlaceResponse.md.txt) in a [`Task`](https://developers.google.com/android/reference/com/google/android/gms/tasks/Task.md.txt). The [`FetchPlaceResponse`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/net/FetchPlaceResponse.md.txt) contains a [`Place`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place.md.txt) object matching the supplied place ID. The following code example shows calling `fetchPlace()` to get details for the specified place. ### Kotlin ```kotlin // Define a Place ID. val placeId = PlaceIdProvider.getRandomPlaceId() // Specify the fields to return. val placeFields = listOf( Place.Field.ID, Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS, Place.Field.LOCATION, ) // Construct a request object, passing the place ID and fields array. val request = FetchPlaceRequest.newInstance(placeId, placeFields) placesClient.fetchPlace(request) .addOnSuccessListener { response: FetchPlaceResponse -> val place = response.place val name = place.displayName val address = place.formattedAddress val location = place.location binding.placeName.text = name binding.placeAddress.text = address if (location != null) { binding.placeLocation.text = getString( R.string.place_location, location.latitude, location.longitude, ) } else { binding.placeLocation.text = null } Log.i(TAG, "Place found: ${place.displayName}") }.addOnFailureListener { exception: Exception -> if (exception is ApiException) { val message = getString(R.string.place_not_found, exception.message) binding.placeName.text = message Log.e(TAG, "Place not found: ${exception.message}") val statusCode = exception.statusCode TODO("Handle error with given status code") } } ``` ### Java ```java // Define a Place ID. final String placeId = PlaceIdProvider.getRandomPlaceId(); // Specify the fields to return. final List placeFields = Arrays.asList( Place.Field.ID, Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS, Place.Field.LOCATION); // Construct a request object, passing the place ID and fields array. final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields); placesClient .fetchPlace(request) .addOnSuccessListener( (response) -> { Place place = response.getPlace(); final CharSequence name = place.getDisplayName(); final CharSequence address = place.getFormattedAddress(); final LatLng location = place.getLocation(); binding.placeName.setText(name); binding.placeAddress.setText(address); if (location != null) { binding.placeLocation.setText( getString( R.string.place_location, location.latitude, location.longitude)); } else { binding.placeLocation.setText(null); } Log.i(TAG, "Place found: " + place.getDisplayName()); }) .addOnFailureListener( (exception) -> { if (exception instanceof ApiException apiException) { final String message = getString( R.string.place_not_found, apiException.getMessage()); binding.placeName.setText(message); Log.e(TAG, "Place not found: " + exception.getMessage()); final int statusCode = apiException.getStatusCode(); // TODO: Handle error with given status code. } }); ``` ## Save place IDs for later use Place IDs are **exempt from** the caching restrictions stated in [Section 3.2.3(b)](https://cloud.google.com/maps-platform/terms#3.-license.) of the Google Maps Platform Terms of Service. You can therefore store place ID values for later use. ### Refresh stored place IDs Because Place IDs may change due to updates on the Google Maps database, Google recommends refreshing place IDs if they are more than 12 months old. You can refresh Place IDs **at no charge** by making a [Place Details request](https://developers.google.com/maps/documentation/places/android-sdk/details-place.md.txt#place-details-request), specifying only the `Place.Field.ID` field in the `fields` parameter. This call triggers the [Places Details - ID Refresh](https://developers.google.com/maps/billing-and-pricing/sku-details/legacy.md.txt#place-details-id-refresh-legacy-ess-sku) SKU. ## Error codes when using place IDs ### `INVALID_REQUEST` The `INVALID_REQUEST` status code indicates that the specified place ID is not valid. `INVALID_REQUEST` may be returned when the place ID has been truncated or otherwise modified, and is no longer correct. ### `NOT_FOUND` The `NOT_FOUND` status code indicates that the specified place ID is obsolete. A place ID may become obsolete if a business closes or moves to a new location. Place IDs may also change due to updates on the Google Maps database. In such cases, a place may receive a new place ID, and the old ID returns a `NOT_FOUND` response. > [!NOTE] > **Note:** Place IDs that are obsolete may continue to be returned in Place Autocomplete (Legacy), Query Autocomplete (Legacy), or Autocomplete (New) responses for a few days after the place ID has been removed from the Google Maps database. To refresh results in the event of an obsolete place ID, store the original request that returned each place ID and re-issue the request as needed. Note that the **re-issued request is billed at the appropriate SKU.** Some types of place IDs may sometimes cause a `NOT_FOUND` response, or the API may return a different place ID in the response. These place ID types include: - Street addresses that don't exist in Google Maps as precise addresses, but are inferred from a range of addresses. - Segments of a long route, where the request also specifies a city or locality. - Intersections. - Places with an address component of type `subpremise`. These IDs often take the form of a long string (there is no maximum length for Place IDs). For example: ``` EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4 ```