Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar el Google Places API Web Service

Para que puedas comenzar, te proporcionaremos orientación en la consola para desarrolladores de Google a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar el Google Places API Web Service
  3. Crear claves correspondientes
Continuar

Id. de sitio

Los id. de sitio identifican de forma exclusiva un sitio en la base de datos de Google Places y en Google Maps.

  1. Información general
  2. Recuperar detalles del sitio mediante el id. de sitio
  3. Maneja múltiples id. de sitio y ámbitos del id. de sitio
  4. Buscar el id. de un sitio en particular
  5. Guardar los id. de sitio para usarlos más tarde

Buscar el id. de un sitio en particular

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

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

Información general

Un id. de sitio es un identificador textual que identifica de forma exclusiva un sitio. Se parece al siguiente ejemplo (la extensión del identificador puede variar):

ChIJrTLr-GyuEmsRBfy61i59si0

Los id. de sitio están disponibles para la mayoría de las ubicaciones, incluidos negocios, monumentos, parques e intersecciones. Estos id. de sitio son estables, es decir, una vez que has identificado el id. de un sitio, puedes volver a usar ese valor la próxima vez que busques ese lugar.

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

Recuperar detalles del sitio mediante el id. de sitio

El id. de sitio proporciona un medio confiable para hacer referencia a información de un sitio en particular. Una manera común de usar los ID de sitio consiste en buscar un sitio (mediante el Google Places API Web Service o la biblioteca de Places en la Google Maps JavaScript API, por ejemplo) y, a continuación, usar el ID de sitio mostrado para recuperar detalles del sitio. También, puedes almacenar el id. de sitio y usarlo para recuperar los detalles del mismo sitio más tarde.

Maneja múltiples id. de sitio y ámbitos del id. de sitio

Cada ID de sitio puede hacer referencia a un solo sitio, pero un sitio puede tener más de un ID de sitio. El caso más común para manejar varios ID de un sitio es aquel en el cual se agrega un sitio que, inicialmente, se encontraba dentro del ámbito de tu aplicación y luego recibe el ámbito de la totalidad de Google.

Cuando agregas un sitio usando el Places API Web Service, recibes un ID de sitio para el nuevo sitio de inmediato. Este id. de sitio solo se encuentra dentro del ámbito de tu aplicación. Luego, el sitio ingresa a una cola de moderación y espera la aprobación para ser agregado a la base de datos de Google Places. Si se aprueba, el sitio recibirá un nuevo id. de sitio, disponible para todas las aplicaciones y en Google Maps. Consulta la documentación sobre el agregado de sitios para obtener información más detallada.

Existen otras circunstancias que pueden hacer que un sitio reciba un nuevo ID de sitio. Esto, por ejemplo, puede suceder si un negocio se muda a otro lugar.

El siguiente diagrama muestra un escenario posible en el que un sitio tiene más de un id. de sitio:

Cómo recuperar un sitio con múltiples id.

Cuando un sitio tiene varios ID, esto no influye en una solicitud de la Places API. Sin embargo, sí afectará la respuesta.

Cuando solicitas un sitio mediante la especificación de un id. de sitio, puedes estar seguro de que siempre recibirás el mismo sitio en la respuesta (si el sitio aún existe).

Sin embargo, ten en cuenta que la respuesta puede incluir más de un id. de sitio para el sitio solicitado, o bien, es posible que contenga un id. de sitio diferente del incluido en tu solicitud.

  • Comportamiento en el Places API Web Service: Si el sitio tiene varios ID, el Places API Web Service mostrará el ID principal del sitio y un conjunto con todos los ID alternativos de ese sitio. Consulta la documentación sobre los detalles del sitio y la búsqueda de sitios.
  • Comportamiento en la biblioteca de Places para JavaScript y en otras API: Cuando solicitas detalles del sitio para un id. de sitio específico, recibes los detalles del sitio solicitado. Ten en cuenta que el id. de sitio puede ser diferente si dicho sitio ha recibido un id. nuevo desde tu última solicitud. Puedes continuar usando de manera segura el id. de sitio original para acceder al sitio, pero se recomienda que cambies y utilices el id. de sitio devuelto más recientemente siempre que sea posible.

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

Los id. de sitio están exentos de las restricciones de almacenamiento en caché establecidas en la Sección 10.5.d de las Condiciones de servicio de las Google Maps API. Por lo tanto, puedes almacenar valores de id. de sitio de manera indefinida.

Enviar comentarios sobre...