IDs de lugar

Seleccionar 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 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 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 de la API de JavaScript
  • 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 aplicar polígonos de límite en el estilo basado en datos

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 mediante el ID de lugar

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. Una vez que hayas identificado el ID de un lugar, puedes volver a usar ese valor la próxima vez que lo busques. Para obtener más información, consulta la sección Cómo guardar los IDs de lugar para usarlos en otro momento a continuación.

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 con la biblioteca de Places de la API de Maps JavaScript

Para usar un ID de lugar en tu app de JavaScript, primero debes encontrar el ID, que está disponible en el PlaceResult que muestra una consulta de Place Search, o bien getPlace() en el servicio Place Autocomplete. Luego, puedes usar el ID de lugar para buscar los detalles del lugar.

var map;

function initialize() {
  // Create a map centered in Pyrmont, Sydney (Australia).
  map = new google.maps.Map(document.getElementById('map'), {
    center: {lat: -33.8666, lng: 151.1958},
    zoom: 15
  });

  // Search for Google's office in Australia.
  var request = {
    location: map.getCenter(),
    radius: '500',
    query: 'Google Sydney'
  };

  var service = new google.maps.places.PlacesService(map);
  service.textSearch(request, callback);
}

// Checks that the PlacesServiceStatus is OK, and adds a marker
// using the place ID and location from the PlacesService.
function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    var marker = new google.maps.Marker({
      map: map,
      place: {
        placeId: results[0].place_id,
        location: results[0].geometry.location
      }
    });
  }
}

google.maps.event.addDomListener(window, 'load', initialize);

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(a) 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_id en el parámetro fields. Esta llamada 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 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. 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