Uso y facturación de la API de Places

La API de Places (nueva) y la API de Places usan un modelo de precios de pago por uso. Las solicitudes a la API de Places (nuevo) y a la API de Places generan llamadas a cualquiera de los varios SKU. Además de las Condiciones de Uso generales de Google, existen límites de uso específicos de la API de Places. Administra los costos y el uso con las herramientas disponibles en la consola de Google Cloud.

Cómo se factura la API de Places

La API de Places (versión nueva) y la API de Places 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:

Uso del SKU × Precio por uso

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. que se aplica automáticamente1 a los SKU aptos de esa plataforma.

Precios de la API de Places (nuevo)

Acerca de las máscaras de campo

Para Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo), utiliza el encabezado FieldMask en las solicitudes a la API para especificar la lista de campos que se deben devolver como respuesta. Luego, se te facturará según el SKU más alto que corresponda a tu solicitud. Eso significa que si seleccionas campos del SKU (Basic) y del SKU (Advanced), se te facturará en función del SKU (Advanced).

El uso de campos enmascarados es una práctica de diseño recomendada para garantizar que no solicites datos innecesarios, lo que ayuda a evitar tiempos de procesamiento y cargos de facturación adicionales.

Información sobre las sesiones de Autocomplete (nuevo)

Una sesión de Autocomplete (nuevo) incluye una o más solicitudes a Autocomplete (nuevas), y, como máximo, una solicitud a Place Details (nuevo) o una solicitud de Address Validation. El mismo token de sesión se pasa a la solicitud de Autocomplete (nuevo) y a la solicitud posterior de Place Details (nuevo) o la solicitud de Address Validation.

Una sesión comienza con la primera solicitud de Autocomplete (nuevo). Luego, se realiza una solicitud de Place Details (nuevo) o de Address Validation cuando el usuario selecciona una de las sugerencias de Autocomplete (nuevas). Si se abandona una sesión, lo que significa que no se realiza ninguna solicitud de Place Details (New) ni de Address Validation, las solicitudes de Autocomplete (nuevo) se cobran como si no se hubiera proporcionado un token de sesión.

Después de que un usuario selecciona un lugar (es decir, que se realiza una solicitud de Place Details (nuevo) o de Address Validation), debes iniciar una sesión nueva con un token de sesión nuevo.

Un token de sesión es válido para una sesión y no se puede usar en 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 de Autocomplete

Se cobra un SKU Autocomplete solicitudes por cada solicitud a la API de Autocomplete (nuevo) que no incluya un token de sesión.

También se cobra si usas tokens de sesión y se cumple alguna de estas condiciones:

  • Finaliza las sesiones con una sola solicitud a Place Details (nuevo) que solicite cualquier campo definido por SKU: Place Details (solo ubicación).
    • Cada solicitud de Autocomplete (nuevo), hasta 12 solicitudes, se factura con el código SKU: solicitudes de Autocomplete.
    • Cada solicitud posterior de Autocomplete (nuevo) se factura con el código SKU: Autocomplete Session Usage.
  • Abandona o finaliza la sesión mediante una llamada al SKU: Place Details (solo IDs). Todas las solicitudes de Autocomplete (nuevo) se facturan con el código SKU: solicitudes de Autocomplete.
RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
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 Session Usage

Se cobra un SKU Autocomplete Session Usage por cada solicitud a la API de Autocomplete (nuevo) que incluya un token de sesión.

Este SKU se cobra en dos situaciones:

  • La sesión de Autocomplete finaliza con una llamada a SKU: Place Details (solo ubicación):

    • Cada solicitud de Autocomplete (nuevo), hasta 12 solicitudes, se factura con el código SKU: solicitudes de Autocomplete.
    • Cada solicitud posterior de Autocomplete (nuevo) se factura con el código SKU: Autocomplete Session Usage.
  • La sesión de Autocomplete finalizó con una llamada a SKU: Place Details (Basic, Advanced o Preferred) o a SKU: Address Validation Preferred.

    Una llamada a Place Details que solicita cualquier campo del SKU: Place Details (Basic, Advanced o Preferred) se factura a través del SKU: Place Details (Preferred). Para obtener más información, consulta Autocompletar (nuevo) y precios de sesión.

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,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)
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:

