Detalhes das SKUs legadas do Places e do Routes

Esta página mostra detalhes, IDs, eventos faturáveis e acionadores de faturamento das SKUs das APIs Places, API Directions e API Distance Matrix legadas. Para as versões atuais desses serviços, consulte Detalhes da SKU do Places (novo) e Detalhes da SKU do Routes e do Navigation. Para um diretório de todas as categorias de produtos, consulte a visão geral dos detalhes de uso da API.

Sobre as tabelas de SKUs

As seções a seguir descrevem os detalhes de cada SKU:

Categoria Se a SKU se enquadra na categoria Essentials, Pro ou Enterprise.
Evento faturável Qual evento é faturado para a SKU.
gatilhos Quais elementos de código acionam eventos faturáveis.
Preços Links para a tabela de preços do grupo dessa SKU.

SKUs legadas do produto Places

Consulte as SKUs do produto Places (novo) para ver as versões mais recentes.

Sobre as SKUs de dados do Places

Os três tipos de SKUs do Places são: Basic Data, Contact Data e Atmosphere Data.

Uma ou mais SKUs de dados são acionadas em:

  • Android: cada solicitação para fetchPlace() ou findCurrentPlace().
  • iOS: cada chamada para fetchPlaceFromPlaceID: ou findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Serviço Web: cada solicitação do Places, dependendo dos campos especificados na solicitação.

As SKUs de dados são sempre cobradas além da SKU da solicitação que as aciona. Por exemplo, uma solicitação do Place Details que inclui campos de dados básicos será cobrada no nível da SKU Basic Data e da SKU Place Details.

Para o serviço Web, as seguintes solicitações das APIs do Places permitem especificar os campos de dados que vão ser retornados:

Para o serviço Web, as seguintes chamadas das APIs do Places NÃO permitem especificar os campos retornados. Essas chamadas sempre retornam todos os dados do Places, cobrando as três SKUs de dados do Places, além da cobrança de cada solicitação de API:

[ Essentials: Places Legacy ]

SKU: Autocomplete – por solicitação

  Categoria Noções básicas
  código SKU

7384-2DE4-D388 (Global)

2164-BC00-53DC (Índia)
  APIs Place Autocomplete (legado) para Android,
Place Autocomplete (legado) para iOS,
Place Autocomplete (legado) para Web
  Evento faturável Solicitação que não inclui um token de sessão
  gatilhos
  Exemplos

Se você fizer uma solicitação em uma sessão inválida do Autocomplete (por exemplo, uma que reutiliza um token de sessão), também vai receber uma cobrança de SKU Autocomplete – por solicitação.

As solicitações de preenchimento automático do widget Place Autocomplete da API Maps JavaScript podem ser cobradas por uma SKU Autocomplete – Per Request quando você faz solicitações de uma sessão inválida do Autocomplete. Isso pode acontecer quando um usuário digita ou copia/cola vários endereços diferentes no widget e nem sempre seleciona uma previsão de preenchimento automático.
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Autocomplete (incluído no Place Details) – por sessão

  Categoria Noções básicas
  código SKU

E9C9-934B-DDB1 (Global)
  APIs Place Autocomplete (legado) para Android,
Place Autocomplete (legado) para iOS,
Place Autocomplete (legado) para Web
  Evento faturável Sessão
  gatilhos
  • Android: uma chamada para fetchPlace()
  • iOS: uma chamada para fetchPlaceFromPlaceID:
  • Serviço Web: uma solicitação do Place Details

Campos na solicitação:

Especifique os campos necessários na solicitação para evitar cobranças desnecessárias. Dependendo dos campos especificados, uma solicitação do Place Details também gera estas SKUs de dados:

Se você não especificar campos na solicitação do Place Details, todas as SKUs de dados serão acionadas.

Se você solicitar apenas uma atualização do ID do Place Details (sua solicitação especifica apenas o campo place_id) durante uma sessão do Autocomplete, a sessão será faturada como SKU: Autocomplete without Place Details – Per Session.
  Exemplos

