Uso y facturación de la API de Places

Facturación y precios de la API de Places

Para obtener información sobre cómo Google calcula tu facturación y tus precios, consulta la lista de precios de Google Maps Platform o la lista de precios de Google Maps Platform para India.

SKUs de los productos de Places (nuevo)

Haz clic en el ícono de información información para ver el índice de esta página. En las siguientes secciones, se describen los detalles de cada SKU:

Categoría Si el SKU pertenece a la categoría de SKU Essentials, Pro o Enterprise
Evento facturable Qué evento se factura para el SKU
Activadores Qué elementos de código activan eventos facturables
Precios Vínculos a la tabla de precios del grupo de ese SKU.

Acerca de las máscaras de campo

Para Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo), utiliza el encabezado FieldMask en las solicitudes a la API para especificar la lista de campos que se deben devolver como respuesta. Luego, se te facturará según el SKU más alto que corresponda a tu solicitud. Eso significa que, si seleccionas campos de los SKUs de Essentials y de Pro, se te facturará en función del SKU de Pro.

El uso de campos enmascarados es una práctica de diseño recomendada para garantizar que no solicites datos innecesarios, lo que ayuda a evitar tiempos de procesamiento y cargos de facturación adicionales.

Información acerca de las sesiones de Autocomplete (nuevo)

Una sesión de Autocomplete (nuevo) incluye una o más solicitudes a Autocomplete (nuevo) y una solicitud a Place Details (nuevo) o a Address Validation. El mismo token de sesión se pasa a la solicitud de Autocomplete (nuevo) y a la solicitud subsiguiente de Place Details (nuevo) o de Address Validation.

Una sesión comienza con la primera solicitud a Autocomplete (nuevo). Luego, se realiza una solicitud de Place Details (New) o de Address Validation cuando el usuario selecciona una de las sugerencias de Autocomplete (New). Si se abandona una sesión, es decir, si no se realiza una solicitud de Place Details (nueva) ni una solicitud de validación de direcciones, las solicitudes de Autocomplete (nuevas) se cobran como si no se hubiera proporcionado un token de sesión.

Después de que un usuario selecciona un lugar (es decir, se realiza una solicitud de Place Details (New) o de Address Validation), debes iniciar una nueva sesión con un token de sesión nuevo.

Un token de sesión es válido únicamente para una sesión y no se puede usar para más de una. Si vuelves a usar el token para otra sesión, esta se considera no válida y las solicitudes se cobran como si no se hubiera proporcionado un token de sesión.

SKU: Solicitudes a Autocomplete

Este SKU factura las solicitudes a la API de Autocomplete que no usan una sesión. Para obtener información sobre el uso de la sesión para limitar la cantidad de solicitudes que se facturan durante una sola sesión de Autocomplete, consulta Tokens de sesión o SKU: Uso de la sesión de Autocomplete.

  Categoría Conceptos básicos
  Evento facturable Solicitud
  Activadores

Este SKU se activa en las siguientes condiciones:

  • Tu solicitud no incluye un token de sesión.
  • Tu solicitud incluye un token de sesión, pero abandonas la sesión.
  • Tu solicitud incluye un token de sesión, pero finalizas la sesión en ciertas condiciones. Para obtener información sobre el uso de la sesión de Autocomplete, consulta Tokens de sesión o Uso de la sesión de Autocomplete.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Uso de la sesión de Autocomplete

Este SKU factura cada solicitud a la API de Autocomplete (nueva) que incluya un token de sesión.

  Categoría Conceptos básicos
  Evento facturable Solicitud
  Activadores

Este SKU se activa cuando envías una solicitud a la API de Autocomplete (nueva) que incluye un token de sesión.

Este SKU actúa como un wrapper para el SKU de solicitudes de Autocomplete (nuevo) que te brinda una forma de limitar la cantidad de solicitudes que se facturan durante una sola sesión de Autocomplete. Para obtener información sobre el uso de la sesión de Autocomplete, consulta Tokens de sesión.

Para obtener más información, consulta Precios de la función Autocomplete (nueva) y de la sesión.

  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Place Details Essentials de la API de Places (solo IDs)

Este SKU factura las solicitudes a Place Details que solo muestran el ID del lugar.

  Categoría Conceptos básicos
  Evento facturable Realiza la solicitud con las máscaras de campo especificadas.
  Activadores

