Elfsight Birthday Sale

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

Si estabas buscando una manera de comenzar a trabajar con la API de Google Places, aquí tienes una guía completa para ti. Hoy vamos a descubrir qué hace exactamente esta herramienta, ver algunos ejemplos, aprender cómo obtener una clave de API y revisar los límites y precios.
Crear Widget en la Demo en Vivo
Share:
Compartir en Facebook
Share on X
Share on LinkedIn
Share on WhatsApp
Copy Link
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.
Consejo: debes tener al menos una clave de API asociada con tu proyecto.

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. 
Consejo: Recuerda que la API de Places no funciona con una clave de API restringida para Android o iOS.

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
Consejo: Para que todos los ejemplos mencionados anteriormente funcionen para ti, necesitas reemplazar la clave de API con la que tienes.

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. 

Rango de volumen mensual (Precio por LLAMADA)0–100,000100,001–500,000500,000+
Autocompletado0.00283 USD por cada una (2.83 USD por 1000)0.00227 USD por cada una (2.27 USD por 1000)Contacta a ventas para precios por volumen
Autocompletado de consulta0.00283 USD por cada una (2.83 USD por 1000)0.00227 USD por cada una (2.27 USD por 1000)Contacta a ventas para precios por volumen
Detalles del lugar0.017 USD por cada una (17.00 USD por 1000)0.0136 USD por cada una (13.60 USD por 1000)Contacta a ventas para precios por volumen
Fotos del lugar0.007 USD por cada una (7.00 USD por 1000)0.0056 USD por cada una (5.60 USD por 1000)Contacta a ventas para precios por volumen
Búsqueda0.032 USD por cada una (32.00 USD por 1000)0.0256 USD por cada una (25.60 USD por 1000)Contacta a ventas para precios por volumen

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

¿Es un servicio gratuito la API de Lugares de Google?

La API de Lugares utiliza un modelo de precios de pago por uso. Para obtener más detalles sobre los precios, consulta la tabla anterior o revisa la documentación.

¿Cómo puedo usar la API de Lugares de Google?

Para hacerlo posible, necesitas obtener una clave de API. Puedes hacerlo a través de tu Consola de Cloud haciendo clic en la lista desplegable del proyecto y seleccionando el proyecto creado para ti.

¿Cómo puedo agregar o editar lugares?

Si eres propietario del negocio, puedes hacerlo en Google Maps utilizando Google My Business. Si no eres propietario del lugar que deseas editar, aún puedes sugerir cambios.

¿Cómo puedo empezar a usar las API para mi sitio web?

Primero, necesitas entender qué API exactamente necesitas. Consulta las guías de Descripción general, Desarrollador y Comenzar para la API o SDK específico en el que estás interesado.

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.

Elfsight Birthday Sale
33% OFF
Get your spot at our party!
Grab The Deal