As solicitações de preenchimento automático estão disponíveis sem custos financeiros. Essa SKU legada é cobrada quando você solicita Place Details subsequentes com base nos preços normais do Place Details.

Este exemplo ilustra uma série de solicitações, por plataforma, que resultariam nas seguintes SKUs na sua fatura, ao visualizar sua fatura por SKU:

  • Autocomplete (incluído no Place Details) – por sessão
  • Place Details
  • Basic Data

Exemplo de solicitação por plataforma:

Solicitações do Android

findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
fetchPlace() (com um FetchPlaceRequest, incluindo o ID de lugar e o campo ADDRESS)

Solicitações do iOS

placesClient?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (incluindo o ID de lugar e o campo GMSPlaceFieldFormattedAddress)

Solicitações de serviço da Web

Solicitação do Places Autocomplete (input="par", session_token: XYZ)
Solicitação do Places Autocomplete (input="paris", session_token: XYZ)
Places Details (place_id, session_token: XYZ, fields:formatted_address)

  Preços Lista de preços (global)
Lista de preços (Índia)

Sobre as sessões do Autocomplete

Uma sessão do Autocomplete inclui algumas solicitações do Autocomplete (para recuperar sugestões em um local conforme o usuário digita) e, no máximo, uma solicitação do Places Details (para recuperar detalhes sobre o local selecionado pelo usuário). O mesmo token de sessão é transmitido para o Autocomplete e para a próxima solicitação do Place Details. Uma sessão começa com a primeira solicitação do Autocomplete, que geralmente acontece quando o usuário começa a digitar. Uma chamada do Places Details é feita quando o usuário seleciona uma das sugestões do Autocomplete. Se um usuário não escolher uma sugestão, nenhuma chamada do Places Details será feita.

Depois que o usuário seleciona um lugar (ou seja, faz uma chamada do Place Details), é preciso iniciar outra sessão usando um novo token de sessão.

As sessões do Autocomplete podem ser geradas a partir das seguintes APIs:

Um token de sessão é válido para uma sessão de usuário e não deve ser usado para mais de uma sessão de usuário. Se você reutilizar um token, a sessão será considerada inválida, e as solicitações serão cobradas como se nenhum token de sessão tivesse sido fornecido.

As solicitações do Autocomplete e do Places Details que usam sessões são faturadas em diferentes SKUs.

SKU: Basic Data

Uma SKU de dados que cobra pelos campos de dados básicos em uma solicitação do Places Details ou do Find Place.

  Categoria Noções básicas
  código SKU

75D4-C522-326B (Global)

5D7B-1F7B-395E (Índia)
  APIs Places Details (legado) com campos básicos
Find Place (legado) com campos básicos
  Evento faturável Solicitação bem-sucedida de campos de dados básicos
  gatilhos

Campos do SDK do Android

Place.Field.ACCESSIBILITY_OPTIONS*
   * Use em vez de Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (descontinuado)
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * Use em vez de Place.Field.NAME (descontinuado)
Place.Field.FORMATTED_ADDRESS*
   * Use em vez de Place.Field.ADDRESS (descontinuado)
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * Use em vez de Place.Field.ICON_URL (descontinuado)
Place.Field.ID
Place.Field.LOCATION*
   * Use em vez de Place.Field.LAT_LNG (descontinuado)
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 o serviço da 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

  Faturamento da máscara de campo

Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo:

  • Se a máscara de campo incluir apenas campos dessa SKU: a solicitação será faturada de acordo com a taxa dessa SKU.
  • Se a máscara de campo incluir campos de outras SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de uma SKU Enterprise, a solicitação será faturada com a taxa da SKU Enterprise.
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Find Place – somente ID

  Categoria Noções básicas
  código SKU

44A2-D839-A3AC (Global)

FE05-60A4-CDDF (Índia)
  APIs Find Place do serviço da Web do Places
  Evento faturável Solicitação bem-sucedida apenas para o place_id
  gatilhos Solicitação do Find Place sem campos especificados ou apenas com o campo place_id: FindPlace(fields: place_id).
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Place Details – ID Refresh

  Categoria Noções básicas
  código SKU