Este SKU se activa cuando solicitas los siguientes campos:

Campos para el servicio web

attributions
id
name*
photos

* El campo name contiene el nombre de recurso del lugar con el siguiente formato: places/PLACE_ID. Usa displayName para acceder al nombre del lugar en forma de texto.

  Facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Place Details Essentials de la API de Places

Este SKU factura las solicitudes a la API de Place Details que recuperan los campos de este SKU.
  Categoría Conceptos básicos
  Evento facturable Realiza la solicitud con las máscaras de campo especificadas.
  Activadores

Este SKU se activa cuando solicitas los siguientes campos de ubicación:

Campos para el servicio web

addressComponents
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport

  Facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Place Details Pro de la API de Places

Este SKU factura los campos que especificas en una solicitud de Place Details Pro.

  Categoría Pro
  Evento facturable Realiza la solicitud con las máscaras de campo especificadas.
  Activadores Este SKU se activa cuando solicitas únicamente los siguientes campos o campos de tarifa inferior:

Campos para el servicio web

accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks*
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
utcOffsetMinutes

* El campo googleMapsLinks se encuentra en la etapa de vista previa previa a la DG y no se cobra, lo que significa que la facturación es de USD 0 por el uso durante la vista previa.

  Facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Place Details Enterprise de la API de Places

Este SKU factura una solicitud de Places que incluye campos de Enterprise.

  Categoría Empresarial
  Evento facturable Realiza la solicitud con las máscaras de campo especificadas.
  Activadores Este SKU se activa cuando solicitas los siguientes campos:

Campos para el servicio web

currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
userRatingCount
websiteUri

Si finalizas una sesión de Autocomplete con una llamada a Place Details que solicite cualquier campo del SKU: Place Details Essentials, Pro, Enterprise o Enterprise + Atmosphere, la llamada se facturará en SKU: Place Details Enterprise + Atmosphere. Para obtener más información, consulta SKU: Uso de la sesión de Autocomplete.

  Facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Place Details Enterprise y Atmosphere de la API de Places

Este SKU factura las llamadas a la API de Place Details que solicitan los campos de atmósfera especificados.

  Categoría Empresarial
  Evento facturable Solicitud
  Activadores

Este SKU se activa cuando solicitas los siguientes campos:

  • Servicio web:
    allowsDogs
    curbsidePickup
    delivery
    dineIn
    editorialSummary
    evChargeOptions
    fuelOptions
    goodForChildren
    goodForGroups
    goodForWatchingSports
    liveMusic
    menuForChildren
    parkingOptions
    paymentOptions
    outdoorSeating
    reservable
    restroom
    reviews
    routingSummaries*
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine
    takeout

    * Solo para la Búsqueda de texto y la Búsqueda cercana

Si una llamada a Place Details que solicita cualquier campo del SKU: Place Details Essentials, Pro, Enterprise o Enterprise + Atmosphere finaliza una sesión de Autocomplete, la llamada se factura en el SKU: Place Details Enterprise + Atmosphere. Para obtener más información, consulta SKU: Uso de la sesión de Autocomplete.

  Ejemplos de facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Places API Nearby Search Pro

Este SKU factura los campos que especificas en una solicitud de Nearby Search Pro.

  Categoría Pro
  Evento facturable Realiza la solicitud con las máscaras de campo especificadas.
  Activadores Este SKU se activa cuando solicitas únicamente los siguientes campos o campos de tarifa más baja:

Campos para el servicio web

places.accessibilityOptions
places.addressComponents
places.adrFormatAddress
places.attributions
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks*
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.id
places.location
places.name**
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* El campo places.googleMapsLinks se encuentra en la etapa de vista previa previa a la DG y no se cobra, lo que significa que la facturación es de USD 0 por el uso durante la vista previa.

** El campo places.name contiene el nombre de recurso del lugar con el siguiente formato: places/PLACE_ID. Usa places.displayName para acceder al nombre del lugar en forma de texto.

  Facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Places API Nearby Search Enterprise

Este SKU factura las solicitudes de Búsqueda cercana que incluyen campos de Enterprise.

  Categoría Empresarial
  Evento facturable Realiza la solicitud con las máscaras de campo especificadas.
  Activadores

Este SKU se activa cuando solicitas los siguientes campos:

Campos para el servicio web

