Por qué usar la API de Places
Crea funciones que detecten la ubicación para que los datos de ubicación detallados estén 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 para aplicaciones:
- Muestra alquileres de departamentos en las principales áreas metropolitanas con resultados segmentados específicamente para las 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 las fotos y opiniones que enviaron los usuarios.
- Proporciona a las personas que planifican viajes información de contacto, opiniones y niveles de precios de los establecimientos a lo largo del 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 a partir de diferentes tipos de consultas de los usuarios, como entradas de texto, ubicaciones cercanas y consultas ambiguas o categóricas.
- Habilita las funciones de autocompletado para diferentes tipos de búsqueda, ya sean búsquedas de texto específicas o categóricas.
- Definir mejor el tipo de detalles que se muestran 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 publica tu aplicación.
Muchas APIs de Google Maps Platform admiten IDs de lugar, en los que el ID de lugar identifica 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, incluida la API de Places, pero 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, número de teléfono, calificación de los usuarios y opiniones.
Cómo funciona la API de Places (nueva)
La API de Places (nueva) 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 (nueva) admite la autorización con clave de API y token de OAuth.
En el siguiente ejemplo, se realiza una solicitud de Place Details (New) para mostrar 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
Cómo usar la API de Places
En los siguientes pasos, se describe una situación de caso de uso típica para usar el servicio de la API de Places. A medida que compilas tu solución, puedes usar extremos adicionales, como Nearby Search (nuevo) y Place Photo (nuevo).| 1 | Prepárate | Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación. Luego, obtén información para usar tu clave de API. |
| 2 | Cómo realizar una búsqueda de texto básica | Realiza una búsqueda de texto con Text Search (nueva). |
| 3 | Cómo usar el ID de lugar para obtener más detalles | Muchas APIs de Google Maps Platform devuelven un ID de lugar como parte de una respuesta. Usa los IDs de lugares para obtener Place Details (New). |
| 4 | Cómo obtener una foto de un lugar | El servicio Place Photo (nuevo) te brinda acceso a las millones de fotos almacenadas en la base de datos de Places. Usa Foto de lugar (nueva) para acceder a las fotos de un lugar. |