2D88-4302-6299 (Global)

4604-F56B-7086 (Índia)
  APIs Place Details (legado)
  Evento faturável Solicitação bem-sucedida apenas para campos de ID
  gatilhos Solicitação apenas com o campo de ID de lugar: getPlaceDetails(fields: place_id).
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Query Autocomplete – por solicitação

  Categoria Noções básicas
  código SKU

C4B1-8805-63EF (global)

59E9-EB83-5CA3 (Índia)
  APIs Serviço Query Autocomplete
  Evento faturável Solicitação bem-sucedida
  gatilhos

O preço por sessão do Autocomplete não é aplicado com o Query Autocomplete. As solicitações seguintes do Place Details são cobradas com base na SKU Place Details Pro.

  Preços Lista de preços (global)
Lista de preços (Índia)

[ Pro: Places Legacy ]

SKU: Autocomplete sem Place Details – por sessão

  Categoria Pro
  código SKU

B52C-8320-6DC5 (Global)

C625-D3CE-DF37 (Índia)
  APIs Place Autocomplete (legado) para Android,
Place Autocomplete (legado) para iOS,
Place Autocomplete (legado) para Web
  Evento faturável Sessão
  gatilhos
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Find Current Place

  Categoria Pro
  código SKU

7218-264C-D1D7 (global)

0862-F46E-1A1A (Índia)
  APIs SDK do Places para Android,
SDK do Places para iOS
  Evento faturável Solicitação bem-sucedida
  gatilhos
  Exemplos

Os exemplos a seguir mostram quais SKUs são cobradas quando você faz uma solicitação do Find Current Place e especifica campos das SKUs de dados Basic, Contact e Atmosphere. Para ver as SKUs na fatura, visualize-a por SKU, conforme descrito em Analisar o uso e o custo por SKU.

Você faz uma solicitação do Find Current Place apenas com o campo ADDRESS:

Sua fatura mostra estas SKUs:

  • Find Current Place
  • Basic Data

Você faz uma solicitação do Find Current Place apenas com o campo PHONE_NUMBER:

Sua fatura mostra estas SKUs:

  • Find Current Place
  • Contact Data

Você faz uma solicitação do Local atual com todos os três campos de tipo de dados:

Sua fatura mostra estas SKUs:

  • Find Current Place
  • Basic Data
  • Contact Data
  • Atmosphere Data
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Find Place

  Categoria Pro
  código SKU

DC67-3188-2294 (global)

ECB4-087C-9A27 (Índia)
  APIs Find Place (legado)
  Evento faturável Solicitação bem-sucedida para mais do que apenas o campo de ID
  gatilhos Solicitação do Find Place com mais do que apenas o campo de ID especificado.
  Exemplos

Os exemplos a seguir mostram quais SKUs são cobradas quando você faz uma solicitação do Find Current Place e especifica campos das SKUs de dados Basic, Contact e Atmosphere. Para ver as SKUs na fatura, visualize-a por SKU, conforme descrito em Analisar o uso e o custo por SKU.

Você faz uma solicitação do Find Place apenas com o campo ADDRESS:

Sua fatura mostra estas SKUs:

  • Find Current Place
  • Basic Data

Você faz uma solicitação do Find Place apenas com o campo PHONE_NUMBER:

Sua fatura mostra estas SKUs:

  • Find Current Place
  • Contact Data

Você faz uma solicitação do Find Place com os três campos de tipo de dados:

Sua fatura mostra estas SKUs:

  • Find Current Place
  • Basic Data
  • Contact Data
  • Atmosphere Data
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Places – Nearby Search

  Categoria Pro
  código SKU

6B23-8A17-D29D (Global)

CC66-BE0E-2477 (Índia)
  APIs Nearby Search (legado)
  Evento faturável Solicitação de recursos do Pro enviada
  gatilhos