Servicio web: id, name*, photos

* El campo name contiene el nombre de recurso del lugar con el siguiente formato: places/PLACE_ID. Utiliza displayName para acceder al nombre del lugar en forma de texto.

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,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)
USD 0.0 por cada una
(USD 0.00 cada 1,000)

SKU: Place Details (solo ubicación)

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:

Servicio web: addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types y viewport

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,000
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:

Servicio web: accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations y utcOffsetMinutes

Si una llamada a Place Details finaliza una sesión de Autocomplete que solicita cualquier campo de 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.

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,000
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:

Servicio web: currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount y websiteUri

Si una llamada a Place Details finaliza una sesión de Autocomplete que solicita cualquier campo de 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.

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,000
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:

allowsDogscurbsidePickupdeliverydineIneditorialSummaryevChargeOptionsfuelOptionsgoodForChildrengoodForGroupsgoodForWatchingSportsliveMusicmenuForChildrenparkingOptionspaymentOptionsoutdoorSeatingreservablerestroomreviewsservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertsservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

Si una llamada a Place Details finaliza una sesión de Autocomplete que solicita cualquier campo de 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.

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,000
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 Place Details (New), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:

Servicio web: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.displayName, places.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.id, places.location, places.name*, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

* El campo places.name contiene el nombre de recurso del lugar con el siguiente formato: places/PLACE_ID. Utiliza places.displayName para acceder al nombre del lugar en forma de texto.

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,000
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 Place Details (New), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:

Servicio web: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount y places.websiteUri

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,000
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 Place Details (New), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:

places.allowsDogsplaces.curbsidePickupplaces.deliveryplaces.dineInplaces.editorialSummaryplaces.evChargeOptionsplaces.fuelOptionsplaces.goodForChildrenplaces.goodForGroupsplaces.goodForWatchingSportsplaces.liveMusicplaces.menuForChildrenplaces.parkingOptionsplaces.paymentOptionsplaces.outdoorSeatingplaces.reservableplaces.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,000
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 Place Details (New), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:

Servicio web: places.id, places.name*

* El campo places.name contiene el nombre de recurso del lugar con el siguiente formato: places/PLACE_ID. Utiliza places.displayName para acceder al nombre del lugar en forma de texto.

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,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)
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 Place Details (New), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:

Servicio web: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.displayName, places.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes. places.utcOffsetMinutesplaces.viewport

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,000
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 Place Details (New), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:

Servicio web: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount y places.websiteUri

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,000
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 Place Details (New), puedes limitar la respuesta solo a los campos especificados. Este SKU se activa cuando solicitas únicamente los siguientes campos:

places.allowsDogsplaces.curbsidePickupplaces.deliveryplaces.dineInplaces.editorialSummaryplaces.evChargeOptionsplaces.fuelOptionsplaces.goodForChildrenplaces.goodForGroupsplaces.goodForWatchingSportsplaces.liveMusicplaces.menuForChildrenplaces.parkingOptionsplaces.paymentOptionsplaces.outdoorSeatingplaces.reservableplaces.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,000
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)
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.

Precios de la API de Places

Información sobre las sesiones de Autocomplete

Una sesión de Autocomplete incluye algunas solicitudes a Autocomplete (para recuperar sugerencias de un lugar a medida que el usuario escribe) y, como máximo, una solicitud a Place Details (para recuperar detalles sobre el lugar seleccionado por el usuario). El mismo token de sesión se pasa a la solicitud de Autocomplete y a la solicitud subsiguiente de Place Details. Una sesión comienza con la primera solicitud a Autocomplete (que generalmente ocurre cuando el usuario comienza a escribir). Se realiza una llamada a Place Details cuando el usuario selecciona una de las sugerencias de Autocomplete. Si no selecciona ninguna de las sugerencias, no se realiza ninguna llamada a Place Details.

