Uso y facturación del SDK de Places para iOS

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Error: kGMSPlacesRateLimitExceeded

El SDK de Places para iOS usa un modelo de precios de pago por uso. Las solicitudes al SDK de Places para iOS para la API de Places se facturan según el SKU. Además de las Condiciones de Uso generales de Google, existen límites de uso específicos del SDK de Places para iOS. Administra los costos y el uso con las herramientas disponibles en Google Cloud Console.

Cómo se factura el SDK de Places para iOS

El SDK de Places para iOS usa un modelo de precios de pago por uso. Las API y los SDK de Google Maps Platform se facturan por SKU. Se realiza un seguimiento del uso de cada SKU, y cualquier API o SDK puede tener más de un SKU de producto. El costo se calcula de la siguiente manera:

Uso de SKU × precio por cada uso

Usa nuestra Calculadora de precios y uso para estimar tu costo de uso por API o SDK. Para cada cuenta de facturación, hay disponible un crédito mensual de USD 200 en Google Maps Platform que se aplica automáticamente1 a los SKU aptos de esa plataforma.

Precios 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, se hace una llamada a Place 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 SKU.

Acerca de los SKU de Places 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

Las solicitudes a Data generan un cargo además del costo de la solicitud a Places. Los cargos por uso de Data siempre se hacen en paralelo con las solicitudes a Places.


SKU: Basic Data

Cuando usas el parámetro de campos en la solicitud a Place Details o Find Place, puedes limitar la respuesta para que incluya solo los campos especificados. Los campos de la categoría Basic se incluyen en el costo base de la solicitud a Places y no se generan cargos adicionales. El SKU Basic Data se activa cuando se solicita cualquiera de los campos siguientes:

Android

Place.Field.ADDRESS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.ID, Place.Field.LAT_LNG, Place.Field.NAME, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT o Place.Field.UTC_OFFSET

iOS

GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinesssStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes o 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 o wheelchair_accessible_entrance

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001-500,000 Más de 500,000
Costo de solicitud a Places
+ USD 0.00
Costo de solicitud a Places
+ USD 0.00
Costo de solicitud a Places
+ USD 0.00

SKU: Contact Data

Si usas el parámetro de campos en la solicitud a Place Details o Find Place para servicios web, o un array de 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. El SKU Contact Data se activa cuando se solicita cualquiera de los campos siguientes:

Android

Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER 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

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001-500,000 Más de 500,000
Costo de la solicitud a Places
+ USD 0.003 por cada una
(+ USD 3.00 cada 1,000)
Costo de la solicitud a Places
+ USD 0.0024 por cada una
(+ USD 2.40 cada 1,000)
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas.

SKU: Atmosphere Data

Cuando usas el parámetro de campos en la solicitud a Place Details o Find Place, puedes limitar la respuesta para que incluya solo los campos especificados. Los campos de la categoría Atmosphere generan un cargo adicional. El SKU Atmosphere Data se activa cuando se solicita cualquiera de los campos siguientes:

  • Android: Place.Field.PRICE_LEVEL, Place.Field.RATING o Place.Field.USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating o GMSPlaceFieldUserRatingsTotal
  • JavaScript: Consulta Campos (Place Details)
  • Servicio web: 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 o user_ratings_total.
RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001-500,000 Más de 500,000
Costo de la solicitud a Places
+ USD 0.005 por cada una
(+ USD 5.00 cada 1,000)
Costo de la solicitud a Places
+ USD 0.004 por cada una
(+ USD 4.00 cada 1,000)
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas.

SKU: Autocomplete, por solicitud

Se cobra el SKU Autocomplete, por solicitud por cualquiera de las llamadas o solicitudes que no incluyan un token de sesión:

Las llamadas que se realicen desde una sesión de Autocomplete no válida (por ejemplo, una sesión que reutilice un token de sesión) también se cobran como 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. Esto puede ocurrir si el usuario escribe varias direcciones diferentes, o bien copia y pega diferentes direcciones en el widget y no siempre selecciona una predicción de autocompletar.