places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

  Facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: API de Places Nearby Search Enterprise + Atmosphere

Este SKU factura las solicitudes de búsqueda cercana que incluyen los campos de atmósfera especificados.

  Categoría Empresarial
  Evento facturable Solicitud
  Activadores

Este SKU se activa cuando solicitas los siguientes campos:

  • Servicio web:
    places.allowsDogs
    places.curbsidePickup
    places.delivery
    places.dineIn
    places.editorialSummary
    places.evChargeOptions
    places.fuelOptions
    places.goodForChildren
    places.goodForGroups
    places.goodForWatchingSports
    places.liveMusic
    places.menuForChildren
    places.parkingOptions
    places.paymentOptions
    places.outdoorSeating
    places.reservable
    places.restroom
    places.reviews
    places.routingSummaries*
    places.servesBeer
    places.servesBreakfast
    places.servesBrunch
    places.servesCocktails
    places.servesCoffee
    places.servesDessert
    places.servesDinner
    places.servesLunch
    places.servesVegetarianFood
    places.servesWine
    places.takeout

    * Solo para la Búsqueda de texto y la Búsqueda cercana

  Ejemplos de facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Text Search Essentials (API de Places) (solo IDs)

Este SKU se factura por las solicitudes a la API de Text Search que solo muestran IDs.
  Categoría Conceptos básicos
  Evento facturable Realiza la solicitud con las máscaras de campo especificadas.
  Activadores

Este SKU se activa cuando solicitas únicamente los siguientes campos:

Campos para el servicio web

places.attributions
places.id
places.name*
nextPageToken

* El campo places.name contiene el nombre de recurso del lugar con el siguiente formato: places/PLACE_ID. Usa places.displayName para acceder al nombre del lugar en forma de texto.

  Facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Places API Text Search Pro

Este SKU es un SKU de Data que factura los campos que especificas en una solicitud de Text Search Pro.
  Categoría Pro
  Evento facturable Realiza la solicitud con las máscaras de campo especificadas.
  Activadores Este SKU se activa cuando solicitas únicamente los siguientes campos o campos de tarifa más baja:

Campos para el servicio web

places.accessibilityOptions
places.addressComponents
places.adrFormatAddress
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks*
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.location
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* El campo places.googleMapsLinks se encuentra en la etapa de vista previa previa a la DG y no se cobra ningún cargo, lo que significa que la facturación es de USD 0 por el uso durante la vista previa.

  Facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Places API Text Search Enterprise

Este SKU factura las solicitudes de Text Search que incluyen campos de Enterprise.

  Categoría Empresarial
  Evento facturable Realiza la solicitud con las máscaras de campo especificadas.
  Activadores Este SKU se activa cuando solicitas los siguientes campos:

Campos para el servicio web

places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

  Facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Places API Text Search Enterprise + Atmosphere

Este SKU factura las solicitudes de Text Search que incluyen campos de atmósfera.

  Categoría Empresarial
  Evento facturable Solicitud
  Activadores Este SKU se activa cuando solicitas los siguientes campos:
  • Servicio web:
    places.allowsDogs
    places.curbsidePickup
    places.delivery
    places.dineIn
    places.editorialSummary
    places.evChargeOptions
    places.fuelOptions
    places.goodForChildren
    places.goodForGroups
    places.goodForWatchingSports
    places.liveMusic
    places.menuForChildren
    places.parkingOptions
    places.paymentOptions
    places.outdoorSeating
    places.reservable
    places.restroom
    places.reviews
    places.routingSummaries*
    places.servesBeer
    places.servesBreakfast
    places.servesBrunch
    places.servesCocktails
    places.servesCoffee
    places.servesDessert
    places.servesDinner
    places.servesLunch
    places.servesVegetarianFood
    places.servesWine
    places.takeout

    * Solo para la Búsqueda de texto y la Búsqueda cercana

  Ejemplos de facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Place Details Photos

Este SKU factura las solicitudes de Place Details Photos.

  Categoría Empresarial
  Evento facturable Solicitud
  Activadores La facturación se activa cuando solicitas una foto de la API de Place Details.
  Precios Tabla de precios principal
Tabla de precios de la India

SKUs de productos heredados de Places

Información sobre las sesiones de Autocomplete