Después de que un usuario selecciona un lugar (es decir, 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:

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() o findCurrentPlace()
  • iOS: Cada llamada a fetchPlaceFromPlaceID: o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Servicio web: Cada solicitud a Places, según los campos especificados en ella

Los SKUs de Data siempre se cobran además del SKU básico de la solicitud que los activa. Por ejemplo, una solicitud a Place Details que incluya campos de Basic Data se cobra tanto en el SKU de Basic Data como en el SKU de Place Details.

En el caso del servicio web, estas llamadas a las APIs de Places admiten que se especifiquen los campos de datos para devolver:

Para el servicio web, estas llamadas a las APIs de Places NO admiten que se especifiquen los campos que se devuelven. Estas llamadas siempre devuelven todos los datos de Places y se cobran los tres SKUs de Places Data además del cargo por cada solicitud a la API:


SKU: Basic Data

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 siguientes campos:

  • 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, Place.Field.UTC_OFFSET o Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus, 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 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 siguientes campos:

  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.SECONDARY_OPENING_HOURS o Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber o GMSPlaceFieldWebsite
  • Servicio web: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours o website
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 siguientes campos:

  • Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.EDITORIAL_SUMMARY, Place.Field.DINE_IN, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.RESERVABLE, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT o Place.Field.USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable, GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch o GMSPlaceFieldServesVegetarianFood
  • 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 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)
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 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)
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 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: Query Autocomplete, por solicitud

Se cobra un SKU Query Autocomplete, por solicitud por cada solicitud a lo siguiente:

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.

