Se usó la API de Cloud Translation para traducir esta página.

Uso y facturación del SDK de Places para iOS

Error: `kGMSPlacesRateLimitExceeded`

Las solicitudes del SDK de Places para iOS a la API de Places se facturan por SKU. Haz clic en el ícono de información información para ver el índice de esta página.

Facturación y precios del SDK de Places para iOS

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.

Detalles del SKU del SDK de Places para iOS (nuevo)

Acerca de las máscaras de campo

Usa máscaras de campo, también llamadas listas de campos, en tus solicitudes para especificar la lista de campos que la respuesta debe devolver. Luego, se te facturará según el SKU más alto que corresponda a tu solicitud. Eso significa que, si seleccionas campos del SKU (Basic) y del SKU (Advanced), se te facturará en función del SKU (Advanced).

Usar una máscara de campo 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: iOS: `GMSPlacePropertyPlaceID` `GMSPlacePropertyPhotos`
	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: iOS: `GMSPlacePropertyAddressComponents` `GMSPlacePropertyFormattedAddress` `GMSPlacePropertyCoordinate` `GMSPlacePropertyPlusCode` `GMSPlacePropertyTypes` `GMSPlacePropertyViewport`
	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: iOS: `GMSPlacePropertyBusinessStatus` `GMSPlacePropertyIconBackgroundColor` `GMSPlacePropertyIconImageURL` `GMSPlacePropertyName` `GMSPlacePropertyUTCOffsetMinutes` `GMSPlacePropertyWheelchairAccessibleEntrance`
	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: iOS: `GMSPlacePropertyCurrentOpeningHours` `GMSPlacePropertySecondaryOpeningHours` `GMSPlacePropertyPhoneNumber` `GMSPlacePropertyPriceLevel` `GMSPlacePropertyRating` `GMSPlacePropertyOpeningHours` `GMSPlacePropertyUserRatingsTotal` `GMSPlacePropertyWebsite` 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: iOS: `GMSPlacePropertyCurbsidePickup` `GMSPlacePropertyDelivery` `GMSPlacePropertyDineIn` `GMSPlacePropertyEditorialSummary` `GMSPlacePropertyReservable` `GMSPlacePropertyReviews` `GMSPlacePropertyServesBeer` `GMSPlacePropertyServesBreakfast` `GMSPlacePropertyServesBrunch` `GMSPlacePropertyServesDinner` `GMSPlacePropertyServesLunch` `GMSPlacePropertyServesVegetarianFood` `GMSPlacePropertyServesWine` `GMSPlacePropertyTakeout` 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: iOS: `GMSPlacePropertyAddressComponents` `GMSPlacePropertyBusinessStatus` `GMSPlacePropertyCoordinate` `GMSPlacePropertyFormattedAddress` `GMSPlacePropertyName` `GMSPlacePropertyIconBackgroundColor` `GMSPlacePropertyIconImageURL` `GMSPlacePropertyPhotos` `GMSPlacePropertyPlaceID` `GMSPlacePropertyPlusCode` `GMSPlacePropertyTypes` `GMSPlacePropertyUTCOffsetMinutes` `GMSPlacePropertyViewport` `GMSPlacePropertyWheelchairAccessibleEntrance`
	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: iOS: `GMSPlacePropertyCurrentOpeningHours` `GMSPlacePropertySecondaryOpeningHours` `GMSPlacePropertyPhoneNumber` `GMSPlacePropertyPriceLevel` `GMSPlacePropertyRating` `GMSPlacePropertyOpeningHours` `GMSPlacePropertyUserRatingsTotal` `GMSPlacePropertyWebsite`
	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: iOS: `GMSPlacePropertyCurbsidePickup` `GMSPlacePropertyDelivery` `GMSPlacePropertyDineIn` `GMSPlacePropertyEditorialSummary` `GMSPlacePropertyReservable` `GMSPlacePropertyReviews` `GMSPlacePropertyServesBeer` `GMSPlacePropertyServesBreakfast` `GMSPlacePropertyServesBrunch` `GMSPlacePropertyServesDinner` `GMSPlacePropertyServesLunch` `GMSPlacePropertyServesVegetarianFood` `GMSPlacePropertyServesWine` `GMSPlacePropertyTakeout`
	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: iOS: `GMSPlacePropertyPlaceID` `GMSPlacePropertyName`
	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: iOS: `GMSPlacePropertyAddressComponents` `GMSPlacePropertyBusinessStatus` `GMSPlacePropertyFormattedAddress` `GMSPlacePropertyIconBackgroundColor` `GMSPlacePropertyIconImageURL` `GMSPlacePropertyCoordinate` `GMSPlacePropertyPhotos` `GMSPlacePropertyPlusCode` `GMSPlacePropertyTypes` `GMSPlacePropertyUTCOffsetMinutes` `GMSPlacePropertyViewport` `GMSPlacePropertyWheelchairAccessibleEntrance`
	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: iOS: `GMSPlacePropertyCurrentOpeningHours` `GMSPlacePropertySecondaryOpeningHours` `GMSPlacePropertyPhoneNumber` `GMSPlacePropertyPriceLevel` `GMSPlacePropertyRating` `GMSPlacePropertyOpeningHours` `GMSPlacePropertyUserRatingsTotal` `GMSPlacePropertyWebsite`
	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: iOS: `GMSPlacePropertyCurbsidePickup` `GMSPlacePropertyDelivery` `GMSPlacePropertyDineIn` `GMSPlacePropertyEditorialSummary` `GMSPlacePropertyReservable` `GMSPlacePropertyReviews` `GMSPlacePropertyServesBeer` `GMSPlacePropertyServesBreakfast` `GMSPlacePropertyServesBrunch` `GMSPlacePropertyServesDinner` `GMSPlacePropertyServesLunch` `GMSPlacePropertyServesVegetarianFood` `GMSPlacePropertyServesWine` `GMSPlacePropertyTakeout`
	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