Una sesión de Autocomplete incluye algunas solicitudes a Autocomplete (para recuperar sugerencias de un lugar a medida que el usuario escribe) y, como máximo, una solicitud a Place Details (para recuperar detalles sobre el lugar seleccionado por el usuario). El mismo token de sesión se pasa a la solicitud de Autocomplete y a la solicitud subsiguiente de Place Details. Una sesión comienza con la primera solicitud a Autocomplete (que generalmente ocurre cuando el usuario comienza a escribir). Se realiza una llamada a Place Details cuando el usuario selecciona una de las sugerencias de Autocomplete. Si no selecciona ninguna de las sugerencias, no se realiza ninguna llamada a Place Details.

Después de que un usuario selecciona un lugar (es decir, después de que se realiza una llamada a Places Details), debes iniciar una nueva sesión con un token de sesión nuevo.

Las sesiones de Autocomplete se pueden generar desde las siguientes API:

Un token de sesión es válido únicamente para una sesión de usuario y no debe usarse para más de una. Si vuelves a usar el token para otra sesión, esta se considera no válida y las solicitudes se cobran como si no se hubiera proporcionado un token de sesión.

Las solicitudes a Autocomplete y las solicitudes a Place Details que usan sesiones se facturan en diferentes SKUs.

Acerca de los SKUs de Places Data

Los tres SKUs de Places Data son Basic Data, Contact Data y Atmosphere Data.

Se activan uno o más SKU de Data en los siguientes casos:

  • Android: Cada solicitud a fetchPlace() o findCurrentPlace()
  • iOS: Cada llamada a fetchPlaceFromPlaceID: o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Servicio web: Cada solicitud a Places, según los campos especificados en ella

Los SKUs de Data siempre se cobran además del SKU básico de la solicitud que los activa. Por ejemplo, una solicitud a Place Details que incluya campos de Basic Data se cobra tanto en el SKU de Basic Data como en el SKU de Place Details.

En el caso del servicio web, estas solicitudes a las APIs de Places te permiten especificar los campos de datos que se mostrarán:

Para el servicio web, estas llamadas a las APIs de Places NO admiten que se especifiquen los campos que se devuelven. Estas llamadas siempre devuelven todos los datos de Places y se cobran los tres SKUs de Places Data además del cargo por cada solicitud a la API:

SKU: Basic Data

Este SKU es un SKU de Data que factura los campos de Basic Data en una solicitud a Place Details o Find Place. Este SKU se cobra además del SKU básico de la solicitud que lo activó.

Los campos de la categoría Basic se incluyen en el costo base de la solicitud a Places y no se generan cargos adicionales.

  Categoría Conceptos básicos
  Evento facturable Realiza la solicitud con las máscaras de campo especificadas.
  Activadores El SKU Basic Data se activa cuando solicitas cualquiera de los siguientes campos:

Campos para el SDK de Android

Place.Field.ACCESSIBILITY_OPTIONS*
   * Usa en lugar de Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (obsoleto)
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * Usa en lugar de Place.Field.NAME (obsoleto)
Place.Field.FORMATTED_ADDRESS*
   * Usa en lugar de Place.Field.ADDRESS (obsoleto)
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * Usa en lugar de Place.Field.ICON_URL (obsoleto)
Place.Field.ID
Place.Field.LOCATION*
   * Usa en lugar de Place.Field.LAT_LNG (obsoleto)
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.TYPES
Place.Field.VIEWPORT
Place.Field.UTC_OFFSET.

Campos para iOS

GMSPlaceFieldFormattedAddress
GMSPlaceFieldBusinessStatus
GMSPlaceFieldID
GMSPlaceFieldCoordinate
GMSPlaceFieldName
GMSPlaceFieldPhotos
GMSPlaceFieldPlusCode
GMSPlaceFieldTypes
GMSPlaceFieldViewport

Campos para el servicio web

address_component
adr_address
business_status
formatted_address
geometry
icon
name
permanently_closed
photo
place_id
plus_code
type
url
utc_offset
vicinity
wheelchair_accessible_entrance

  Facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Contact Data

Este SKU es un SKU de Data que factura los campos de Contact Data en una solicitud a Place Details o Find Place. Este SKU se cobra además del SKU básico de la solicitud que lo activó.

