Descripción general

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

Por qué usar la API de Places

Crea funciones de reconocimiento de la ubicación para que los usuarios puedan acceder fácilmente a los datos de ubicación detallados. Los datos disponibles a través de la API de Places se basan en una de las plataformas más precisas, actualizadas y modelos de ubicación exhaustivos del mundo real. Estos son ejemplos de casos de uso para las aplicaciones:

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

¿Qué puedes hacer con la API de Places?

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

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

Muchas APIs de Google Maps Platform son compatibles ID de lugar, en los que se usa el ID de lugar identifica un sitio en la base de datos de Google Places y en Google Maps. Hay muchas maneras de obtener un ID de lugar, incluso desde la API de Places, pero también desde 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 determinado, como su dirección completa, número de teléfono, calificaciones de los usuarios y opiniones.

Elige tu versión de la API de Places

La API de Places admite dos versiones de API: La API de Places son las las APIs existentes y la API de Places (Nuevas) 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 que debes usar. Esto se aplica a los clientes nuevos y el cliente ya usa las APIs. Usa esta guía para conocer la clave entre las dos APIs.

Cómo funciona la API de Places

API de Places (nuevo)

La API de Places (nueva) acepta solicitudes como una URL estándar con una dirección extremo del servicio, como /places o places:searchText y muestra una respuesta JSON. La API de Places (nueva) admite la autorización de Clave de API y token de OAuth. En el siguiente ejemplo, se realiza una solicitud a Place Details para devolver los componentes de la dirección de un ID de lugar con 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 una dirección extremo del servicio, como /place o /photo. Los extremos también Aceptar el tipo de formato especificado en la solicitud, ya sea JSON o XML. El servicio usa parámetros relevantes para ese extremo específico para definir mejor los datos que se muestran. En el siguiente ejemplo, se realiza una solicitud a Place Details para devolver los componentes de la 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 este caso, el servicio utiliza el id. de sitio proporcionado para buscar el sitio solicitado y devolverá los componentes de la dirección en formato JSON.

Recursos

En la siguiente tabla, se resumen los recursos disponibles mediante las API de Places.

API de Places API de Places (nuevo) Nota
Find Place Text Search (nueva) No hay una versión nueva de Find Place. La búsqueda de texto (nueva) la reemplazó.
Nearby Search Nearby Search (nuevo) Todas las solicitudes que usan la API existente que incluyen una consulta de texto deben usar Text Search (nueva) porque Nearby Search (nuevo) no admite entradas de texto.
Text Search Text Search (nueva)
Place Details Place Details (nuevo)
Place Photo Place Photo (nuevo)
Place Autocomplete Autocompletar (nuevo)
Query Autocomplete Autocompletar (nuevo) Funciones agregadas a Autocomplete (nuevo)

Cómo usar la API de Places

A continuación, se describe una situación de caso práctico típica para utilizar el servicio de la API de Places. Mientras desarrollas tu solución, puedes utilizar extremos adicionales, como Nearby Search y Place Photos.
1 Preparación Para comenzar, configura tu proyecto de Google Cloud y completa las instrucciones de configuración que siguen. Luego, Obtén información para usar tu clave de API. Para la API de Places (nueva), también puedes usar Tokens OAuth.
2 Prueba una búsqueda de texto básica Realizar una búsqueda de texto simple con Text Search (nueva) 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. Usa el el ID de lugar para obtener detalles sobre un lugar. Consulta Place Details (nuevo) y Place Details.
4 Cómo tomar una foto de un lugar El servicio de Place Photos te brinda acceso a las millones de fotos almacenadas en Places en la base de datos. Usa Place Photo (nuevo) o Place Details para acceder a las fotos de un lugar.