Cómo utilizar la API de Google Places y obtener una clave de API

¿Qué es Google Places API

Places API es un servicio que devuelve información sobre lugares mediante solicitudes HTTP. Los lugares aquí suelen estar definidos dentro de esta API como establecimientos, ubicaciones geográficas o puntos de interés destacados. 

Hay cinco tipos de solicitudes disponibles dentro de la API. Son:

• Búsqueda de lugar que devuelve una lista de lugares basados en la ubicación de un usuario o una cadena de búsqueda.
• Detalles del lugar que proporciona información detallada sobre un lugar específico, incluidas las reseñas de los usuarios.
• Fotos del lugar otorga acceso a millones de fotos relacionadas con lugares almacenadas en la base de datos de Google Places.
• Reseñas del lugar permite acceder e incrustar reseñas de Google desde la plataforma.
• Autocompletado de lugar está ahí para completar automáticamente el nombre o la dirección de un lugar a medida que los usuarios escriben.
• Autocompletado de consulta ofrece un servicio de predicción de consultas para búsquedas geográficas basadas en texto, devolviendo consultas sugeridas a medida que los usuarios escriben.

Para trabajar con la API de lugares necesitas una clave que debes incluir con cada solicitud de la API de Places. Averigüemos qué es exactamente y cómo obtener la clave de la API para Google Places API. 

Cómo crear una clave de API de Google Places

La clave de API es un identificador único que está ahí para autenticar solicitudes asociadas con tu proyecto con fines de uso y facturación. Al usar una clave de API para autenticar solicitudes, puedes:

• Administrar tus APIs en Google Cloud Console.
• Acceder a datos de uso en tiempo real y a 30 días de datos de uso histórico en la Consola de la Plataforma Google Cloud.
• Observar informes de uso con más de 30 días de información en el Portal de Soporte de Google Cloud.

Puedes encontrar más información sobre los informes disponibles para los clientes del Plan Premium aquí. Ahora puedes proceder a obtener la clave. 

Siempre eres libre de probar una forma alternativa de agregar reseñas de clientes a tu sitio web. Por ejemplo, está el widget de reseñas de Google de Elfsight: no necesitas preocuparte por obtener claves de API o aprender a codificar.

Obtén tu clave de API de Places y agrégala a tu solicitud

Para obtener tu clave de API, debes realizar las siguientes acciones:

• Abre Google Cloud Platform Console.
• Haz clic en la lista desplegable del proyecto y selecciona el proyecto creado para ti. Su nombre debería comenzar con Google Maps APIs for Business o Google Maps for Work o Google Maps.
• Luego haz clic en el botón de menú y elige APIs & Servicios > Credenciales.
• En la página Credenciales, selecciona Crear credenciales > Clave de API. Allí verás un cuadro de diálogo de creación de clave de API que muestra tu clave recién creada.
• Cierra la pestaña. Tu nueva clave de API se enumera en la página de credenciales en la sección de claves de API.

Luego debes agregar la clave de API a cada solicitud de API de Places. Usando el siguiente ejemplo, simplemente reemplaza YOUR_API_KEY con tu clave de API:

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?location=-33.8670522,151.1957362
  &radius=500
  &types=food
  &name=harbour
  &key=YOUR_API_KEY

Ten en cuenta que Google recomienda encarecidamente que restrinjas tu clave de API. Las restricciones otorgan seguridad adicional y ayudan a garantizar que solo se realicen solicitudes autorizadas con tu clave de API.

Cómo restringir tu clave de API de Google Places

Hay dos restricciones y debes configurar ambas. Son:

• Restricción de aplicación. Esta función te permite limitar el uso de la clave de API a sitios web, servidores web o aplicaciones móviles. Hay solo una restricción de esta categoría que se puede elegir. 
• Restricción de API. Este tipo de restricción limita el uso de la clave de API a una o más APIs o SDKs. 

Para restringir tu clave de API debes:

• Abre Google Cloud Console.
• Haz clic en la lista desplegable del proyecto y selecciona el proyecto que contiene la clave de API que deseas asegurar.
• Haz clic en el botón de menú y elige APIs & Servicios > Credenciales.
• Haz clic en el nombre de la clave de API que necesitas asegurar en la página de Credenciales. 
• Establece las restricciones en la página Restringir y renombrar clave de API. 

Después de configurar las restricciones, simplemente haz clic en el botón Guardar. 

Usando Google Places API: ejemplos

Hay varias formas de usar Google Places API. Veamos algunas de ellas.

Búsqueda de lugares

Como se mencionó anteriormente, Places API te permite buscar información sobre lugares usando una gran cantidad de categorías. El siguiente ejemplo de Google Places API demuestra una solicitud de Búsqueda de lugar para «Museo de Arte Contemporáneo de Australia»:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY

Detalles del lugar

Una vez que obtienes un place_id de una Búsqueda de lugares de Google, puedes obtener más información sobre un establecimiento o punto de interés particular iniciando una solicitud de Detalles del lugar. Aquí podemos ver una solicitud de detalles de un lugar por place_id: 

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY

Fotos del lugar

Este servicio te permite agregar contenido fotográfico a tus aplicaciones. Proporciona acceso a millones de fotos almacenadas en la base de datos de Lugares. Aquí tienes un ejemplo de solicitud:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY

Autocompletado de lugar

Es un servicio web que devuelve predicciones de lugares como respuesta a una solicitud HTTP. Se puede utilizar para proporcionar funcionalidad de autocompletado para búsquedas geográficas basadas en texto. Aquí tienes un ejemplo de una solicitud para establecimientos:

https://maps.googleapis.com/maps/api/place/autocomplete/xml?input=Amoeba&types=establishment&location=37.76999,-122.44696&radius=500&key=YOUR_API_KEY

Autocompletado de consulta

Este tipo de servicio se utiliza para proporcionar una predicción de consulta para búsquedas geográficas basadas en texto, devolviendo consultas sugeridas a medida que un usuario escribe. Una solicitud de ejemplo se ve así:

https://maps.googleapis.com/maps/api/place/queryautocomplete/json?key=YOUR_API_KEY&input=pizza+near%20par

Precios y límites de Google Places API

Google utiliza un modelo de precios de pago por uso. Esto significa que las API de Google Maps Platform se facturan por SKU. El uso se rastrea para cada SKU de producto, y una API puede tener más de un SKU de producto. 

Hay 1,000 búsquedas gratuitas de API de Lugares por cada 24 horas, pero puedes aumentarlas a 150,000 búsquedas gratuitas por 24 horas habilitando la facturación en Google Cloud Console. 

Puedes consultar la documentación de la API de Lugares de Google para obtener más detalles sobre todos los precios y límites. 

Preguntas frecuentes

Conclusión

Ahora tienes una comprensión del proceso de obtención de la clave de API de Google Maps Places. Como habrás notado, es muy simple y en realidad no requiere más de 5 minutos. Lo único que debes saber antes de empezar es el tipo de API con el que planeas trabajar.