Error: 9005 PLACES_API_RATE_LIMIT_EXCEEDED
El SDK de Places para Android usa un modelo de precios de pago por uso. Las solicitudes del SDK de Places para Android se facturan por SKU. Además de las Condiciones de Uso generales de Google, existen límites de uso específicos del SDK de Places para Android. Administra los costos y el uso con las herramientas disponibles en la consola de Google Cloud.
Cómo se factura el SDK de Places para Android
El SDK de Places para Android (nuevo) y el SDK de Places para Android usan un modelo de precios de pago por uso. Las APIs y los SDKs de Google Maps Platform se facturan por SKU. Se realiza un seguimiento del uso de cada SKU, y cada API o SDK puede tener más de un SKU de producto. El costo se calcula de la siguiente manera:
Usa nuestra Calculadora de precios y uso para estimar el costo del uso por API o SDK. En el caso de los SKUs de Google Maps Platform aptos, hay disponible un crédito mensual de USD 200 en Google Maps Platform para cada cuenta de facturación. Este crédito se aplica automáticamente a los SKUs aptos.
Precios del SDK de Places para Android (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 validación de direcciones.
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
Se cobra un SKU Autocomplete Requests por cada solicitud a la API de Autocomplete (nueva) que no incluya un token de sesión.
También se cobra si usas tokens de sesión y realizas alguna de las siguientes acciones:
- Finaliza las sesiones con una sola solicitud a Place Details (New) que solicite cualquier campo definido por el SKU: Place Details (Location Only).
- Cada solicitud de Autocomplete (nuevo), hasta 12 solicitudes, se factura con el SKU: Autocomplete Requests.
- Cada solicitud de Autocomplete (nueva) subsiguiente se factura con el SKU: Uso de la sesión de Autocomplete.
- Abandona la sesión o finalízala haciendo una llamada al SKU: Place Details (solo IDs). Luego, todas las solicitudes de Autocomplete (nuevas) se facturan con el SKU: Solicitudes de Autocomplete.
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
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: Uso de la sesión de Autocomplete
Se cobra un SKU Autocomplete Session Usage por cada solicitud a la API de Autocomplete (nueva) que incluya un token de sesión.
Este SKU se cobra en los siguientes casos:
Se cerró la sesión de Autocomplete con una llamada al SKU: Place Details (Location Only):
- Cada solicitud de Autocomplete (nuevo), hasta 12 solicitudes, se factura con el SKU: Autocomplete Requests.
- Cada solicitud de Autocomplete (nueva) subsiguiente se factura con el SKU: Uso de la sesión de Autocomplete.
La sesión de Autocomplete finalizó con una llamada a SKU: Place Details (Basic, Advanced, or Preferred).
Una llamada a Place Details que solicite cualquier campo del SKU: Place Details (Basic, Advanced o Preferred) se factura en el SKU: Place Details (Preferred).
La sesión de Autocomplete finalizó con una llamada a SKU: Address Validation Preferred.
Para obtener más información, consulta Autocomplete (nuevo) y precios de la sesión.
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.00 por cada una (USD 0.00 cada 1,000) |
USD 0.00 por cada una (USD 0.00 cada 1,000) |
USD 0.00 por cada una (USD 0.00 cada 1,000) |
SKU: Place Details (solo IDs)
Si utilizas una máscara de campo o una lista de campos en tu solicitud de Place Details (New), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:
Android:
Place.Field.DISPLAY_NAME
,
Place.Field.ID
,
Place.Field.PHOTO_METADATAS
,
Place.Field.RESOURCE_NAME
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.0 por cada una (USD 0.00 cada 1,000) |
USD 0.0 por cada una (USD 0.00 cada 1,000) |
USD 0.0 por cada una (USD 0.00 cada 1,000) |
SKU: Place Details (Location Only)
Si utilizas una máscara de campo o una lista de campos en tu solicitud de Place Details (New), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:
Android:
Place.Field.ADDRESS_COMPONENTS
,
ADR_FORMAT_ADDRESS
,
Place.Field.FORMATTED_ADDRESS
,
Place.Field.LOCATION
,
Place.Field.PLUS_CODE
,
Place.Field.SHORT_FORMATTED_ADDRESS
,
Place.Field.TYPES
,
Place.Field.VIEWPORT
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.005 por cada una (USD 5.00 cada 1,000) |
USD 0.004 por cada uno (USD 4.00 cada 1,000) |
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas. |
SKU: Place Details (Basic)
Si utilizas una máscara de campo o una lista de campos en tu solicitud de Place Details (New), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:
Android:
Place.Field.ACCESSIBILITY_OPTIONS
,
Place.Field.BUSINESS_STATUS
,
Place.Field.GOOGLE_MAPS_URI
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_MASK_URL
,
Place.Field.PRIMARY_TYPE
,
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
,
Place.Field.SUB_DESTINATIONS
,
Place.Field.UTC_OFFSET
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.0170 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. |
SKU: Place Details (Advanced)
Si utilizas una máscara de campo o una lista de campos en tu solicitud de Place Details (New), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
,
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.020 por cada una (USD 20.00 cada 1,000) |
USD 0.016 por cada una (USD 16.00 cada 1,000) |
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas. |
SKU: Place Details (Preferred)
Si utilizas una máscara de campo o una lista de campos en tu solicitud de Place Details (New), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:
Android:
Place.Field.ALLOWS_DOGS
,
Place.Field.CURBSIDE_PICKUP
,
Place.Field.DELIVERY
,
Place.Field.DINE_IN
,
Place.Field.EDITORIAL_SUMMARY
,
Place.Field.EV_CHARGE_OPTIONS
,
Place.Field.FUEL_OPTIONS
,
Place.Field.GOOD_FOR_CHILDREN
,
Place.Field.GOOD_FOR_GROUPS
,
Place.Field.GOOD_FOR_WATCHING_SPORTS
,
Place.Field.LIVE_MUSIC
,
Place.Field.MENU_FOR_CHILDREN
,
Place.Field.OUTDOOR_SEATING
,
Place.Field.PARKING_OPTIONS
,
Place.Field.PAYMENT_OPTIONS
,
Place.Field.RESERVABLE
,
Place.Field.RESTROOM
,
Place.Field.REVIEWS
,
Place.Field.SERVES_BEER
,
Place.Field.SERVES_BREAKFAST
,
Place.Field.SERVES_BRUNCH
,
Place.Field.SERVES_COCKTAILS
,
Place.Field.SERVES_COFFEE
,
Place.Field.SERVES_DESSERT
,
Place.Field.SERVES_DINNER
,
Place.Field.SERVES_LUNCH
,
Place.Field.SERVES_VEGETARIAN_FOOD
,
Place.Field.SERVES_WINE
,
Place.Field.TAKEOUT
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.025 por cada una (USD 25.00 cada 1,000) |
USD 0.020 por cada una (USD 20.00 cada 1,000) |
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas. |
SKU: Nearby Search (Basic)
Si utilizas una máscara de campo o una lista de campos en tu solicitud de Nearby Search (nuevo), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:
Android:
Place.Field.ADDRESS_COMPONENTS
,
Place.Field.BUSINESS_STATUS
,
Place.Field.ADDRESS
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_URL
,
Place.Field.LAT_LNG
,
Place.Field.PHOTO_METADATAS
,
Place.Field.PLUS_CODE
,
Place.Field.PRIMARY_TYPE
,
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
,
Place.Field.ID
,
Place.Field.NAME
,
Place.Field.TYPES
,
Place.Field.UTC_OFFSET
,
Place.Field.VIEWPORT
,
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.032 por cada una (USD 32.00 cada 1,000) |
USD 0.0256 por cada una (USD 25.60 cada 1,000) |
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas. |
SKU: Nearby Search (Advanced)
Si utilizas una máscara de campo o una lista de campos en tu solicitud de Nearby Search (nuevo), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
,
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.035 por cada una (USD 35.00 cada 1,000) |
USD 0.028 por cada una (USD 28.00 cada 1,000) |
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas. |
SKU: Nearby Search (Preferred)
Si utilizas una máscara de campo o una lista de campos en tu solicitud de Nearby Search (nuevo), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:
Android:
Place.Field.ALLOWS_DOGS
,
Place.Field.CURBSIDE_PICKUP
,
Place.Field.DELIVERY
,
Place.Field.DINE_IN
,
Place.Field.EDITORIAL_SUMMARY
,
Place.Field.EV_CHARGE_OPTIONS
,
Place.Field.FUEL_OPTIONS
,
Place.Field.GOOD_FOR_CHILDREN
,
Place.Field.GOOD_FOR_GROUPS
,
Place.Field.GOOD_FOR_WATCHING_SPORTS
,
Place.Field.LIVE_MUSIC
,
Place.Field.MENU_FOR_CHILDREN
,
Place.Field.OUTDOOR_SEATING
,
Place.Field.PARKING_OPTIONS
,
Place.Field.PAYMENT_OPTIONS
,
Place.Field.RESERVABLE
,
Place.Field.RESTROOM
,
Place.Field.REVIEWS
,
Place.Field.SERVES_BEER
,
Place.Field.SERVES_BREAKFAST
,
Place.Field.SERVES_BRUNCH
,
Place.Field.SERVES_COCKTAILS
,
Place.Field.SERVES_COFFEE
,
Place.Field.SERVES_DESSERT
,
Place.Field.SERVES_DINNER
,
Place.Field.SERVES_LUNCH
,
Place.Field.SERVES_VEGETARIAN_FOOD
,
Place.Field.SERVES_WINE
,
Place.Field.TAKEOUT
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.040 por cada una (USD 40.00 cada 1,000) |
USD 0.032 por cada una (USD 32.00 cada 1,000) |
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas. |
SKU: Text Search (solo ID)
Si utilizas una máscara de campo o una lista de campos en tu solicitud de Text Search (nuevo), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:
Android:
Place.Field.DISPLAY_NAME
,
Place.Field.ID
,
Place.Field.RESOURCE_NAME
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.0 por cada una (USD 0.00 cada 1,000) |
USD 0.0 por cada una (USD 0.00 cada 1,000) |
USD 0.0 por cada una (USD 0.00 cada 1,000) |
SKU: Text Search (Basic)
Si utilizas una máscara de campo o una lista de campos en tu solicitud de Text Search (nuevo), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:
Android:
Place.Field.ACCESSIBILITY_OPTIONS
,
Place.Field.ADDRESS_COMPONENTS
,
Place.Field.ADR_FORMAT_ADDRESS
,
Place.Field.BUSINESS_STATUS
,
Place.Field.FORMATTED_ADDRESS
,
Place.Field.GOOGLE_MAPS_URI
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_MASK_URL
,
Place.Field.LOCATION
,
Place.Field.PHOTO_METADATAS
,
Place.Field.PLUS_CODE
,
Place.Field.PRIMARY_TYPE
,
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
,
Place.Field.SHORT_FORMATTED_ADDRESS
,
Place.Field.SUB_DESTINATIONS
,
Place.Field.TYPES
,
Place.Field.UTC_OFFSET
,
Place.Field.VIEWPORT
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.032 por cada una (USD 32.00 cada 1,000) |
USD 0.0256 por cada una (USD 25.60 cada 1,000) |
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas. |
SKU: Text Search (Advanced)
Si utilizas una máscara de campo o una lista de campos en tu solicitud de Text Search (nuevo), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
,
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.035 por cada una (USD 35.00 cada 1,000) |
USD 0.028 por cada una (USD 28.00 cada 1,000) |
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas. |
SKU: Text Search (Preferred)
Si utilizas una máscara de campo o una lista de campos en tu solicitud de Text Search (nuevo), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:
Android:
Place.Field.ALLOWS_DOGS
,
Place.Field.CURBSIDE_PICKUP
,
Place.Field.DELIVERY
,
Place.Field.DINE_IN
,
Place.Field.EDITORIAL_SUMMARY
,
Place.Field.EV_CHARGE_OPTIONS
,
Place.Field.FUEL_OPTIONS
,
Place.Field.GOOD_FOR_CHILDREN
,
Place.Field.GOOD_FOR_GROUPS
,
Place.Field.GOOD_FOR_WATCHING_SPORTS
,
Place.Field.LIVE_MUSIC
,
Place.Field.MENU_FOR_CHILDREN
,
Place.Field.OUTDOOR_SEATING
,
Place.Field.PARKING_OPTIONS
,
Place.Field.PAYMENT_OPTIONS
,
Place.Field.RESERVABLE
,
Place.Field.RESTROOM
,
Place.Field.REVIEWS
,
Place.Field.SERVES_BEER
,
Place.Field.SERVES_BREAKFAST
,
Place.Field.SERVES_BRUNCH
,
Place.Field.SERVES_COCKTAILS
,
Place.Field.SERVES_COFFEE
,
Place.Field.SERVES_DESSERT
,
Place.Field.SERVES_DINNER
,
Place.Field.SERVES_LUNCH
,
Place.Field.SERVES_VEGETARIAN_FOOD
,
Place.Field.SERVES_WINE
,
Place.Field.TAKEOUT
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
USD 0.040 por cada una (USD 40.00 cada 1,000) |
USD 0.032 por cada una (USD 32.00 cada 1,000) |
Para obtener información sobre los precios por volumen, comunícate con el equipo de Ventas. |
SKU: Place Photos
Se cobra un SKU Place Photo por cada solicitud a la API.
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
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. |
Precios del SDK de Places para Android
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 APIs:
- 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 SKUs de Data en los siguientes casos:
- Android: Cada solicitud a
fetchPlace()
ofindCurrentPlace()
- iOS: Cada llamada a
fetchPlaceFromPlaceID:
ofindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- 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
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.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
oPlace.Field.UTC_OFFSET
. -
iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinessStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
oGMSPlaceFieldViewport
-
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
owheelchair_accessible_entrance
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
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 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. El SKU Contact Data se activa cuando se solicita cualquiera de los campos siguientes:
-
Android:
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.INTERNATIONAL_PHONE_NUMBER
,Place.Field.OPENING_HOURS
,Place.Field.SECONDARY_OPENING_HOURS
oPlace.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
oGMSPlaceFieldWebsite
-
Servicio web:
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
owebsite
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
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.CURBSIDE_PICKUP
,Place.Field.DELIVERY
,Place.Field.EDITORIAL_SUMMARY
,Place.Field.DINE_IN
,Place.Field.PRICE_LEVEL
,Place.Field.RATING
,Place.Field.RESERVABLE
,Place.Field.SERVES_BEER
,Place.Field.SERVES_BREAKFAST
,Place.Field.SERVES_BRUNCH
,Place.Field.SERVES_DINNER
,Place.Field.SERVES_LUNCH
,Place.Field.SERVES_VEGETARIAN_FOOD
,Place.Field.SERVES_WINE
,Place.Field.TAKEOUT
oPlace.Field.USER_RATING_COUNT
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
oGMSPlaceFieldServesVegetarianFood
- 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
ouser_ratings_total
RANGO DE VOLUMEN MENSUAL (precio por LLAMADA) |
||
---|---|---|
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:
- 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
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 si copia diferentes direcciones y las pega en el widget y no siempre selecciona una predicción de autocompletar.
RANGO DE VOLUMEN MENSUAL (precio por SOLICITUD) |
||
---|---|---|
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) |
||
---|---|---|
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
- 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)
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 SKUs 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 SKUs 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) |
||
---|---|---|
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
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (con un
FetchPlaceRequest
, incluido el ID de lugar 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
- Solicitud de Place Autocomplete (input="par", session_token: XYZ)
- Solicitud de Place Autocomplete (input="paris", session_token: XYZ)
- Solicitud de Place 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 (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) |
||
---|---|---|
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:
- 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 del cuadro de búsqueda de lugares de la API de Maps JavaScript. Se usa el método
getPlaces()
después de que el usuario selecciona un resultado de lugar (ícono: pin), *no* una búsqueda (ícono: lupa), tal como puede verse aquí: - 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 se proporciona o no un token de sesión.
Una solicitud o llamada a Place Details también genera SKUs 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 SKUs de Data y se te cobra por la llamada o solicitud a Place Details más el costo de todos los datos.
Ejemplos
- Realizas una de estas llamadas o solicitudes:
- Dispositivo móvil: Llamas a
fetchPlace()
en Android ofetchPlaceFromPlaceID:
en iOS y especificas solo el campoADDRESS
. - Servicio web o API: Haces una solicitud a Place Details y especificas solo el campo de dirección:
getPlaceDetails(fields: formatted_address)
.
- Place Details (precio a partir de USD 0.017 por sesión)
- Basic Data (facturado a USD 0.00)
- Dispositivo móvil: Llamas a
- Realizas una de estas llamadas o solicitudes:
- Dispositivo móvil: Llamas a
fetchPlace()
en Android ofetchPlaceFromPlaceID:
en iOS y especificas solo el campoPHONE_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)
.
- Place Details (precio a partir de USD 0.017 por sesión)
- Contact Data (precio a partir de USD 0.003 por solicitud)
- Dispositivo móvil: Llamas a
- Realizas una de estas llamadas o solicitudes:
- Dispositivo móvil: Llamas a
fetchPlace()
en Android o afetchPlaceFromPlaceID:
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()
.
- 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)
- Dispositivo móvil: Llamas a
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) |
||
---|---|---|
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 SKUs 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
- Haces una solicitud a
findCurrentPlace()
(Android) o afindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) y especificas solo el campoADDRESS
. En tu factura, verás estos SKUs (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)
- Haces una solicitud a
findCurrentPlace()
(Android) o afindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) y especificas el campoPHONE_NUMBER
. En tu factura, verás estos SKUs (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)
- Haces una llamada a
findCurrentPlace()
(Android) o afindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) y especificas campos de los tres segmentos de tipos de datos. En tu factura, verás estos SKUs (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:
- 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 devueltas por
PlacePhoto.getUrl()
para cargar datos de píxeles de imágenes - Servicio web: Solicitudes al servicio Place Photos de la API de Places
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) |
||
---|---|---|
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. |
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.
Cómo administrar el costo de uso
Para administrar el costo de uso del SDK de Places para Android o satisfacer las demandas del tráfico de producción, establece límites en la cuota diaria en todas las solicitudes a cualquier API. Las cuotas diarias se restablecen a la medianoche, hora del Pacífico.
Para ver o cambiar los límites de cuota del SDK de Places para Android, sigue estos pasos:
- En Cloud Console, abre la página Cuotas de Google Maps Platform.
- Haz clic en el menú desplegable de APIs y selecciona el SDK de Places para Android.
- 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 cuota. - 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 diaria facturable de tu preferencia (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.