RANGO DE VOLUMEN MENSUAL
(precio por SOLICITUD)
0-100,000 100,001-500,000 Más de 500,000
USD 0.00283 por cada una
(USD 2.83 cada 1,000)
USD 0.00227 por cada una
(USD 2.27 cada 1,000)
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas.

SKU: Autocomplete sin Place Details, por sesión

Se cobra un SKU Autocomplete sin Place Details, por sesión por cada sesión de Autocomplete que no incluya una solicitud a Place Details (dentro de los minutos siguientes al inicio de la sesión).

RANGO DE VOLUMEN MENSUAL
(precio por SESIÓN)
0-100,000 100,001-500,000 Más de 500,000
USD 0.017 por cada una
(USD 17.00 cada 1,000)
USD 0.0136 por cada una
(USD 13.60 cada 1,000)
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas.

Ejemplo

Si tu aplicación hace estas dos llamadas en una sola sesión:

Android

iOS

Servicio web

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

  • Autocomplete sin Place Details, por sesión (precio a partir de USD 0.017 por sesión)

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

Se cobra el SKU Autocomplete (incluido con Place Details), por sesión por cada sesión de Autocomplete que incluya lo siguiente:

  • Android: Una llamada a fetchPlace()
  • iOS: Una llamada a fetchPlaceFromPlaceID:
  • Servicio web: Una solicitud a Place Details

La solicitud a Autocomplete está disponible sin cargo, y la llamada posterior a Place Details se cobra según los precios normales de Place Details.

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

Si no se especifica ningún campo, se activarán todos los SKU de Data (Basic, Contact y Atmosphere).

Las solicitudes de actualización del ID de Place Details (solicitudes que especifican solo el campo place_id) durante una sesión de Autocomplete se facturan como SKU: Autocomplete sin Place Details, por sesión.

RANGO DE VOLUMEN MENSUAL
(precio por SESIÓN)
0-100,000 100,001-500,000 Más de 500,000
USD 0.00 USD 0.00 USD 0.00

Ejemplo

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

Android

iOS

Servicio web

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

  • Autocomplete (incluido con Place Details), por sesión (facturado a USD 0.00)
  • Place Details (precio a partir de USD 0.017 por sesión)
  • Basic Data (facturado a USD 0.00)

SKU: Place Details

Las llamadas a Place Details se cobran de la siguiente manera:

RANGO DE VOLUMEN MENSUAL
(Precio por LLAMADA)
0-100,000 100,001-500,000 Más de 500,000
USD 0.017 por cada una
(USD 17.00 cada 1,000)
USD 0.0136 por cada una
(USD 13.60 cada 1,000)
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas.

El SKU de Places Details se genera a partir de estas API:

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

Una solicitud o llamada a Place Details también genera SKU de Data (Basic, Contact o Atmosphere), según los campos que se especifiquen en la llamada o solicitud. Si no se especifica NINGÚN campo en la llamada o la solicitud a Place Details, se activan TODOS los SKU de Data y se te cobra por la llamada o solicitud a Place Details más el costo de todos los datos.

Ejemplos

  1. Realizas una de estas llamadas o solicitudes:
    • Dispositivo móvil: Llamas a fetchPlace() en Android o fetchPlaceFromPlaceID: en iOS y especificas solo el campo ADDRESS.
    • Servicio web o API: Haces una solicitud a Place Details y especificas solo el campo de dirección: getPlaceDetails(fields: formatted_address).
    En tu factura, verás estos SKU (si visualizas tu factura por SKU):
    • Place Details (precio a partir de USD 0.017 por sesión)
    • Basic Data (facturado a USD 0.00)
  2. Realizas una de estas llamadas o solicitudes:
    • Dispositivo móvil: Llamas a fetchPlace() en Android o fetchPlaceFromPlaceID: en iOS y especificas solo el campo PHONE_NUMBER.
    • Servicio web o API: Haces 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 SKU (si visualizas tu factura por SKU):
    • Place Details (precio a partir de USD 0.017 por sesión)
    • Contact Data (precio a partir de USD 0.003 por solicitud)
  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 SKU (si visualizas tu factura por SKU):
    • Place Details (precio a partir de USD 0.017 por sesión)
    • Basic Data (facturado a USD 0.00)
    • Contact Data (precio a partir de USD 0.003 por solicitud)
    • Atmosphere Data (precio a partir de USD 0.005 por solicitud)