Si usas el parámetro de campos en la solicitud a Place Details o Find Place para servicios web, o un array de elementos Place.Field para Android o iOS, puedes limitar la respuesta para que incluya solo los campos especificados. Los campos de la categoría Contact generan un cargo adicional.

  Categoría Empresarial
  Evento facturable Realiza la solicitud con las máscaras de campo especificadas.
  Activadores El SKU Contact Data se activa cuando se solicita cualquiera de los siguientes campos:

Campos para el SDK de Android

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * Úsalo en lugar de Place.Field.PHONE_NUMBER (obsoleto).
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

Campos para el SDK de iOS

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

Campos para el servicio web

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  Facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Atmosphere Data

Este SKU factura las solicitudes a la API de Atmosphere Data que especifican los campos de este SKU.

  Categoría Empresarial
  Evento facturable Realiza la solicitud con las máscaras de campo especificadas.
  Activadores La facturación se activa cuando solicitas cualquiera de estos campos:
  Ejemplos de facturación de máscaras de campos

Tu solicitud se factura en función de los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campos solo incluye campos de este SKU: La solicitud se factura a la tarifa de este SKU.
  • Si tu máscara de campos incluye campos de otros SKU, la solicitud se factura a la tasa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y de un SKU de Enterprise, la solicitud se facturará a la tarifa del SKU de Enterprise.
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Autocomplete, por solicitud

Este SKU factura las solicitudes que no incluyen un token de sesión.

Si realizas una solicitud desde una sesión de Autocomplete no válida (por ejemplo, una sesión que reutilice un token de sesión), también se te cobrará un SKU de Autocomplete por solicitud.

Es posible que se cobre un SKU de Autocomplete, por solicitud, a las solicitudes de Autocomplete que se realicen desde el widget Place Autocomplete de la API de Maps JavaScript cuando realices solicitudes desde una sesión de Autocomplete no válida. Esta situación puede ocurrir si el usuario escribe o copia y pega varias direcciones diferentes en el widget y no siempre selecciona una predicción de autocompletado.

  Categoría Conceptos básicos
  Evento facturable Solicitud
  Activadores La facturación se activa para lo siguiente:
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Autocomplete sin Place Details, por sesión

Este SKU se factura cuando se realiza una sesión de Autocomplete que no incluye una solicitud a Place Details (dentro de los minutos siguientes al inicio de la sesión).

  Categoría Pro
  Evento facturable Sesión
  Activadores La facturación se activa si tu aplicación realiza estas dos solicitudes en una sola sesión:

Cuando visualizas tu factura por SKU, verás este SKU:

  • Autocomplete sin Place Details, por sesión
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Autocomplete (incluido con Place Details), por sesión

Las solicitudes de Autocomplete están disponibles sin cargo. Este SKU se factura cuando solicitas detalles de lugares posteriores según los precios normales de Place Details.

  Categoría Conceptos básicos
  Evento facturable Sesión
  Activadores Se cobra el SKU Autocomplete (incluido con Place Details), por sesión por cada sesión de Autocomplete que solicite detalles de lugares. Específicamente:
  • Android: Una llamada a fetchPlace()
  • iOS: Una llamada a fetchPlaceFromPlaceID:
  • Servicio web: Una solicitud a Place Details

Campos de la solicitud:

Asegúrate de especificar los campos que necesitas en la solicitud para evitar cargos innecesarios. Según los campos que especifiques, una solicitud a Place Details también genera estos SKU de Data:

Si no especificas campos en la solicitud a Place Details, se activarán todos los SKU de Data.

Si solo solicitas una actualización del ID de Place Details (tu solicitud solo especifica el campo place_id) durante una sesión de Autocomplete, la sesión se factura como SKU: Autocomplete sin Place Details, por sesión.

  Ejemplos

En este ejemplo, se muestra una serie de solicitudes, por plataforma, que generarían los siguientes SKU en tu factura cuando la veas por SKU:

  • Autocomplete (incluido con Place Details), por sesión
  • Place Details
  • Datos básicos

Ejemplo de solicitud por plataforma:

Solicitudes de Android

findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
fetchPlace() (con un FetchPlaceRequest, incluido el ID de lugar y el campo ADDRESS)

Solicitudes de iOS

placesClient?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (incluido el ID de lugar y el campo GMSPlaceFieldFormattedAddress)

Solicitudes de servicios web

Solicitud de Place Autocomplete (input="par", session_token: XYZ)
Solicitud de Place Autocomplete (input="paris", session_token: XYZ)
Places Details (place_id, session_token: XYZ, fields:formatted_address)

  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Query Autocomplete, por solicitud

