Detalles de los SKU heredados de Places y Routes

En esta página, se proporcionan detalles de los SKU, los IDs de SKU, los eventos facturables y los activadores de facturación para los SKU de la API de Places heredada, la API de Directions heredada y la API de Distance Matrix heredada. Para conocer las versiones actuales de estos servicios, consulta los detalles del SKU de Places (nuevo) y los detalles del SKU de Routes y Navigation. Para obtener un directorio de todas las categorías de productos, consulta la descripción general de los detalles de uso de la API.

Acerca de las tablas de SKU

En las siguientes secciones, se describen los detalles de cada SKU:

Categoría Indica si el SKU pertenece a la categoría Essentials, Pro o Enterprise.
Evento facturable Es el evento que se factura para el SKU.
Activadores Qué elementos de código activan eventos facturables
Precios Vínculos a la tabla de precios del grupo de ese SKU.

SKUs de productos de Places heredados

Consulta los SKUs de los productos de Places (nuevo) para conocer las versiones más recientes.

Acerca de los SKUs de Places Data

Los tres SKUs de Places Data son Basic Data, Contact Data y Atmosphere Data.

Se activan uno o más SKU de Data en los siguientes casos:

  • Android: Cada solicitud a fetchPlace() o findCurrentPlace()
  • iOS: Cada llamada a fetchPlaceFromPlaceID: o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Servicio web: Cada solicitud a Places, según los campos especificados en ella

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

En el caso del servicio web, estas solicitudes a las APIs de Places te permiten especificar los campos de datos que se devolverán:

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:

[ Essentials: Places Legacy ]

SKU: Autocomplete, por solicitud

  Categoría Essentials
  ID de SKU

7384-2DE4-D388 (global)

2164-BC00-53DC (India)

  API Place Autocomplete (heredado) para Android,
Place Autocomplete (heredado) para iOS,
Place Autocomplete (heredado) para Web
  Evento facturable Solicitud que no incluye un token de sesión
  Activadores
  Ejemplos

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

  Precios Lista de precios (global)
Lista de precios (India)

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

  Categoría Essentials
  ID de SKU

E9C9-934B-DDB1 (global)

  API Place Autocomplete (heredado) para Android,
Place Autocomplete (heredado) para iOS,
Place Autocomplete (heredado) para Web
  Evento facturable Sesión
  Activadores
  • Android: Una llamada a fetchPlace()
  • iOS: Una llamada a fetchPlaceFromPlaceID:
  • Servicio web: Una solicitud a Place Details

Campos de la solicitud:

Asegúrate de especificar los campos que necesitas en la solicitud para evitar cargos innecesarios. Según los campos que especifiques, una solicitud de Place Details también genera estos SKU de datos:

Si no especificas ningún campo en la solicitud de Place Details, se activarán todos los SKUs de datos.

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

Las solicitudes de autocompletado están disponibles sin cargo. Este SKU heredado se factura cuando solicitas Place Details posteriores según los precios normales de Place Details.

En este ejemplo, se ilustra una serie de solicitudes, por plataforma, que darían como resultado los siguientes SKU en tu factura, cuando la visualizas por SKU:

  • Autocomplete (incluido con Place Details), por sesión
  • Place Details
  • Datos básicos

Ejemplo de solicitud por plataforma:

Solicitudes de Android

findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
fetchPlace() (con un FetchPlaceRequest, incluido el ID de lugar y el campo ADDRESS)

Solicitudes de iOS

placesClient?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (incluido el ID de lugar y el campo GMSPlaceFieldFormattedAddress)

Solicitudes de 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)

  Precios Lista de precios (global)
Lista de precios (India)

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

SKU: Basic Data

Es un SKU de datos que factura los campos de Basic Data en una solicitud a Place Details o Find Place.

  Categoría Essentials
  ID de SKU

75D4-C522-326B (global)

5D7B-1F7B-395E (India)

  API Places Details (heredado) con campos básicos
Find Place (heredado) con campos básicos
  Evento facturable Solicitud correcta de campos de Basic Data
  Activadores

Campos para el SDK de Android

