Descripción general

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

Por qué usar la API de Places

Crea funciones que tengan en cuenta la ubicación a fin de que los usuarios puedan obtener datos de ubicación detallados con facilidad. Los datos disponibles a través de la API de Places se basan en uno de los modelos de lugar más precisos, completos y actualizados del mundo real. Estos son algunos casos de uso para aplicaciones:

  • Muestra los alquileres de condominios en las principales áreas metropolitanas con resultados orientados específicamente a ciudades.
  • Incluye 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 que enviaron los usuarios.
  • Proporciona a las personas que planean viajes información de contacto, opiniones y niveles de precios de 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 tus aplicaciones:

  • Proporciona resultados de la búsqueda de lugares 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 consultas de texto específicas o consultas 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 que entrega tu aplicación.

Cómo funciona la 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. Por último, la solicitud de servicio usa parámetros relevantes para ese extremo específico a fin de definir mejor los datos que se muestran. Por ejemplo, la siguiente solicitud de Place Details para componentes de dirección funciona de la siguiente manera, si se muestra un 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 lugar proporcionado para buscar el lugar solicitado y mostrar los componentes de dirección en formato JSON.

Recursos

En la siguiente tabla, se resumen los recursos disponibles a través de la API de Places junto con los datos que se muestran.

Recursos de datos Datos mostrados Formato de devolución
Búsqueda de lugares Muestra una lista de lugares en función de la ubicación de un dispositivo o una string de búsqueda.

Consulta los detalles para las respuestas de búsqueda de lugares, las respuestas de búsqueda de sitios cercanos y las respuestas de búsqueda de texto.

  • JSON
  • XML
Detalles del lugar Devuelve información más detallada sobre un sitio específico, incluidas las opiniones del usuario.

Consulta los detalles en Respuestas de Place Details.

  • JSON
  • XML
Fotos del lugar Proporciona acceso a las millones de fotos relacionadas con lugares almacenadas en la base de datos de Google Places.

Consulta los detalles de la respuesta de fotos de lugares.

  • JSON
  • XML
Autocompletado de lugares Completa automáticamente el nombre o la dirección de un sitio mientras los usuarios escriben.

Consulta los detalles de Respuestas de autocompletado de lugares.

  • JSON
  • XML
Autocompletado de consultas Proporciona un servicio de predicción de consultas para búsquedas geográficas basadas en texto y muestra consultas sugeridas a medida que los usuarios escriben.

Consulta los detalles de la sección Respuestas de autocompletado de consultas.

  • JSON
  • XML

Cómo usar la API de Places

Los siguientes pasos abarcan una situación típica de uso para usar tres de los extremos en el servicio de la API de Places. A medida que compilas tu solución, puedes usar extremos adicionales, como Nearby Search, Place Photos y Query Autocomplete.
1 Iniciar configuración Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que aparecen a continuación. Luego, obtén información para usar tu clave de API.
2 Prueba una búsqueda básica de texto Una vez que tengas una clave de API, emite una búsqueda de texto simple como se indica en los ejemplos de búsqueda de texto básico en la guía de búsqueda de texto.
3 Usa una solicitud de Find Place Las solicitudes a Find Place muestran un ID de lugar, junto con los campos de datos que solicitas, como el horario de atención, la dirección y fotos. Consulta los ejemplos de Find Place y prueba uno más relevante para tu caso de uso.
4 Comprende los conceptos básicos sobre las respuestas de Find Place Explora los datos que muestra la respuesta de Find Place. Consulta Cómo buscar respuestas a lugares para obtener más detalles.
5 Usa el ID de lugar para obtener más información Las respuestas de Find Place no proporcionan todos los datos disponibles para un lugar en particular. Puedes usar el ID de lugar que se muestra en una respuesta de Find Place para obtener aún más detalles sobre un lugar. Consulta Place Details.

Bibliotecas cliente disponibles

Llama a esta API en el lenguaje que elijas a través de una de las siguientes bibliotecas cliente:

El cliente de Java, el cliente de Python, el cliente de Go y el cliente de Node.js para los servicios de Google Maps son bibliotecas cliente de código abierto compatibles con la comunidad en virtud de la licencia Apache 2.0. Descárgalas de GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

Próximos pasos