Uso y facturación de la API de Places

Recordatorio: Para usar la API de Places, debes habilitar la facturación en cada uno de tus proyectos y, además, incluir una clave de API o un token de OAuth con todas las solicitudes a la API o el SDK.

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.

Nota: Los tokens de sesión pueden superponerse entre proyectos, pero deben ser únicos para cada proyecto. Por ejemplo, una app que usa el proyecto A y una que usa el proyecto B pueden usar el mismo token de sesión, mientras que varias apps que usan el proyecto A no pueden usar el mismo token de sesión.

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. Nota: Si no usas sesiones con Autocomplete (nuevo), se te facturará por cada solicitud a Autocomplete con el SKU: Solicitudes de Autocomplete. 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:

• El servicio Place Autocomplete de la API de Places o el servicio Place Autocomplete de la API de Maps JavaScript. Debes diseñar tu aplicación para que proporcione tokens de sesión (es posible que debas cambiar tu código existente).
• El widget Autocomplete de la API de Maps JavaScript. La facturación basada en la sesión se habilita de forma automática en esos widgets, sin necesidad de cambiar el código.

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:

• Places Details Pro
• Find Place

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:

• Places – Nearby Search
• Places – Text Search

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.

Nota: Este SKU es un SKU de Data, por lo que se te cobrará por estos campos además del SKU básico de la solicitud que lo activó.

	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: Android: findAutocompletePredictions() iOS: findAutocompletePredictionsFromQuery: JavaScript: El servicio Place Autocomplete de la API de Maps JavaScript Servicio web: El servicio Place Autocomplete de la API de Places
	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: Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... Servicio web Solicitud de Place Autocomplete (input="par", session_token: XYZ) Solicitud de Place Autocomplete (input="paris", session_token: XYZ) 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

Nota: Puedes ver este SKU en los informes de facturación, pero no en la página Facturación > Precios de la consola de Google Cloud.

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: Datos básicos (Essentials) Lugares: Datos de contacto (para empresas) Places: Atmosphere (Enterprise) 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: JavaScript: El servicio Place Autocomplete de la API de Maps JavaScript (getQueryPredictions()) y el uso del widget SearchBox de la API de Maps JavaScript (las solicitudes de Query Autocomplete se generan a medida que el usuario escribe). Servicio web: El servicio Query Autocomplete de la API de Places 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: Android: SDK de Places para Android (fetchPlace()) iOS: SDK de Places para iOS (fetchPlaceFromPlaceID:) JavaScript: Servicio Place Details de la API de Maps JavaScript (getDetails) JavaScript: Widget Place Autocomplete de la API de Maps JavaScript (getPlace) JavaScript: widget Place SearchBox de la API de Maps JavaScript: método getPlaces() después de que el usuario selecciona un resultado de lugar (ícono: pin), *no* una búsqueda (ícono: lupa), como se muestra a continuación: En los resultados del widget del cuadro de búsqueda, después de escribir "pizza" en el cuadro de búsqueda, observa que Pizza Autentico tiene un ícono de pin junto a él, lo que indica que es un resultado de lugar (y no una búsqueda). Servicio web: Servicio Place Details de la API de Places 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	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 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 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: Servicio Place Nearby Search de la API de Maps JavaScript (nearbySearch()) Servicio Nearby Search de la API de Places 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: Servicio Place Text Search de la API de Maps JavaScript (textSearch()). Servicio Text Search de la API de Places 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: 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: Android: Llamadas a fetchPhoto() iOS: Llamadas a loadPlacePhoto: JavaScript: Llamadas al servicio Place Photos de la biblioteca de Places para la API de Maps JavaScript cuando se solicitan datos de las URLs que muestra PlacePhoto.getUrl() para cargar datos de píxeles de imágenes. No activa la facturación hasta que la URL se use realmente para obtener datos de píxeles. Servicio web: Solicitudes al servicio Place Photos de la API de Places
	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.

---