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 iOS

Un ID de lugar es un identificador textual que identifica de forma exclusiva un lugar. En el SDK de Places para iOS, puedes recuperar el ID de un lugar desde un objeto GMSPlace. Puedes almacenar el ID de lugar y usarlo para recuperar el objeto GMSPlace nuevamente más tarde.

Para obtener un lugar por ID, llama a GMSPlacesClient fetchPlaceFromPlaceID: y pasa los siguientes parámetros:

  • Es una cadena que contiene un ID de lugar.
  • Uno o más objetos GMSPlaceField que especifican los tipos de datos que se mostrarán.
  • Un token de sesión si se realiza la llamada para concluir una consulta de autocompletado De lo contrario, pasa nil.
  • Un GMSPlaceResultCallback para controlar el resultado.

La API invoca el método de devolución de llamada especificado y pasa un objeto GMSPlace. Si no se encuentra el sitio, el objeto de sitio es nil.

Swift

// A hotel in Saigon with an attribution.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) |
  UInt(GMSPlaceField.placeID.rawValue))!

placesClient?.fetchPlace(fromPlaceID: placeID, placeFields: fields, sessionToken: nil, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    self.lblName?.text = place.name
    print("The selected place is: \(place.name)")
  }
})

Objective‑C

// A hotel in Saigon with an attribution.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return.
GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID);

[_placesClient fetchPlaceFromPlaceID:placeID placeFields:fields sessionToken:nil callback:^(GMSPlace * _Nullable place, NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"An error occurred %@", [error localizedDescription]);
    return;
  }
  if (place != nil) {
    NSLog(@"The selected place is: %@", [place name]);
  }
}];

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 GMSPlaceFieldPlaceID 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