Id. de sitio

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.
Seleccionar plataforma: Android iOS JavaScript Servicio web

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

  • Cómo recuperar una dirección para un ID de lugar en el servicio web de la API de Geocoding y el servicio de geocodificación, la API de Maps JavaScript
  • Especifica el origen, el destino y los puntos de referencia intermedios en el servicio web de la API de Directions y el servicio de Directions, la API de Maps JavaScript.
  • Especifica los orígenes y destinos en el servicio web de la API de Distance Matrix y el servicio de Distance Matrix, la API de Maps JavaScript.
  • Recuperando Place Details, 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 para la API de JavaScript
  • Cómo usar parámetros de ID de lugar en la API de Maps Embed
  • Recuperar consultas de búsqueda en URL de Maps
  • Se muestran los límites de velocidad en la API de Roads.
  • Encontrar y aplicar polígonos de límite en el estilo basado en datos

Buscar el id. de un sitio en particular

¿Buscas el id. de un sitio específico? Utiliza el buscador de id. de sitio a continuación para buscar un sitio 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 sitio es un identificador textual que identifica de forma exclusiva un sitio. La longitud del identificador puede variar (no hay una longitud máxima para los ID de lugar). Ejemplos:

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

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

Puedes usar el mismo ID de lugar en la API de Places y en varias API 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.

Recuperar detalles del sitio mediante el id. de sitio

Los ID de lugar están exentos de las restricciones de almacenamiento en caché establecidas en la Sección 3.2.3(b) de las Condiciones del Servicio de Google Maps Platform. Una vez que hayas identificado el id. de sitio para un sitio, puedes volver a usar ese valor la próxima vez que busques ese lugar. Para obtener más información, consulta Cómo guardar los ID de lugar para usarlos más adelante.

Una forma común de usar los ID de lugar es buscar un lugar (mediante la API de Places o la biblioteca de Places, por ejemplo, en la API de Maps JavaScript) y, luego, usar el ID de lugar mostrado para obtener detalles del lugar. Puedes almacenar el ID de lugar y usarlo para recuperar los mismos detalles del sitio más adelante. Consulta la sección Cómo guardar los ID de lugar que aparece a continuación.

Ejemplo con el SDK de Places para iOS

Un id. de sitio es un identificador textual que identifica de forma exclusiva un sitio. 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 más tarde.

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

  • Una string que contiene un ID de lugar.
  • Uno o más GMSPlaceField, que especifican los tipos de datos que se mostrarán
  • Un token de sesión si se realiza la llamada para finalizar una consulta de autocompletado. De lo contrario, pase el valor nulo.
  • Un GMSPlaceResultCallback para manejar 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]);
  }
}];

Guardar los id. de sitio para usarlos más tarde

Los ID de lugar están exentos de las restricciones de almacenamiento en caché establecidas en la Sección 3.2.3(a) de las Condiciones del Servicio de Google Maps Platform. Por lo tanto, puedes almacenar valores de ID de lugar para usarlos más adelante.

Actualizando ID de sitios almacenados

Te recomendamos que actualices los ID de lugar si tienen más de 12 meses. Puedes actualizar los ID de lugar sin cargo. Para ello, haz una solicitud de Place Details y especifica solamente el campo GMSPlaceFieldPlaceID en el parámetro fields. Esto activará el SKU de Places Details, ID Refresh. Sin embargo, 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 el id. de un sitio deja de ser válido, puedes volver a emitir esa solicitud para obtener resultados actualizados. Estos resultados pueden incluir el lugar original o no. Se cobra la solicitud.

Códigos de error al usar id. de sitio

El código de estado INVALID_REQUEST indica que el ID de lugar especificado no es válido. Se puede mostrar INVALID_REQUEST cuando el ID de lugar se truncó o modificó, y ya no es correcto.

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

En particular, a veces, algunos tipos de id. de sitio pueden causar una respuesta NOT_FOUND o la API puede mostrar un id. de sitio diferente en la respuesta. Estos tipos de id. de sitio incluyen:

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

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

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