Essa solicitação não permite especificar quais campos serão retornados. A resposta retorna uma lista de lugares e um subconjunto dos campos de dados compatíveis.
  Exemplos

Você faz uma solicitação do Nearby Search, como NearbySearch (San Francisco, 100 meters). Sua fatura mostra estas SKUs ao visualizar por SKU:

  • Lugar
  • Basic Data
  • Contact Data
  • Atmosphere Data
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Places – Text Search

  Categoria Pro
  código SKU

E95A-86C7-7F47 (Global)

102E-888D-5596 (Índia)
  APIs Text Search (Legacy)
  Evento faturável Solicitação bem-sucedida para Text Search (legado)
  gatilhos

As solicitações do Text Search retornam uma lista de lugares, mas não é possível especificar quais campos são retornados. As solicitações de Text Search retornam um subconjunto dos campos de dados compatíveis. É cobrado o valor da solicitação do Text Search e de todas as SKUs de tipos de dados: Basic Data, Contact Data e Atmosphere Data.

A SKU Places – Text Search também é acionada pelo widget Place SearchBox da API Maps JavaScript: método getPlaces() depois que o usuário seleciona uma consulta de lugar (ícone: lupa), e não um resultado (ícone: alfinete), conforme ilustrado aqui:

Seleção da consulta no widget da caixa de pesquisa do Places Detail
Nos resultados do widget da caixa de pesquisa, depois que o usuário digita "pizza" na caixa de pesquisa, veja que entrega de pizza passa a mostrar um ícone de alfinete, indicando que é uma consulta de lugar (e não um resultado).
  Exemplos

Se você fizer uma solicitação do Text Search (Legacy), sua fatura vai mostrar estas SKUs ao visualizar por SKU:

  • Places - Text Search
  • Basic Data
  • Contact Data
  • Atmosphere Data
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Places Details

  Categoria Pro
  código SKU

FC5C-DF28-543F (Global)

F7AA-FEF9-C90E (Índia)
  APIs Place Details (legado)
  Evento faturável Solicitação de recursos do Pro enviada
  gatilhos

Com a API e os serviços Web, a SKU do Place Details é cobrada independentemente de um token de sessão ser fornecido ou não.

  Exemplos
  1. Faça uma destas chamadas ou solicitações:
    • Dispositivos móveis: chame fetchPlace() no Android ou fetchPlaceFromPlaceID: no iOS e especifique apenas o campo ADDRESS
    • API ou serviço Web: faça uma solicitação do Place Details (Legacy) e especifique apenas o campo de endereço: getPlaceDetails(fields: formatted_address)
    Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):
    • Places Details
    • Basic Data
  2. Faça uma destas chamadas ou solicitações:
    • Dispositivos móveis: chame fetchPlace() no Android ou fetchPlaceFromPlaceID: no iOS e especifique apenas o campo PHONE_NUMBER
    • API ou serviço Web: faça uma solicitação do Place Details (Legacy) e especifique apenas o campo de número de telefone: getPlaceDetails(fields: formatted_phone_number)
    Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):
    • Places Details
    • Contact Data
  3. Faça uma destas chamadas ou solicitações:
    • Dispositivos móveis: chame fetchPlace() no Android ou fetchPlaceFromPlaceID: no iOS e especifique todos os campos
    • API ou serviço Web: faça uma solicitação do Place Details (Legacy) e especifique todos os campos. Esse tipo de solicitação é o padrão caso nenhum campo seja definido: getPlaceDetails().
    Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):
    • Places Details
    • Basic Data
    • Contact Data
    • Atmosphere Data
  Preços Lista de preços (global)
Lista de preços (Índia)

[ Enterprise: Places Legacy ]

SKU: Atmosphere Data

Uma SKU de dados que cobra pelos campos de dados de ambiente em uma solicitação do Places Details ou do Find Place.

  Categoria Enterprise
  código SKU

D63D-5CC5-302A (global)

0CE0-1963-137E (Índia)
  APIs Places Details (legado) com campos Atmosphere