Place.Field.ACCESSIBILITY_OPTIONS*
   * Se usa en lugar de Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (obsoleto)
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * Se usa en lugar de Place.Field.NAME (obsoleto)
Place.Field.FORMATTED_ADDRESS*
   * Se usa en lugar de Place.Field.ADDRESS (obsoleto)
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * Se usa en lugar de Place.Field.ICON_URL (obsoleto)
Place.Field.ID
Place.Field.LOCATION*
   * Se usa en lugar de Place.Field.LAT_LNG (obsoleto)
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.TYPES
Place.Field.VIEWPORT
Place.Field.UTC_OFFSET.

Campos para iOS

GMSPlaceFieldFormattedAddress
GMSPlaceFieldBusinessStatus
GMSPlaceFieldID
GMSPlaceFieldCoordinate
GMSPlaceFieldName
GMSPlaceFieldPhotos
GMSPlaceFieldPlusCode
GMSPlaceFieldTypes
GMSPlaceFieldViewport

Campos para el servicio web

address_component
adr_address
business_status
formatted_address
geometry
icon
name
permanently_closed
photo
place_id
plus_code
type
url
utc_offset
vicinity
wheelchair_accessible_entrance

  Facturación de la máscara de campo

Tu solicitud se factura según los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campo solo incluye campos de este SKU, la solicitud se factura según la tarifa de este SKU.
  • Si tu máscara de campo incluye campos de otros SKU, la solicitud se factura con la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y un SKU de Enterprise, la solicitud se facturará según la tarifa del SKU de Enterprise.
  Precios Lista de precios (global)
Lista de precios (India)

SKU: Find Place, solo ID

  Categoría Essentials
  ID de SKU

44A2-D839-A3AC (global)

FE05-60A4-CDDF (India)

  API Servicio web de Places: Find Place
  Evento facturable Solicitud exitosa solo para place_id
  Activadores Solicitud de Find Place sin campos especificados o solo con el campo place_id: FindPlace(fields: place_id).
  Precios Lista de precios (global)
Lista de precios (India)

SKU: Place Details – ID Refresh

  Categoría Essentials
  ID de SKU

2D88-4302-6299 (global)

4604-F56B-7086 (India)

  API Place Details (heredado)
  Evento facturable Solicitud exitosa solo para campos de ID
  Activadores Solicitud con solo el campo de ID de lugar: getPlaceDetails(fields: place_id).
  Precios Lista de precios (global)
Lista de precios (India)

SKU: Query Autocomplete, por solicitud

  Categoría Essentials
  ID de SKU

C4B1-8805-63EF (Global)

59E9-EB83-5CA3 (India)

  API Servicio de Query Autocomplete
  Evento facturable Solicitud correcta
  Activadores

Query Autocomplete no admite el precio por sesión de Autocomplete. Las solicitudes posteriores a Place Details se cobran según el SKU de Place Details Pro.

  Precios Lista de precios (global)
Lista de precios (India)

[ Pro: Places Legacy ]

SKU: Autocomplete sin Place Details, por sesión

  Categoría Pro
  ID de SKU

B52C-8320-6DC5 (global)

C625-D3CE-DF37 (India)

  API Place Autocomplete (heredado) para Android,
Place Autocomplete (heredado) para iOS,
Place Autocomplete (heredado) para Web
  Evento facturable Sesión
  Activadores
  Precios Lista de precios (global)
Lista de precios (India)

SKU: Find Current Place

  Categoría Pro
  ID de SKU

7218-264C-D1D7 (Global)

0862-F46E-1A1A (India)

  API SDK de Places para Android,
SDK de Places para iOS
  Evento facturable Solicitud correcta
  Activadores
  Ejemplos

En los siguientes ejemplos, se muestran los SKU que se te facturan cuando realizas una solicitud de Find Current Place y especificas campos de los SKU de datos Basic, Contact y Atmosphere. Para ver los SKU en tu factura, visualízala por SKU como se describe en Analiza el uso y el costo por SKU.

Haces una solicitud a Find Current Place solo con el campo ADDRESS:

En tu factura, verás estos SKUs:

  • Find Current Place
  • Datos básicos

Haces una solicitud a Find Current Place solo con el campo PHONE_NUMBER:

En tu factura, verás estos SKUs:

  • Find Current Place
  • Contact Data

Realizas una solicitud a Find Current Place con los tres campos de tipo de datos:

En tu factura, verás estos SKUs:

  • Find Current Place
  • Datos básicos
  • Contact Data
  • Atmosphere Data

  Precios Lista de precios (global)
Lista de precios (India)

SKU: Find Place

  Categoría Pro
  ID de SKU

DC67-3188-2294 (Global)