Este SKU heredado factura las solicitudes de Query Autocomplete.

  Categoría Conceptos básicos
  Evento facturable Solicitud
  Activadores

Este SKU se activa cuando realizas una solicitud de Autocomplete de consultas con los siguientes servicios:

Query Autocomplete no admite el precio por sesión de Autocomplete. Las solicitudes posteriores a Place Details se cobran según el SKU de Place Details Pro.

  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Place Details Pro

Este SKU factura las solicitudes heredadas de Place Details.

  Categoría Pro
  Evento facturable Solicitud
  Activadores La facturación se activa para las solicitudes de las siguientes APIs:

Con la API y los servicios web, se cobra el SKU de Place Details, independientemente de si proporcionas un token de sesión o no.

Este SKU también activa la facturación de los SKU de Data: Si incluyes campos de datos en tu solicitud, se puede activar la facturación adicional de los SKU de Data: Basic, Contact y Atmosphere. Especifica solo los campos de datos que deseas para evitar costos innecesarios. Se te factura este SKU, así como los datos que solicites.

  Ejemplos
  1. Realizas una de estas llamadas o solicitudes:
    • Dispositivo móvil: Llamas a fetchPlace() en Android o a fetchPlaceFromPlaceID: en iOS y especificas solo el campo ADDRESS.
    • Servicio web o API: Realizas una solicitud a Place Details y especificas solo el campo de dirección: getPlaceDetails(fields: formatted_address).
    En tu factura, verás estos SKUs (si visualizas tu factura por SKU):
    • Place Details
    • Datos básicos
  2. Realizas una de estas llamadas o solicitudes:
    • Dispositivo móvil: Llamas a fetchPlace() en Android o a fetchPlaceFromPlaceID: en iOS y especificas solo el campo PHONE_NUMBER.
    • Servicio web o API: Realizas una solicitud a Place Details y especificas el campo de número de teléfono: getPlaceDetails(fields: formatted_phone_number).
    En tu factura, verás estos SKUs (si visualizas tu factura por SKU):
    • Place Details
    • Contact Data
  3. Realizas una de estas llamadas o solicitudes:
    • Dispositivo móvil: Llamas a fetchPlace() en Android o a fetchPlaceFromPlaceID: en iOS y especificas todos los campos.
    • API o servicio web: Realizas una solicitud a Place Details y especificas todos los campos (este tipo de solicitud es el predeterminado si no especificas ningún campo): getPlaceDetails().
    En tu factura, verás estos SKUs (si visualizas tu factura por SKU):
    • Place Details
    • Datos básicos
    • Contact Data
    • Atmosphere Data
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Place Details – ID Refresh

Este SKU factura las solicitudes a la API de Place Details que actualizan los IDs de lugares inactivos.

  Categoría Conceptos básicos
  Evento facturable Solicitud
  Activadores La facturación se activa cuando haces una solicitud a Place Details y especificas solo el campo de ID del lugar: getPlaceDetails(fields: place_id).
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Find Place

Este SKU factura las solicitudes a Find Place que muestran más campos que solo el ID del lugar.

Este SKU también activa la facturación de los SKU de Data: Si incluyes campos de datos en tu solicitud, se puede activar la facturación adicional de los SKU de Data: Basic, Contact y Atmosphere. Especifica solo los campos de datos que deseas para evitar costos innecesarios. Se te factura este SKU, así como los datos que solicites.

  Categoría Pro
  Evento facturable Solicitud
  Activadores Este SKU factura las solicitudes a los siguientes métodos:
  • Find Current Place

Este SKU también activa la facturación de los SKU de Data: Si incluyes campos de datos en tu solicitud, se puede activar la facturación adicional de los SKU de Data: Basic, Contact y Atmosphere. Especifica solo los campos de datos que deseas para evitar costos innecesarios. Se te factura este SKU, así como los datos que solicites.

  Ejemplos

En los siguientes ejemplos, se muestra por qué SKU se te factura cuando realizas una solicitud a Find Current Place y especificas campos de los SKU de datos Basic, Contact y Atmosphere. Para ver los SKU en tu factura, consulta la sección Cómo analizar el uso y el costo por SKU.

Haces una solicitud a Find Place con solo el campo ADDRESS:

Tu factura muestra estos SKUs:

  • Find Current Place
  • Datos básicos

Haces una solicitud a Find Place con solo el campo PHONE_NUMBER:

En tu factura, se muestran los siguientes SKU:

  • Find Current Place
  • Contact Data

Haces una solicitud a Find Place con los tres campos de tipo de datos:

En tu factura, se muestran los siguientes SKU:

  • Find Current Place
  • Datos básicos
  • Contact Data
  • Atmosphere Data

  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Find Place, solo ID

Este SKU factura las solicitudes a Find Place que solo muestran el ID del lugar. De forma predeterminada, si no especificas ningún campo en la solicitud a Find Place, solo se devuelve el ID del lugar.

  Categoría Conceptos básicos
  Evento facturable Solicitud
  Activadores Realizas una solicitud a Find Place sin especificar ningún campo o solo especificas el campo place_id: FindPlace(fields: place_id).
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Places – Nearby Search

Este SKU factura las solicitudes de Búsqueda cercana.

  Categoría Pro
  Evento facturable Solicitud
  Activadores Este SKU se activa cuando realizas una solicitud de Búsqueda cercana con una de las siguientes APIs:

Esta solicitud no admite especificar qué campos mostrar. La respuesta muestra una lista de lugares y un subconjunto de los campos de datos admitidos.

Este SKU también activa la facturación de los SKU de Data: Si incluyes campos de datos en tu solicitud, se puede activar la facturación adicional de los SKU de Data: Basic, Contact y Atmosphere. Especifica solo los campos de datos que deseas para evitar costos innecesarios. Se te factura este SKU, así como los datos que solicites.

  Ejemplos

Haces una solicitud a Nearby Search, como NearbySearch (San Francisco, 100 meters). Tu factura muestra estos SKUs cuando visualizas tu factura por SKU:

  • Lugar
  • Datos básicos
  • Contact Data
  • Atmosphere Data
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Places – Text Search

Este SKU factura las solicitudes al servicio de Text Search de Places.

  Categoría Pro
  Evento facturable Solicitud
  Activadores La facturación se activa para las solicitudes a los siguientes servicios:

Las solicitudes a Text Search muestran una lista de lugares, pero no admiten que se especifiquen los campos que se muestran. Estas solicitudes muestran un subconjunto de los campos de datos admitidos. Se te cobra por cada solicitud a Text Search, así como por todos los SKUs de tipo de datos: Basic Data, Contact Data y Atmosphere Data.

El SKU de Places – Text Search también se activa a través del widget Place SearchBox de la API de Maps JavaScript: el método getPlaces() después de que el usuario selecciona una búsqueda de lugar (ícono: lupa), no un resultado (ícono: pin), como se muestra en la siguiente imagen:

Selección de búsquedas del widget SearchBox de Place Details
En los resultados del widget del cuadro de búsqueda, después de escribir "pizza" en el cuadro de búsqueda, observa que pizza delivery tiene un ícono de lupa, lo que indica que se trata de una búsqueda de lugar (y no un resultado).
  Ejemplo

Si realizas una solicitud de Text Search, como TextSearch(123 Main Street), tu factura muestra estos SKUs cuando visualizas tu factura por SKU:

  • Place - Text Search
  • Datos básicos
  • Contact Data
  • Atmosphere Data
  Precios Tabla de precios principal
Tabla de precios de la India

SKU: Place Details Photos de la API de Places

Este SKU factura el servicio heredado de Place Photos.

  Categoría Empresarial
  Evento facturable Solicitud
  Activadores La facturación se activa para lo siguiente:
  Precios Tabla de precios principal
Tabla de precios de la India

Otros límites de uso

Si bien no hay una cantidad máxima de solicitudes por día, se aplican los siguientes límites de uso:

  • API de Places (nueva): El límite de frecuencia es de 600 QPM (solicitudes por minuto) por método de API por proyecto. Es decir, cada método de la API tiene una cuota independiente.

  • API de Places: El límite de frecuencia es de 6,000 QPM (solicitudes por minuto). Se calcula como la suma de las solicitudes del cliente y del servidor para todas las aplicaciones que usan las credenciales del mismo proyecto.

Restricciones de las Condiciones de Uso

Para obtener información sobre las Condiciones de Uso, consulta las políticas de la API de Places y la sección Restricciones de licencia de las Condiciones del Servicio de Google Maps Platform.