IDs de lugar

Selecciona la plataforma: Android iOS JavaScript Servicio web

Los IDs de lugar identifican de forma exclusiva un sitio en la base de datos de Google Places y en Google Maps. Los IDs de lugar se aceptan en las solicitudes a las siguientes APIs de Google Maps:

  • Recuperar una dirección de un ID de lugar en el servicio web de la API de Geocoding y el servicio de Geocoding de la API de Maps JavaScript
  • Especificar el origen, el destino y los puntos de referencia intermedios en el servicio web de la API de Routes y la API Directions, y el servicio Directions de la API de Maps JavaScript
  • Especificar los orígenes y destinos en el servicio web de la API de Routes y la API de Distance Matrix, y el servicio Distance Matrix de la API de Maps JavaScript
  • Recuperar datos de Place Details en el servicio web de la API de Places, el SDK de Places para Android, el SDK de Places para iOS y la biblioteca de Places
  • Utilizar los parámetros de ID de lugar en la API de Maps Embed
  • Recuperar búsquedas en las URLs de Maps
  • Mostrar los límites de velocidad en la API de Roads
  • Encontrar y usar polígonos de límite en el diseño basado en datos aplicable a límites

Cómo buscar el ID de un lugar en particular

¿Buscas el ID de lugar de un sitio específico? Usa el siguiente buscador de ID de lugar para buscar un lugar y obtener su ID:

También puedes ver el buscador de ID de lugar con su código en la documentación de la API de Maps JavaScript.

Descripción general

Un ID de lugar es un identificador textual que identifica de forma exclusiva un lugar. La longitud del identificador puede variar (no hay una longitud máxima para los IDs de lugar). Ejemplos:

  • ChIJgUbEo8cfqokR5lP9_Wh_DaM
  • GhIJQWDl0CIeQUARxks3icF8U8A
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
  • IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ

Los IDs de lugar están disponibles para la mayoría de las ubicaciones, incluidos negocios, puntos de referencia, intersecciones y parques. Es posible que un mismo lugar o ubicación tenga varios IDs de lugar diferentes. Los IDs de lugar pueden cambiar con el paso del tiempo.

Puedes usar el mismo ID de lugar en la API de Places y en varias APIs de Google Maps Platform. Por ejemplo, puedes usar el mismo ID de lugar para hacer referencia a un lugar en la API de Places, la API de Maps JavaScript, la API de Geocoding, la API de Maps Embed y la API de Roads.

Cómo recuperar detalles de un lugar con un ID de lugar

Una forma común de usar los IDs de lugar es buscar un lugar (por ejemplo, mediante la API de Places o la biblioteca de Places de la API de Maps JavaScript) y, luego, usar el ID de lugar que se muestra para obtener detalles. También, puedes almacenar el ID de lugar y usarlo para recuperar los detalles del mismo lugar en otro momento. Consulta la sección Cómo guardar los IDs de lugar a continuación.

Ejemplo de uso del SDK de Places para Android

En el SDK de Places para Android, puedes recuperar el ID de un lugar llamando a Place.getId(). El servicio Place Autocomplete también muestra un ID de lugar para cada lugar que coincide con el filtro y la búsqueda proporcionados. Usa el ID de lugar para volver a recuperar el objeto Place más tarde.

Para obtener un lugar por ID, llama a PlacesClient.fetchPlace() y pasa un FetchPlaceRequest.

La API muestra un FetchPlaceResponse en un Task. El objeto FetchPlaceResponse contiene un objeto Place que coincide con el ID de lugar proporcionado.

En el siguiente ejemplo de código, se muestra cómo llamar a fetchPlace() para obtener detalles del lugar especificado.

Kotlin



// Define a Place ID.
val placeId = "INSERT_PLACE_ID_HERE"

// Specify the fields to return.
val placeFields = listOf(Place.Field.ID, Place.Field.NAME)

// 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
        Log.i(PlaceDetailsActivity.TAG, "Place found: ${place.name}")
    }.addOnFailureListener { exception: Exception ->
        if (exception is ApiException) {
            Log.e(TAG, "Place not found: ${exception.message}")
            val statusCode = exception.statusCode
            TODO("Handle error with given status code")
        }
    }

      

Java


// Define a Place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

// 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();
    Log.i(TAG, "Place found: " + place.getName());
}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
        final ApiException apiException = (ApiException) exception;
        Log.e(TAG, "Place not found: " + exception.getMessage());
        final int statusCode = apiException.getStatusCode();
        // TODO: Handle error with given status code.
    }
});

      

Cómo guardar los IDs de lugar para usarlos en otro momento

Los IDs de lugar están exentos de las restricciones de almacenamiento en caché establecidas en el Artículo 3.2.3(b) de las Condiciones del Servicio de Google Maps Platform. Por lo tanto, puedes almacenar valores de ID de lugar para usarlos en otro momento.

Cómo actualizar los IDs de lugar almacenados

Te recomendamos que actualices los IDs de lugar si tienen más de 12 meses de antigüedad. Puedes hacerlo sin cargo. Para ello, realiza una solicitud de Place Details y especifica solo el campo Place.Field.ID en el parámetro fields. Esta llamada activa el SKU de Places Details - ID Refresh.

Esta solicitud también puede mostrar el código de estado NOT_FOUND. Una estrategia es almacenar la solicitud original que mostró cada ID de lugar. Si un ID de lugar deja de ser válido, puedes volver a emitir esa solicitud para obtener resultados actualizados. Estos resultados pueden incluir el lugar original o no. Sin embargo, esta solicitud es cobrable.

Códigos de error al usar IDs de lugar

El código de estado INVALID_REQUEST indica que el ID de lugar especificado no es válido. Es posible que aparezca INVALID_REQUEST si el ID de lugar se truncó o modificó de alguna manera y ya no es correcto.

El código de estado NOT_FOUND indica que el ID de lugar especificado está obsoleto. Un ID de lugar puede quedar obsoleto si una empresa cierra o se traslada a otra ubicación. Los IDs de lugar pueden cambiar debido a actualizaciones a gran escala en la base de datos de Google Maps. En esos casos, un lugar puede recibir un ID nuevo, y el ID anterior mostrará una respuesta NOT_FOUND.

A veces, algunos tipos de IDs de lugar pueden causar una respuesta NOT_FOUND, o la API puede mostrar un ID de lugar diferente en la respuesta. Entre estos tipos de IDs de lugar se incluyen los siguientes:

  • Direcciones que no existen en Google Maps como direcciones exactas, pero que se infieren a partir de un rango de direcciones
  • Segmentos de una ruta extensa, cuando la solicitud también especifica una ciudad o localidad
  • Intersecciones
  • Lugares con un componente de dirección del tipo subpremise

Estos IDs suelen tomar la forma de una cadena larga (no hay una longitud máxima para los IDs de lugar). Por ejemplo:

EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4