ECB4-087C-9A27 (India)

  API Find Place (heredada)
  Evento facturable Solicitud exitosa para más que solo el campo de ID
  Activadores Solicitud a Find Place con más que solo el campo de ID especificado.
  Ejemplos

En los siguientes ejemplos, se muestran los SKU que se te facturan cuando realizas una solicitud de Find Current Place y especificas campos de los SKU de datos Basic, Contact y Atmosphere. Para ver los SKU en tu factura, visualízala por SKU como se describe en Analiza el uso y el costo por SKU.

Haces una solicitud a Find Place solo con el campo ADDRESS:

En tu factura, verás estos SKUs:

  • Find Current Place
  • Datos básicos

Haces una solicitud a Find Place solo con el campo PHONE_NUMBER:

En tu factura, verás estos SKUs:

  • Find Current Place
  • Contact Data

Haces una solicitud a Find Place con los tres campos de tipo de datos:

En tu factura, verás estos SKUs:

  • Find Current Place
  • Datos básicos
  • Contact Data
  • Atmosphere Data

  Precios Lista de precios (global)
Lista de precios (India)

SKU: Places – Nearby Search

  Categoría Pro
  ID de SKU

6B23-8A17-D29D (global)

CC66-BE0E-2477 (India)

  API Nearby Search (heredada)
  Evento facturable Solicitud exitosa de funciones de Pro
  Activadores

Esta solicitud no admite que se especifiquen los campos que se devuelven. La respuesta devuelve una lista de lugares y un subconjunto de los campos de datos admitidos.

  Ejemplos

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

  • Lugar
  • Datos básicos
  • Contact Data
  • Atmosphere Data
  Precios Lista de precios (global)
Lista de precios (India)

SKU: Places – Text Search

  Categoría Pro
  ID de SKU

E95A-86C7-7F47 (global)

102E-888D-5596 (India)

  API Text Search (heredada)
  Evento facturable Solicitud correcta a Text Search (heredada)
  Activadores

Las solicitudes a Text Search devuelven una lista de lugares, pero no admiten que se especifiquen los campos que se devuelven. Las solicitudes de Text Search devuelven un subconjunto de los campos de datos admitidos. Se te cobra por la solicitud de Text Search, así como por todos los SKUs de tipo de datos: Basic Data, Contact Data y Atmosphere Data.

El SKU: Places – Text Search también se activa con el widget Place SearchBox de la API de Maps JavaScript: el método getPlaces() después de que el usuario selecciona una búsqueda de lugar (ícono: lupa), no un resultado (ícono: pin), como se muestra en la siguiente imagen:

Selección de consultas del widget de cuadro de búsqueda 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 el resultado pizza delivery (pizza a domicilio) tiene un ícono de lupa, lo que indica que se trata de una búsqueda de lugar (y no un resultado).
  Ejemplos

Si realizas una solicitud de Text Search (heredada), en tu factura se mostrarán estos SKU cuando la visualices por SKU:

  • Places - Text Search
  • Datos básicos
  • Contact Data
  • Atmosphere Data
  Precios Lista de precios (global)
Lista de precios (India)

SKU: Places Details

  Categoría Pro
  ID de SKU

FC5C-DF28-543F (global)

F7AA-FEF9-C90E (India)

  API Place Details (heredado)
  Evento facturable Solicitud exitosa de funciones de Pro
  Activadores

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

  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.
    • API o servicio web: Realizas una solicitud a Place Details (versión heredada) 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):
    • Places Details
    • Datos básicos
  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.
    • API o servicio web: Realizas una solicitud a Place Details (versión heredada) 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):
    • Places Details
    • Contact Data
  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 (heredada) 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):
    • Places Details
    • Datos básicos
    • Contact Data
    • Atmosphere Data
  Precios Lista de precios (global)
Lista de precios (India)

[ Enterprise: Places Legacy ]

SKU: Atmosphere Data

Es un SKU de datos que factura los campos de Atmosphere Data en una solicitud de Place Details o Find Place.

  Categoría Empresarial
  ID de SKU

D63D-5CC5-302A (global)

0CE0-1963-137E (India)

  API Places Details (heredado) con campos de Atmosphere
Find Place (heredado) con campos de Atmosphere
  Evento facturable Solicitud exitosa de campos de datos de Atmosphere
  Activadores
  Ejemplos de facturación de máscaras de campo

