Descripción general

Selecciona la plataforma: Android iOS JavaScript Servicio web
La API de Places es un servicio que acepta solicitudes HTTP para datos de ubicación mediante diversos métodos. Muestra datos de ubicación con formato e imágenes sobre establecimientos, ubicaciones geográficas o lugares de interés destacados.

Por qué usar la API de Places

Crea funciones de reconocimiento de la ubicación para que los datos de ubicación detallados estén fácilmente disponibles para los usuarios. Los datos disponibles a través de la API de Places se basan en uno de los modelos de lugares más precisos, actualizados y completos del mundo real. Estos son ejemplos de casos de uso de aplicaciones:

  • Muestra los alquileres de condominios en áreas metropolitanas principales con resultados orientados específicamente a ciudades.
  • Incluye los detalles del lugar en una actualización del estado de retiro o entrega.
  • Muestra una lista de parques en un área junto con fotos y opiniones enviadas por los usuarios.
  • Proporciona a las personas que planifican viajes información de contacto, opiniones y niveles de precios para los establecimientos en el camino.

¿Qué puedes hacer con la API de Places?

Puedes usar la API de Places para incluir las siguientes funciones en tus aplicaciones:

  • Proporciona resultados de la búsqueda de lugares de diferentes tipos de consultas de usuarios, como entradas de texto, ubicaciones cercanas y consultas de usuarios ambiguas o categóricas.
  • Habilita las funciones de autocompletar para diferentes tipos de búsqueda, ya sean búsquedas de texto específicas o búsquedas categóricas.
  • Define mejor el tipo de detalles que se muestran sobre un lugar, como el horario de atención, un resumen, las opiniones de los usuarios y una foto.
  • Agrega fotos de alta calidad a las ubicaciones en las que funciona tu aplicación.

Muchas APIs de Google Maps Platform admiten IDs de lugar, en los que estos identifican de forma exclusiva un lugar en la base de datos de Google Places y en Google Maps. Existen muchas formas de obtener un ID de lugar, como la API de Places y también la API de Geocoding, la API de Routes y la API de Address Validation.

Una vez que tengas un ID de lugar, puedes usar la API de Places para solicitar más detalles sobre un establecimiento o lugar de interés en particular, como su dirección completa, el número de teléfono, la calificación de los usuarios y las opiniones.

Elige tu versión de la API de Places

La API de Places admite dos versiones de la API: la API de Places son las APIs existentes y la API de Places (nueva) son las versiones de nueva generación de las APIs.

Con el lanzamiento de la API de Places (nueva), tu primera tarea es decidir qué conjunto de APIs usar. Esto es así si eres un cliente nuevo o un cliente existente que ya usa las APIs. Usa esta guía para conocer las diferencias clave entre las dos APIs.

Cómo funciona la API de Places

API de Places (nuevo)

La API de Places (nuevo) acepta solicitudes como una URL estándar con un extremo de servicio específico, como /places o places:searchText, y muestra una respuesta JSON. La API de Places (nuevo) admite la autorización mediante la clave de API y el token de OAuth. En el siguiente ejemplo, se realiza una solicitud a Place Details para mostrar los componentes de dirección de un ID de lugar usando una clave de API:

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

API de Places

La API de Places acepta solicitudes como una URL estándar con un extremo de servicio específico, como /place o /photo. Los extremos también aceptan el tipo de formato especificado en la solicitud, ya sea JSON o XML. La solicitud de servicio usa parámetros relevantes para ese extremo específico a fin de definir mejor los datos que se muestran. En el siguiente ejemplo, se realiza una solicitud a Place Details para mostrar los componentes de dirección de un ID de lugar en formato JSON:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&fields=address_components&key=YOUR_API_KEY

En esta instancia, el servicio usa el ID de lugar proporcionado para encontrar el lugar solicitado y mostrar los componentes de la dirección en formato JSON.

Recursos

En la siguiente tabla, se resumen los recursos disponibles a través de la API de Places.

API de Places API de Places (nuevo) Nota
Find Place Text Search (nuevo) No hay una versión nueva de Find Place. Text Search (nuevo) la reemplazó.
Búsqueda de Nearby Nearby Search (nuevo) Todas las solicitudes que usan la API existente y que incluyen una consulta de texto deben usar Text Search (nuevo) porque Nearby Search (nuevo) no admite entradas de texto.
Búsqueda de texto Text Search (nuevo)
Place Details Place Details (nuevo)
Foto del lugar Place Photos (nuevo)
Place Autocomplete Autocompletar (nuevo) En vista previa
Autocompletar consultas Autocompletar (nuevo) Se agregaron funciones a la versión preliminar de Autocomplete (nuevo)

Cómo usar la API de Places

En los siguientes pasos, se aborda un caso de uso típico para utilizar el servicio de la API de Places. A medida que compilas tu solución, puedes usar extremos adicionales, como Nearby Search y Place Photos.
1 Iniciar configuración Comienza con Configura tu proyecto de Google Cloud, completa las instrucciones de configuración que siguen y, luego, obtén información sobre cómo usar tu clave de API. En el caso de la API de Places (nuevo), también puedes usar tokens OAuth.
2 Prueba una búsqueda de texto básica Realiza una búsqueda de texto simple con Text Search (nuevo) o Text Search.
3 Cómo usar el ID de lugar para obtener más detalles Muchas APIs de Google Maps Platform muestran un ID de lugar como parte de una respuesta. Utiliza el ID de lugar para obtener detalles sobre un lugar. Consulta Place Details (nuevo) y Place Details.
4 Cómo obtener una foto de un lugar El servicio de Place Photos te brinda acceso a las millones de fotos almacenadas en la base de datos de Places. Usa Place Photos (nuevo) o Place Details para acceder a las fotos de un lugar.