Query Autocomplete no admite el precio por sesión de Autocomplete. Las llamadas subsiguientes a Place Details se cobran según los precios normales de Places Details.


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

  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 SKUs (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 SKUs (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 SKUs (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: Place Details – ID Refresh

Utiliza la solicitud a Place Details para actualizar los IDs de lugares inactivos. Estos tipos de solicitudes están disponibles sin cargo.

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

Ejemplo

Haces una solicitud a Place Details y especificas solo el campo de ID del lugar: getPlaceDetails(fields: place_id). En tu factura, verás este SKU (si visualizas tu factura por SKU):

  • Places Details -ID Refresh (facturado a USD 0.00)

SKU: Find Place

El uso se cobra por cada solicitud a Find Place.

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.

Una solicitud a Find Place también genera SKU de Data (Basic, Contact o Atmosphere), según los campos que se especifiquen en la solicitud. Al igual que sucede con las solicitudes a Place Details, puedes usar el parámetro de campos en la solicitud de Find Place para limitar la respuesta solo a los campos especificados. Se te factura tanto por la solicitud a Find Place como por los datos solicitados. De manera predeterminada, si NO se solicita ningún campo, solo se muestra el ID del lugar, por lo que no se generan cargos de datos adicionales.

Ejemplos

  1. Haces una solicitud a Find Place y especificas solo el campo de dirección: FindPlace(fields: formatted_address). En tu factura, verás estos SKUs (si visualizas tu factura por SKU):
    • Find Place (precio a partir de USD 0.017 por llamada)
    • Basic Data (facturado a USD 0.00)
  2. Haces una solicitud a Find Place y especificas el campo de número de teléfono: FindPlace(fields: formatted_phone_number). En tu factura, verás estos SKUs (si visualizas tu factura por SKU):
    • Find Place (precio a partir de USD 0.017 por llamada)
    • Contact Data (precio a partir de USD 0.003 por solicitud)
  3. Haces una solicitud a Find Place y especificas campos de los tres segmentos de tipos de datos: FindPlace(fields: formatted_address, opening_hours, price_level). En tu factura, verás estos SKUs (si visualizas tu factura por SKU):
    • Find Place (precio a partir de USD 0.017 por llamada)
    • 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 Place, solo ID

Se cobra Find Place, solo ID por cada solicitud a Find Place que especifique que solo se muestre el ID del lugar. De manera predeterminada, si no se especifican campos en la solicitud a Find Place, solo se devuelve el ID del lugar.

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

Ejemplo

Haces una solicitud a Find Place y especificas solo el campo place_id: FindPlace(fields: place_id). En tu factura, verás este SKU (si visualizas tu factura por SKU):

  • Find Place, solo ID (facturado a USD 0.00)

Se cobra Place – Nearby Search por las solicitudes que se hagan al servicio Place Nearby Search de la API de Maps JavaScript (nearbySearch()) o al servicio Nearby Search de la API de Places.

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,000
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.

Las solicitudes a Nearby Search muestran una lista de lugares, pero no admiten que se especifiquen los campos que se muestran. Estas solicitudes muestran un subconjunto de los campos de datos admitidos. Se te cobra por cada solicitud a Nearby Search a partir de USD 0.032 por cada una, así como por todos los SKUs de tipo de datos (Basic Data, Contact Data y Atmosphere Data).

Ejemplo

Haces una solicitud a Nearby Search, como NearbySearch (San Francisco, 100 meters). En tu factura, verás estos SKUs (si visualizas tu factura por SKU):

  • Places - Nearby Search (precio a partir de USD 0.032 por llamada)
  • 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)

Se cobra Place – Text Search por las solicitudes que se hagan al servicio Place Text Search de la API de Maps JavaScript (textSearch()) o al servicio Text Search de la API de Places.

RANGO DE VOLUMEN MENSUAL
(precio por LLAMADA)
0-100,000 100,001–500,000 Más de 500,000
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.

Las solicitudes a Text Search devuelven una lista de lugares, pero no admiten que se especifiquen los campos que se devuelven. Estas solicitudes devuelven un subconjunto de los campos de datos admitidos. Por cada solicitud a Text Search, se te cobra a partir de USD 0.032, así como por todos los SKUs de tipo de datos (Basic Data, Contact Data y Atmosphere Data).

El SKU de Places – Text Search también se genera a través del 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 una búsqueda de lugar (ícono: lupa), no un resultado (ícono: pin), como se muestra en la siguiente imagen:

Selección de búsquedas del widget SearchBox de Place Details
En los resultados del widget del cuadro de búsqueda, después de escribir "pizza" en el cuadro de búsqueda, observa que pizza a domicilio tiene un ícono de lupa junto a él, lo que indica que es una consulta de lugar (y no un resultado).

Ejemplo

Haces una solicitud a Text Search, tal como TextSearch(123 Main Street). En tu factura, verás estos SKUs (si visualizas tu factura por SKU):

  • Places - Text Search (precio a partir de USD 0.032 por llamada)
  • 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 aplican los siguientes límites de uso:

  • API de Places (nuevo): El límite de frecuencia es de 600 QPM (solicitudes por minuto) por método de API y por proyecto. Es decir, cada método de API tiene una cuota independiente.

  • API de Places: El límite de frecuencia es de 6,000 QPM (solicitudes por minuto). Se calcula como la suma de las solicitudes del cliente y del servidor para todas las aplicaciones que usan las credenciales del mismo proyecto.

Restricciones de las Condiciones de Uso

Para obtener información sobre las Condiciones de Uso, consulta las políticas de la API de Places y el artículo sobre las 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 la API de Places 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 de la API de Places:

  1. En Cloud Console, abre la página Cuotas de Google Maps Platform.
  2. Haz clic en el menú desplegable de APIs y selecciona API de Places.
  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 cuota.
  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 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.


  1. Los usuarios ubicados en la 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 relacionado.