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 la 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 cómo usar 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 determinadas 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.

Nota: Si no usas sesiones con Autocomplete (nuevo), se te facturará por solicitud a Autocomplete con el SKU: Solicitudes de Autocomplete.

Para obtener más información, consulta Autocomplete (nuevo) y precios 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:

  • 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.

  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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:

  • Servicio web:
    addressComponents
    adrFormatAddress
    formattedAddress
    location
    plusCode
    shortFormattedAddress
    types
    viewport

  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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 más baja:
  • 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 de la fase 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.

  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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:
  • 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 (Basic, Advanced o Preferred), la llamada se factura en SKU: Place Details (Preferred). Para obtener más información, consulta SKU: Uso de la sesión de Autocomplete.

  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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 (Basic, Advanced o Preferred) finaliza una sesión de Autocomplete, la llamada se factura en SKU: Place Details (Preferred). Para obtener más información, consulta SKU: Uso de la sesión de Autocomplete.

  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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:
  • 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.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.

  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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:

  • Servicio web:
    places.currentOpeningHours
    places.currentSecondaryOpeningHours
    places.internationalPhoneNumber
    places.nationalPhoneNumber
    places.priceLevel
    places.priceRange
    places.rating
    places.regularOpeningHours
    places.regularSecondaryOpeningHours
    places.userRatingCount
    places.websiteUri

  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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 + 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

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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:

  • 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.

  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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:
  • 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.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 de la fase 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.

  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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:
  • Servicio web:
    places.currentOpeningHours
    places.currentSecondaryOpeningHours
    places.internationalPhoneNumber
    places.nationalPhoneNumber
    places.priceLevel
    places.priceRange
    places.rating
    places.regularOpeningHours
    places.regularSecondaryOpeningHours
    places.userRatingCount
    places.websiteUri

  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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:
  • Android:
    Place.Field.ACCESSIBILITY_OPTIONS
    Place.Field.ADDRESS_COMPONENTS
    Place.Field.BUSINESS_STATUS
    Place.Field.DISPLAY_NAME
    Place.Field.FORMATTED_ADDRESS
    Place.Field.ICON_BACKGROUND_COLOR
    Place.Field.ICON_MASK_URL
    Place.Field.ID
    Place.Field.LOCATION
    Place.Field.PHOTO_METADATAS
    Place.Field.PLUS_CODE
    Place.Field.TYPES
    Place.Field.VIEWPORT
    Place.Field.UTC_OFFSET.
  • iOS:
    GMSPlaceFieldFormattedAddress
    GMSPlaceFieldBusinessStatus
    GMSPlaceFieldID
    GMSPlaceFieldCoordinate
    GMSPlaceFieldName
    GMSPlaceFieldPhotos
    GMSPlaceFieldPlusCode
    GMSPlaceFieldTypes
    GMSPlaceFieldViewport
  • 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
  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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:
  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.INTERNATIONAL_PHONE_NUMBER, Place.Field.OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS o Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber o GMSPlaceFieldWebsite
  • Servicio web: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours o website
  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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:
Android
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.EDITORIAL_SUMMARY
Place.Field.DINE_IN
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.RESERVABLE
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT
Place.Field.USER_RATING_COUNT

iOS

GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood.

JavaScript

Consulta Campos (Place Details)
curbside_pickup
delivery
dine_in, editorial_summary
price_level
rating
reservable
reviews
serves_beer
serves_breakfast
serves_brunch
serves_dinner
serves_lunch,
serves_vegetarian_food
serves_wine
takeout
user_ratings_total.
  Ejemplos de facturación de máscaras de campos

Estos son ejemplos de cómo se factura la solicitud en función de los campos que seleccionas en la máscara de campos.

  • Si la máscara de campos de tu solicitud solo incluye campos de este SKU, la solicitud se factura a esta tarifa de SKU. Por ejemplo, puedes solicitar uno o más campos de este SKU y se te facturará a esta tarifa.
  • Si la máscara de campos de tu solicitud incluye campos de otros SKU, la solicitud se factura a la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de varios SKU, como un SKU de Essentials y 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.

Una solicitud de Autocomplete que se haga desde el widget Place Autocomplete de la API de Maps JavaScript podría cobrarse como un SKU de Autocomplete, por solicitud si la llamada se hace 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 en los siguientes casos:
  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 Place Details 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 incluya cualquiera de las siguientes solicitudes:
  • Android: Una llamada a fetchPlace()
  • iOS: Una llamada a fetchPlaceFromPlaceID:
  • Servicio web: Una solicitud a Place Details

Una solicitud a Place Details genera SKUs de Data (Basic, Contact o Atmosphere), según los campos que especifiques en la solicitud.

Si no solicitas campos específicos en la solicitud a Place Details, se activarán todos los SKU de Data (Essentials, Pro, Enterprise y Enterprise + Atmosphere). Especifica solo los campos que necesitas para evitar cargos innecesarios.

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

Si tu aplicación hace las tres llamadas siguientes en una sola sesión:

Servicio web

En tu factura, verás estos SKUs (si visualizas tu factura por SKU):

  • Autocomplete (incluido con Place Details), por sesión
  • Place Details
  • Datos básicos
  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 Query Autocomplete 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.

  1. Haces una solicitud a Find Place y especificas solo el campo de dirección: FindPlace(fields: formatted_address). Tu factura muestra estos SKUs:
    • Find Place
    • Datos básicos
  2. Haces una solicitud a Find Place y especificas el campo de número de teléfono: FindPlace(fields: formatted_phone_number). En tu factura, se muestran estos SKUs:
    • Find Place
    • Contact Data
  3. Haces una solicitud a Find Place y especificas campos de los tres segmentos de tipos de datos: FindPlace(fields: formatted_address, opening_hours, price_level). Tu factura muestra estos SKUs:
    • Find 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 en los siguientes casos:
  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.