Tu solicitud se factura según los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campo solo incluye campos de este SKU, la solicitud se factura según la tarifa de este SKU.
  • Si tu máscara de campo incluye campos de otros SKU, la solicitud se factura con la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y un SKU de Enterprise, la solicitud se facturará según la tarifa del SKU de Enterprise.
  Precios Lista de precios (global)
Lista de precios (India)

SKU: Contact Data

Es un SKU de datos que factura los campos de datos de contacto en una solicitud de Place Details o Find Place.

  Categoría Empresarial
  ID de SKU

F095-CD01-81B2 (global)

A03F-5079-C66C (India)

  API Places Details (heredado) con campos de contacto
Find Place (heredado) con campos de contacto
  Evento facturable Solicitud exitosa de campos de datos de contacto
  Activadores

Campos para el SDK de Android

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * Se usa en lugar de Place.Field.PHONE_NUMBER (obsoleto).
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

Campos para el SDK de iOS

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

Campos para el servicio web

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  Facturación de la máscara de campo

Tu solicitud se factura según los campos proporcionados en la máscara de campo. Por ejemplo:

  • Si tu máscara de campo solo incluye campos de este SKU, la solicitud se factura según la tarifa de este SKU.
  • Si tu máscara de campo incluye campos de otros SKU, la solicitud se factura con la tarifa de SKU más alta para los campos solicitados. Por ejemplo, si incluyes campos de un SKU de Essentials y un SKU de Enterprise, la solicitud se facturará según la tarifa del SKU de Enterprise.
  Precios Lista de precios (global)
Lista de precios (India)

SKU: Places Photo

  Categoría Empresarial
  ID de SKU

81E7-85D0-58A7 (global)

9F4B-2E19-1B63 (India)

  API Places Photo (heredado)
  Evento facturable Solicitud correcta de una foto
  Activadores
  • Android: Solicitudes a fetchPhoto()
  • iOS: Solicitudes a loadPlacePhoto:
  • JavaScript: Solicitudes a PlacePhoto.getUrl() para cargar datos de píxeles de imágenes
  • Servicio web: Solicitudes al servicio Place Photos de la API de Places.
  Precios Lista de precios (global)
Lista de precios (India)

SKUs de la API de Routes heredada

[ Essentials: Routes Legacy ]

SKU: Directions

  Categoría Essentials
  ID de SKU

28A8-3EB4-4595 (global)

4714-291C-3199 (India)

  API Servicio Directions de la API de Maps JavaScript,
API de Directions (heredada)
  Evento facturable Solicitud exitosa sin funciones de Pro ni Enterprise
  Activadores Consultas que no activan un SKU con una calificación más alta
  Precios Lista de precios (global)
Lista de precios (India)

SKU: Distance Matrix

  Categoría Essentials
  ID de SKU

C1B6-FF9D-7700 (Global)

558A-4F88-F361 (India)

  API API de Distance Matrix (heredada),
Servicio de Distance Matrix de la API de Maps JavaScript
  Evento facturable Cada elemento que no contiene funciones de Pro o Enterprise. Cada solicitud enviada a la API de Distance Matrix genera elementos: la cantidad de origins multiplicada por la cantidad de destinations es igual a la cantidad de elementos que se generan.
  Activadores Solicitudes de elementos que no activan SKU de mayor precio
  Precios Lista de precios (global)
Lista de precios (India)

[ Pro: Routes Legacy ]

SKU: Directions Advanced

  Categoría Pro
  ID de SKU

9407-00C2-CF85 (global)

E27B-BD57-FD7D (India)

  API Servicio Directions de la API de Maps JavaScript,
API de Directions (heredada)
  Evento facturable Solicitud exitosa con funciones Pro
  Activadores
  Precios Lista de precios (global)
Lista de precios (India)

SKU: Distance Matrix Advanced

  Categoría Pro
  ID de SKU

DFAE-763F-CF6E (global)

C0F4-32AE-F6D1 (India)

  API API de Distance Matrix (heredada),
Servicio de Distance Matrix de la API de Maps JavaScript
  Evento facturable Cada elemento se devolvió con funciones de Pro. Cada solicitud enviada a la API de Distance Matrix genera elementos: la cantidad de origins multiplicada por la cantidad de destinations es igual a la cantidad de elementos que se generan.
  Activadores
  Precios Lista de precios (global)
Lista de precios (India)