SKU: Find Current Place

Find Current Place se cobra por las llamadas a findCurrentPlace() (Android) y a findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001-500,000 Más de 500,000
USD 0.030 por cada una
(USD 30.00 cada 1,000)
USD 0.024 por cada una
(USD 24.00 cada 1,000)
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas.

Las llamadas a findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) también generan SKU de Data (Basic, Contact o Atmosphere), según los campos que se especifiquen en la llamada. Especifica los campos de datos para limitar la respuesta solo a esos campos. Se te factura tanto por la llamada a Find Current Place como por los datos solicitados.

Ejemplos

  1. Haces una solicitud a findCurrentPlace() (Android) o a findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) y especificas solo el campo ADDRESS. En tu factura, verás estos SKU (si visualizas tu factura por SKU):
    • Find Current Place (precio a partir de USD 0.030 por solicitud)
    • Basic Data (facturado a USD 0.00)
  2. Haces una solicitud a findCurrentPlace() (Android) o a findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) y especificas el campo PHONE_NUMBER. En tu factura, verás estos SKU (si visualizas tu factura por SKU):
    • Find Current Place (precio a partir de USD 0.030 por solicitud)
    • Contact Data (precio a partir de USD 0.003 por solicitud)
  3. Haces una solicitud a findCurrentPlace() (Android) o a findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) y especificas campos de los tres segmentos de tipos de datos. En tu factura, verás estos SKU (si visualizas tu factura por SKU):
    • Find Current Place (precio a partir de USD 0.030 por solicitud)
    • Basic Data (facturado a USD 0.00)
    • Contact Data (precio a partir de USD 0.003 por solicitud)
    • Atmosphere Data (precio a partir de USD 0.005 por solicitud)

SKU: Place Photos

Se cobra un SKU Place Photos por lo siguiente:

En el caso del servicio de JavaScript, invocar el método PlacePhoto.getUrl() no genera facturación hasta tanto la URL se use realmente para obtener datos de píxeles.

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001-500,000 Más de 500,000
USD 0.007 por cada una
(USD 7.00 cada 1,000)
USD 0.0056 por cada una
(USD 5.60 cada 1,000)
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas.

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 100 solicitudes por segundo. Se calcula como la suma de las solicitudes de cliente y 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 la sección Restricciones de Licencia de las Condiciones del Servicio de Google Maps Platform.

Cómo administrar el costo de uso

Para administrar el costo de uso de las API de Google Maps Platform, establece límites de cuota diaria en todas las solicitudes a cualquier API facturable. Las cuotas diarias se restablecen a la medianoche, hora del Pacífico.

Si deseas ver o cambiar los límites de cuota del SDK de Places para iOS, haz lo siguiente:

  1. En Cloud Console, abre la página Cuotas de Google Maps Platform.
  2. Haz clic en el menú desplegable de API y selecciona el SDK de Places para iOS.
  3. Para ver los límites de cuota, desplázate hasta la tarjeta Solicitudes.
    En una tabla, se muestran los nombres y los límites de las cuotas.
  4. Para cambiar un límite de cuota, haz clic en el ícono Editar correspondiente.
    En el diálogo que aparece, en el campo Límite de cuota, ingresa el límite de cuota diario facturable que prefieras (hasta el límite de cuota especificado por Google, si corresponde) y haz clic en Guardar.

Si el uso de la API alcanza tu límite de cuota facturable en cualquier momento del día, tu aplicación no podrá acceder a la API durante el resto de ese día.


  1. Los usuarios de India deben crear una cuenta de facturación de Google Cloud Platform antes de crear una de Google Maps Platform para recibir el crédito de Maps Platform.