Detalles de los SKU heredados del SDK de Places para iOS

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.

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`. Campos obsoletos: Los siguientes campos dejaron de estar disponibles en la versión 4.0 del SDK de Places para Android: `Place.Field.ADDRESS`, `Place.Field.ICON_URL`, `Place.Field.LAT_LNG`, `Place.Field.NAME` y `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE`. En su lugar, usa `Place.Field.FORMATTED_ADDRESS`, `Place.Field.ICON_MASK_URL`, `Place.Field.LOCATION`, `Place.Field.DISPLAY_NAME` y `Place.ACCESSIBILITY_OPTIONS`, respectivamente. `Place.Field.ACCESSIBILITY_OPTIONS` solo está disponible para Place Details (nuevo). 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` Campos obsoletos: El campo `Place.Field.PHONE_NUMBER` dejó de estar disponible en la versión 4.0 del SDK de Places para Android. En su lugar, usa `Place.Field.INTERNATIONAL_PHONE_NUMBER`. 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: iOS `GMSPlaceFieldPriceLevel` `GMSPlaceFieldRating` `GMSPlaceFieldUserRatingsTotal` `GMSPlaceFieldTakeout` `GMSPlaceFieldDelivery` `GMSPlaceFieldDineIn` `GMSPlaceFieldCurbsidePickup` `GMSPlaceFieldReservable` `GMSPlaceFieldServesBreakfast` `GMSPlaceFieldServesLunch` `GMSPlaceFieldServesDinner` `GMSPlaceFieldServesBeer` `GMSPlaceFieldServesWine` `GMSPlaceFieldServesBrunch` `GMSPlaceFieldServesVegetarianFood`.
	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: 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

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: Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) fetchPlace() (con un `FetchPlaceRequest` que incluye el ID de Place y el campo ADDRESS) iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... fetchPlaceFromPlaceID: (incluido el ID de lugar y el campo `GMSPlaceFieldFormattedAddress`) Servicio web Servicio 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) 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: 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: Find Current Place

Este SKU factura las solicitudes a 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.

	Categoría	Pro
	Evento facturable	Solicitud
	Activadores	Este SKU factura las solicitudes a los siguientes métodos: `findCurrentPlace()` (Android) `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) 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 `findCurrentPlace()` (Android) o a `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) y especificas solo el campo `ADDRESS`. Tu factura muestra estos SKUs: Find Current Place Datos básicos Realizas una solicitud a `findCurrentPlace()` (Android) o a `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) y especificas el campo `PHONE_NUMBER`. Tu factura muestra estos SKUs: Find Current Place Contact Data Haces una solicitud a `findCurrentPlace()` (Android) o a `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) y especificas campos de los tres segmentos de tipos de datos. Tu factura muestra estos SKUs: Find Current Place 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: 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 aplica el siguiente límite de uso cuando se usa el SDK de Places para iOS:

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 el artículo sobre las restricciones de la licencia de las Condiciones del Servicio de Google Maps Platform.