Find Place (legado) com campos Atmosphere
  Evento faturável Solicitação bem-sucedida de campos de dados de atmosfera
  gatilhos
  Exemplos de faturamento de máscara de campo

Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo:

  • Se a máscara de campo incluir apenas campos dessa SKU: a solicitação será faturada de acordo com a taxa dessa SKU.
  • Se a máscara de campo incluir campos de outras SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de uma SKU Enterprise, a solicitação será faturada com a taxa da SKU Enterprise.
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Contact Data

Uma SKU de dados que cobra pelos campos de dados de contato em uma solicitação do Places Details ou do Find Place.

  Categoria Enterprise
  código SKU

F095-CD01-81B2 (global)

A03F-5079-C66C (Índia)
  APIs Places Details (legado) com campos de contato
Find Place (legado) com campos de contato
  Evento faturável Solicitação bem-sucedida de campos de dados de contato
  gatilhos

Campos do SDK do Android

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * Use em vez de Place.Field.PHONE_NUMBER (descontinuado).
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

Campos do SDK para iOS

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

Campos para o serviço da Web

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  Faturamento da máscara de campo

Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo:

  • Se a máscara de campo incluir apenas campos dessa SKU: a solicitação será faturada de acordo com a taxa dessa SKU.
  • Se a máscara de campo incluir campos de outras SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de uma SKU Enterprise, a solicitação será faturada com a taxa da SKU Enterprise.
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Places Photo

  Categoria Enterprise
  código SKU

81E7-85D0-58A7 (Global)

9F4B-2E19-1B63 (Índia)
  APIs Places Photo (legado)
  Evento faturável Solicitação de foto bem-sucedida
  gatilhos
  • Android: solicitações para fetchPhoto()
  • iOS: solicitações para loadPlacePhoto:
  • JavaScript: solicitações para PlacePhoto.getUrl() para carregar dados de pixel de imagem.
  • Serviço Web: solicitações para o serviço Place Photos da API Places.
  Preços Lista de preços (global)
Lista de preços (Índia)

SKUs da API Routes legada

[ Essentials: Routes Legacy ]

SKU: Directions

  Categoria Noções básicas
  código SKU

28A8-3EB4-4595 (Global)

4714-291C-3199 (Índia)
  APIs Serviço Directions da API Maps JavaScript,
API Directions (legada)
  Evento faturável Solicitação bem-sucedida sem recursos Pro ou Enterprise
  gatilhos Consultas que não acionam uma SKU de classificação mais alta
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Distance Matrix

  Categoria Noções básicas
  código SKU

C1B6-FF9D-7700 (Global)

558A-4F88-F361 (Índia)
  APIs API Distance Matrix (legada),
Serviço Distance Matrix da API Maps JavaScript
  Evento faturável Cada elemento que não contém recursos Pro ou Enterprise. Cada solicitação enviada à API Distance Matrix gera elementos, em que o número de origins vezes o número de destinations é igual ao número de elementos.
  gatilhos Solicitações de elementos que não acionam SKUs de preço mais alto
  Preços Lista de preços (global)
Lista de preços (Índia)

[ Pro: Routes Legacy ]

SKU: Directions Advanced

  Categoria Pro
  código SKU

9407-00C2-CF85 (global)

E27B-BD57-FD7D (Índia)
  APIs Serviço Directions da API Maps JavaScript,
API Directions (legada)
  Evento faturável Solicitação bem-sucedida com recursos do Pro
  gatilhos
  Preços Lista de preços (global)
Lista de preços (Índia)

SKU: Distance Matrix Advanced

  Categoria Pro
  código SKU

DFAE-763F-CF6E (Global)

C0F4-32AE-F6D1 (Índia)
  APIs API Distance Matrix (legada),
Serviço Distance Matrix da API Maps JavaScript
  Evento faturável Cada elemento retornado com recursos Pro. Cada solicitação enviada à API Distance Matrix gera elementos, em que o número de origins vezes o número de destinations é igual ao número de elementos.
  gatilhos
  Preços Lista de preços (global)
Lista de preços (Índia)