{"id":17052,"date":"2025-11-02T21:40:41","date_gmt":"2025-11-02T18:10:41","guid":{"rendered":"https:\/\/www.itpiran.net\/blog\/?p=17052"},"modified":"2025-11-02T21:40:41","modified_gmt":"2025-11-02T18:10:41","slug":"a-comprehensive-introduction-to-the-google-places-api-solutions-code-samples-and-costs","status":"publish","type":"post","link":"https:\/\/www.itpiran.net\/blog\/es\/google-cloud-platform\/a-comprehensive-introduction-to-the-google-places-api-solutions-code-samples-and-costs\/","title":{"rendered":"Una introducci\u00f3n completa a la API de Google Places: soluciones, ejemplos de c\u00f3digo y costos."},"content":{"rendered":"

Servicios clave disponibles con la API de Places (Nuevo)<\/b><\/h2>\n

La API de Google Places proporciona varios m\u00e9todos (Endpoints) para buscar y obtener detalles de ubicaci\u00f3n, cada uno dise\u00f1ado para un escenario espec\u00edfico:<\/p>\n

 <\/p>\n\n\n\n\n\n\n\n\n\n
Servicio<\/strong><\/td>\nAplicaci\u00f3n principal<\/strong><\/td>\nEjemplo de proyecto<\/strong><\/td>\n<\/tr>\n<\/thead>\n
Autocompletar<\/b><\/td>\nSugerir nombres de lugares o b\u00fasquedas a medida que el usuario escribe.<\/td>\nCampo de b\u00fasqueda de direcciones en una aplicaci\u00f3n de entrega de comida.<\/td>\n<\/tr>\n
B\u00fasqueda de texto<\/b><\/td>\nB\u00fasqueda de lugares a partir de una cadena de texto gen\u00e9rica.<\/td>\nBusca textos como: \u201cLos mejores restaurantes italianos de Shiraz\u201d.<\/td>\n<\/tr>\n
B\u00fasqueda cercana<\/b><\/td>\nEncuentra lugares en funci\u00f3n de la proximidad a un punto espec\u00edfico y el tipo de lugar.<\/td>\nMostrar todas las "gasolineras" o "cafeter\u00edas" dentro de un radio de 5 km del usuario.<\/td>\n<\/tr>\n
Detalles del lugar<\/b><\/td>\nObt\u00e9n informaci\u00f3n completa y exhaustiva sobre un lugar bas\u00e1ndote en su identificador \u00fanico (ID de lugar).<\/td>\nMuestra la direcci\u00f3n completa, el n\u00famero de tel\u00e9fono, las calificaciones, el horario y las rese\u00f1as del restaurante.<\/td>\n<\/tr>\n
Fotos del lugar<\/b><\/td>\nAcceda a millones de fotos de alta calidad almacenadas de lugares.<\/td>\nMuestra una galer\u00eda de fotos de un hotel o centro comercial en una aplicaci\u00f3n de viajes.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Ejemplos de proyectos y soluciones (casos de uso)<\/b><\/h2>\n

Esta API permite la implementaci\u00f3n de una amplia gama de funcionalidades basadas en la ubicaci\u00f3n:<\/p>\n

    \n
  • Comercio electr\u00f3nico y entrega:<\/b> Habilita la funci\u00f3n Autocompletado de direcciones preciso<\/b> Para los usuarios al realizar un pedido o agregar una nueva direcci\u00f3n (utilizando Autocompletar y Detalles del lugar).<\/li>\n
  • Viajes y turismo:<\/b> Crea una Gu\u00eda Local que Puntos de inter\u00e9s cercanos<\/b> (B\u00fasqueda cercana) muestra hoteles o atracciones tur\u00edsticas y proporciona todos sus detalles (Detalles del lugar).<\/li>\n
  • Aplicaciones de red local:<\/b> Ayudar a los usuarios a \u201c"Registrarse"\u201d<\/b> Hacer negocios en comercios cercanos.<\/li>\n
  • Encuentra un concesionario y sus servicios:<\/b> Mostrar en un mapa la ubicaci\u00f3n de todas las sucursales de una cadena de tiendas o talleres de reparaci\u00f3n autorizados y proporcionar su informaci\u00f3n de contacto.<\/li>\n
  • Mejora de datos:<\/b> Enriquecer la base de datos interna de la empresa con datos estandarizados (como el ID del lugar y la direcci\u00f3n exacta) de Google.<\/li>\n<\/ul>\n
    \n

    Proyectos exitosos y aplicaciones de usuario<\/b><\/h2>\n

    La mayor\u00eda de las aplicaciones y sitios web que necesitan interactuar con mapas y ubicaciones utilizan este servicio. Cualquier plataforma que cuente con un campo de b\u00fasqueda de direcciones inteligente, sugiera lugares cercanos o muestre informaci\u00f3n comercial probablemente utilice la API de Places.<\/p>\n

      \n
    • Servicios de taxi en l\u00ednea (como Uber\/Lyft):<\/b> Utilice la funci\u00f3n de autocompletar para introducir de forma r\u00e1pida y precisa el origen y el destino.<\/li>\n
    • Plataformas de reservas de viajes (como Expedia, Booking.com):<\/b> Muestra informaci\u00f3n completa sobre hoteles y atracciones tur\u00edsticas.<\/li>\n
    • Aplicaciones de reparto de comida y tiendas online:<\/b> Confirma la direcci\u00f3n de entrega y sugiere tiendas cercanas.<\/li>\n<\/ul>\n
      \n

      Ejemplo de c\u00f3digo (ejemplo de b\u00fasqueda cercana)<\/b><\/h2>\n

      Para buscar lugares cercanos (B\u00fasqueda cercana) a un punto, puede utilizar una solicitud HTTP simple (aunque se recomienda utilizar las bibliotecas cliente de Google para diferentes idiomas).<\/p>\n

      Estructura general de la solicitud de b\u00fasqueda de entidades cercanas (API de servicio web):<\/b><\/p>\n

      \n
      https:\/\/maps.googleapis.com\/maps\/api\/place\/nearbysearch\/json?location=-33.8670522,151.1957362&radius=500&type=restaurant&key=YOUR_API_KEY<\/code><\/pre>\n<\/div>\n
      Explicaci\u00f3n de los par\u00e1metros:<\/b><\/p>\n
        \n
      • ubicaci\u00f3n:<\/b> Coordenadas geogr\u00e1ficas del centro de b\u00fasqueda (latitud y longitud).<\/li>\n
      • radio:<\/b> Radio de b\u00fasqueda en metros (en este ejemplo 500 metros).<\/li>\n
      • tipo:<\/b> Tipo de ubicaci\u00f3n deseada (p. ej., restaurante<\/code>).<\/li>\n
      • llave:<\/b> Tu clave API.<\/li>\n<\/ul>\n
        \n
        Estructura de costes y precios<\/b><\/h2>\n
        Plataforma de Google Maps desde un modelo Pago por uso<\/b> De ello se deduce que, en base a SKU (Unidad de mantenimiento de existencias)<\/b> O se calcula el tipo de solicitud.<\/p>\n\n\n\n\n\n\n\n
        Tipo de solicitud (SKU)<\/strong><\/td>\nEstructura de costos<\/strong><\/td>\nPunto clave<\/strong><\/td>\n<\/tr>\n<\/thead>\n
        Solicitudes de autocompletar<\/b><\/td>\nEn funci\u00f3n del n\u00famero de solicitudes<\/td>\nCuanto mayor sea el n\u00famero de solicitudes, menor ser\u00e1 el coste por cada 1.000 solicitudes.<\/td>\n<\/tr>\n
        Detalles del lugar<\/b><\/td>\nBas\u00e1ndonos en la recepci\u00f3n de detalles de un lugar con ID de lugar<\/td>\nEs m\u00e1s caro que una b\u00fasqueda simple porque se recuperan m\u00e1s datos.<\/td>\n<\/tr>\n
        B\u00fasqueda de texto\/cerca<\/b><\/td>\nSeg\u00fan el n\u00famero de b\u00fasquedas<\/td>\nLos precios var\u00edan seg\u00fan el SKU (Essentials o Pro).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
          \n
        • Cr\u00e9dito mensual gratuito:<\/b> Por defecto, Google cobra una cantidad determinada cada mes. Funci\u00f3n de llamadas gratuitas<\/b> Ofrece a los usuarios un cr\u00e9dito de $200 por SKU (esto reemplaza el cr\u00e9dito anterior de $200). Para vol\u00famenes bajos o desarrollo, suele ser suficiente.<\/li>\n
        • Punto importante en el c\u00e1lculo de costes:<\/b> Para reducir los costes de b\u00fasqueda, utilice siempre Enmascaramiento de campo<\/b> Uso. Es decir, en solicitudes. Detalles del lugar<\/code> O Buscar<\/code>, Solo campos<\/b> (como Tama\u00f1o<\/code>, direcci\u00f3n formateada<\/code>Solicita solo los que realmente necesites.<\/li>\n<\/ul>\n
          Para obtener m\u00e1s informaci\u00f3n sobre la implementaci\u00f3n y la codificaci\u00f3n, puede ver el siguiente video. Este video es una introducci\u00f3n a la nueva versi\u00f3n de la API de Places, que puede ser \u00fatil para comprender los \u00faltimos cambios y actualizaciones.<\/p>\n