Détails des anciens SKU Places et Routes

Cette page fournit des informations sur les SKU, les ID de SKU, les événements facturables et les déclencheurs de facturation pour les anciens SKU des API Places, Directions et Distance Matrix. Pour connaître les versions actuelles de ces services, consultez Détails des SKU Places (New) et Détails des SKU Routes et Navigation. Pour obtenir un répertoire de toutes les catégories de produits, consultez la présentation des détails d'utilisation de l'API.

À propos des tableaux de SKU

Les sections suivantes décrivent les détails de chaque SKU :

Catégorie Indique si le SKU appartient à la catégorie Essentials, Pro ou Enterprise.
Événement facturable Événement facturé pour le SKU.
Déclencheurs Quels éléments de code déclenchent des événements facturables ?
Tarifs Liens vers la grille tarifaire du groupe de ce SKU.

SKU : produit Places (ancienne version)

Consultez SKU : produit Places (nouvelle version) pour connaître les dernières versions.

À propos des codes SKU Places Data

Les trois SKU Places Data sont Basic Data, Contact Data et Atmosphere Data.

Un ou plusieurs codes SKU Data sont déclenchés pour :

  • Android : chaque requête vers fetchPlace() ou findCurrentPlace()
  • iOS : chaque appel fait à fetchPlaceFromPlaceID: ou findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Service Web : chaque requête Places, en fonction des champs spécifiés dans la requête

Les SKU Data sont toujours facturés en plus du SKU de base pour la requête qui les déclenche. Par exemple, une requête Places Details incluant des champs de données de base sera facturée à la fois sous le SKU Data Basic et sous le SKU Place Details.

Pour le service Web, les requêtes des API Places suivantes vous permettent de spécifier les champs de données à afficher :

Les appels des API Places suivantes NE PERMETTENT PAS de spécifier les champs affichés. Ces appels renvoient toujours toutes les données Places, en facturant les trois SKU Data Places en plus des frais associés à chaque requête API :

[ Essentials: Places Legacy ]

SKU : Autocomplete – Per Request

  Catégorie Essentials
  SKU ID

7384-2DE4-D388 (Global)

2164-BC00-53DC (Inde)
  API Place Autocomplete (Legacy) Android,
Place Autocomplete (Legacy) iOS,
Place Autocomplete (Legacy) Web
  Événement facturable Requête n'incluant pas de jeton de session
  Déclencheurs
  Exemples

Si vous effectuez une requête à partir d'une session Autocomplete non valide (par exemple, une session qui réutilise un jeton de session), vous êtes également facturé à hauteur d'un SKU Autocomplete – Per Request.

Les requêtes Autocomplete du widget Place Autocomplete de l'API Maps JavaScript peuvent être facturées à hauteur d'un SKU Autocomplete – Per Request si vous effectuez des requêtes à partir d'une session Autocomplete non valide. Cette situation peut se produire lorsqu'un utilisateur saisit plusieurs adresses ou effectue un copier/coller de différentes adresses dans le widget, et qu'il ne sélectionne pas toujours la prédiction de saisie semi-automatique.
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

Code SKU : Autocomplete (included with Place Details) – Per Session

  Catégorie Essentials
  SKU ID

E9C9-934B-DDB1 (monde)
  API Place Autocomplete (Legacy) Android,
Place Autocomplete (Legacy) iOS,
Place Autocomplete (Legacy) Web
  Événement facturable Session
  Déclencheurs
  • Android : appel fait à fetchPlace()
  • iOS : appel fait à fetchPlaceFromPlaceID:
  • Service Web : requête Places Details

Champs de la requête :

Veillez à spécifier les champs dont vous avez besoin dans la requête pour éviter des frais inutiles. Selon les champs que vous spécifiez, une requête Place Details génère également les SKU de données suivants :

Si vous ne précisez pas de champs dans la requête Place Details, tous les SKU Data sont déclenchés.

Si vous ne demandez que l'actualisation de l'ID Place Details (votre requête ne spécifie que le champ place_id) lors d'une session Autocomplete, la session est facturée comme SKU Autocomplete without Place Details – Per Session.
  Exemples

Les requêtes de saisie semi-automatique sont disponibles sans frais. Ce SKU hérité est facturé lorsque vous demandez des détails sur un lieu ultérieurs en fonction de la tarification Place Details standard.

Cet exemple illustre une série de requêtes, par plate-forme, qui génèrent les codes SKU suivants sur votre facture, lorsque vous affichez votre facture par code SKU :

  • Autocomplete (included with Place Details) – Per Session
  • Place Details
  • Champs "Basic Data"

Exemple de requête par plate-forme :

Requêtes Android

findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
fetchPlace() (avec un FetchPlaceRequest comprenant l'ID de lieu et le champ ADDRESS)

Requêtes iOS

placesClient?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (y compris l'ID de lieu et le champ GMSPlaceFieldFormattedAddress)

Requêtes de service Web

Requête Places Autocomplete (input="par", session_token: XYZ)
Requête Places Autocomplete (input="paris", session_token: XYZ)
Places Details (place_id, session_token: XYZ, fields:formatted_address)

  Tarifs Tarifs (monde entier)
Tarifs (Inde)

À propos des sessions Autocomplete

Une session Autocomplete inclut certaines requêtes Autocomplete (pour proposer des suggestions concernant un lieu au fur et à mesure que l'utilisateur effectue sa saisie) et une requête Places Details au maximum (pour récupérer des informations sur le lieu sélectionné par l'utilisateur). Le même jeton de session est transmis à la requête Autocomplete, puis à la requête Places Details qui s'ensuit. Une session commence par la première requête Autocomplete (qui se produit généralement lorsque l'utilisateur commence à saisir du texte). Un appel Places Details a lieu lorsque l'utilisateur a sélectionné l'une des suggestions Autocomplete. Si l'utilisateur ne sélectionne pas de suggestion, aucun appel Places Details n'est effectué.

Une fois qu'un utilisateur a sélectionné un lieu (c'est-à-dire qu'un appel Place Details est effectué), vous devez démarrer une nouvelle session à l'aide d'un nouveau jeton de session.

Les sessions Autocomplete peuvent être générées à partir des API suivantes :

Un jeton de session ne convient que pour une seule session utilisateur. Si vous réutilisez un jeton de session, la session est considérée comme non valide, et les requêtes sont facturées comme si aucun jeton de session n'avait été fourni.

Les requêtes Autocomplete et Places Details utilisant des sessions sont facturées selon des SKU différents.

Code SKU : Basic Data

SKU Data qui facture les champs de données Basic Data dans une requête Places Details ou Find Place.

  Catégorie Essentials
  SKU ID

75D4-C522-326B (Global)

5D7B-1F7B-395E (Inde)
  API Places Details (ancienne version) avec des champs de base
Find Place (ancienne version) avec des champs de base
  Événement facturable Requête réussie pour les champs de données Basic
  Déclencheurs

Champs pour le SDK Android

Place.Field.ACCESSIBILITY_OPTIONS*
   * À utiliser à la place de Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (obsolète)
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * À utiliser à la place de Place.Field.NAME (obsolète)
Place.Field.FORMATTED_ADDRESS*
   * À utiliser à la place de Place.Field.ADDRESS (obsolète)
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * À utiliser à la place de Place.Field.ICON_URL (obsolète)
Place.Field.ID
Place.Field.LOCATION*
   * À utiliser à la place de Place.Field.LAT_LNG (obsolète)
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.TYPES
Place.Field.VIEWPORT
Place.Field.UTC_OFFSET.

Champs pour iOS

GMSPlaceFieldFormattedAddress
GMSPlaceFieldBusinessStatus
GMSPlaceFieldID
GMSPlaceFieldCoordinate
GMSPlaceFieldName
GMSPlaceFieldPhotos
GMSPlaceFieldPlusCode
GMSPlaceFieldTypes
GMSPlaceFieldViewport

Champs pour le service 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

  Facturation du masque de champ

Votre requête est facturée en fonction des champs fournis dans le masque de champ. Exemple :

  • Si votre masque de champ n'inclut que des champs de ce SKU : la requête est facturée au tarif de ce SKU.
  • Si votre masque de champ inclut des champs d'autres SKU : la requête est facturée au tarif du SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs d'un SKU Essentials et d'un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

SKU : Find Place – ID only

  Catégorie Essentials
  SKU ID

44A2-D839-A3AC (Global)

FE05-60A4-CDDF (Inde)
  API Service Web Places Find Place
  Événement facturable Requête réussie pour l'en-tête place_id uniquement
  Déclencheurs Requête Find Place sans champ spécifié ou avec uniquement le champ place_id : FindPlace(fields: place_id).
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

SKU : Place Details – ID Refresh

  Catégorie Essentials
  SKU ID

2D88-4302-6299 (Global)

4604-F56B-7086 (Inde)
  API Place Details (ancienne version)
  Événement facturable Requête réussie pour les champs d'ID uniquement
  Déclencheurs Requête avec uniquement le champ d'ID de lieu : getPlaceDetails(fields: place_id).
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

SKU : Query Autocomplete – Per Request

  Catégorie Essentials
  SKU ID

C4B1-8805-63EF (monde)

59E9-EB83-5CA3 (Inde)
  API Service Query Autocomplete
  Événement facturable Requête réussie
  Déclencheurs

La tarification par session Autocomplete n'est pas compatible avec la requête Query Autocomplete. Les requêtes Place Details qui s'ensuivent sont facturées en fonction du SKU Place Details Pro.

  Tarifs Tarifs (monde entier)
Tarifs (Inde)

[ Pro: Places Legacy ]

SKU : Autocomplete without Place Details – Per Session

  Catégorie Pro
  SKU ID

B52C-8320-6DC5 (Global)

C625-D3CE-DF37 (Inde)
  API Place Autocomplete (Legacy) Android,
Place Autocomplete (Legacy) iOS,
Place Autocomplete (Legacy) Web
  Événement facturable Session
  Déclencheurs
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

SKU : Find Current Place

  Catégorie Pro
  SKU ID

7218-264C-D1D7 (monde)

0862-F46E-1A1A (Inde)
  API SDK Places pour Android,
SDK Places pour iOS
  Événement facturable Requête réussie
  Déclencheurs
  Exemples

Les exemples suivants montrent les SKU qui vous sont facturés lorsque vous effectuez une requête Find Current Place et que vous spécifiez des champs des SKU de données Basic, Contact et Atmosphere. Pour afficher les SKU sur votre facture, consultez votre facture par SKU comme décrit dans Analyser l'utilisation et le coût par SKU.

Vous exécutez une requête Find Current Place avec uniquement le champ ADDRESS :

Votre facture affiche les SKU suivants :

  • Find Current Place
  • Champs "Basic Data"

Vous exécutez une requête Find Current Place avec uniquement le champ PHONE_NUMBER :

Votre facture affiche les SKU suivants :

  • Find Current Place
  • Contact Data

Vous effectuez une requête Find Current Place avec les trois champs de types de données :

Votre facture affiche les SKU suivants :

  • Find Current Place
  • Champs "Basic Data"
  • Contact Data
  • Atmosphere Data
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

SKU : Find Place

  Catégorie Pro
  SKU ID

DC67-3188-2294 (monde)

ECB4-087C-9A27 (Inde)
  API Find Place (ancienne version)
  Événement facturable Requête réussie pour plus que le champ d'ID
  Déclencheurs Requête Find Place avec plus que le champ d'ID spécifié.
  Exemples

Les exemples suivants montrent les SKU qui vous sont facturés lorsque vous effectuez une requête Find Current Place et que vous spécifiez des champs des SKU de données Basic, Contact et Atmosphere. Pour afficher les SKU sur votre facture, consultez votre facture par SKU comme décrit dans Analyser l'utilisation et le coût par SKU.

Vous exécutez une requête Find Place avec uniquement le champ ADDRESS :

Votre facture indique les SKU suivants :

  • Find Current Place
  • Champs "Basic Data"

Vous exécutez une requête Find Place avec uniquement le champ PHONE_NUMBER :

Votre facture affiche les SKU suivants :

  • Find Current Place
  • Contact Data

Vous effectuez une requête Find Place avec les trois champs de types de données :

Votre facture affiche les SKU suivants :

  • Find Current Place
  • Champs "Basic Data"
  • Contact Data
  • Atmosphere Data
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

Code SKU : Places – Nearby Search

  Catégorie Pro
  SKU ID

6B23-8A17-D29D (monde)

CC66-BE0E-2477 (Inde)
  API Nearby Search (ancienne version)
  Événement facturable Demande de fonctionnalités Pro réussie
  Déclencheurs

Cette requête ne permet pas de spécifier les champs à renvoyer. La réponse renvoie une liste de lieux et un sous-ensemble des champs de données compatibles.
  Exemples

Vous effectuez une requête Nearby Search, par exemple : NearbySearch (San Francisco, 100 meters). Votre facture affiche ces SKU lorsque vous affichez votre facture par SKU :

  • Lieu
  • Champs "Basic Data"
  • Contact Data
  • Atmosphere Data
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

Code SKU : Places – Text Search

  Catégorie Pro
  SKU ID

E95A-86C7-7F47 (monde)

102E-888D-5596 (Inde)
  API Text Search (ancienne version)
  Événement facturable Requête réussie vers Text Search (ancienne version)
  Déclencheurs

Les requêtes Text Search renvoient une liste de lieux, mais ne permettent pas de spécifier les champs renvoyés. Les requêtes Text Search renvoient un sous-ensemble des champs de données compatibles. La requête Text Search vous est facturée, ainsi que tous les SKU de type données : Basic Data, Contact Data et Atmosphere Data.

Le SKU Places – Text Search est également déclenché par le widget Places SearchBox de l'API Maps JavaScript : méthode getPlaces() une fois que l'utilisateur a sélectionné une requête de lieu (icône : loupe), pas un résultat (icône : repère), comme illustré ci-dessous :

Sélection de requêtes pour le widget Places Details SearchBox
Dans les résultats du widget SearchBox, après avoir saisi "pizza" dans le champ de recherche, vous remarquerez que le texte pizza delivery est précédé d'une icône en forme de loupe, indiquant qu'il s'agit d'une requête de lieu (et non un résultat).
  Exemples

Si vous effectuez une requête Text Search (ancienne version), votre facture affiche ces SKU lorsque vous l'affichez par SKU :

  • Places – Text Search
  • Champs "Basic Data"
  • Contact Data
  • Atmosphere Data
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

Code SKU : Places Details

  Catégorie Pro
  SKU ID

FC5C-DF28-543F (Global)

F7AA-FEF9-C90E (Inde)
  API Place Details (ancienne version)
  Événement facturable Demande de fonctionnalités Pro réussie
  Déclencheurs

Avec l'API et les services Web, le SKU Place Details est facturé, que vous fournissiez un jeton de session ou non.

  Exemples
  1. Effectuez l'un de ces appels ou requêtes :
    • Mobile : appelez fetchPlace() sur Android ou fetchPlaceFromPlaceID: sur iOS, et ne spécifiez que le champ ADDRESS
    • API ou service Web : exécutez une requête Place Details (ancienne version) et ne spécifiez que le champ d'adresse : getPlaceDetails(fields: formatted_address)
    Sur votre facture, les SKU suivants sont indiqués (lorsque vous affichez votre facture par SKU) :
    • Places Details
    • Champs "Basic Data"
  2. Effectuez l'un de ces appels ou requêtes :
    • Mobile : appelez fetchPlace() sur Android ou fetchPlaceFromPlaceID: sur iOS, et ne spécifiez que le champ PHONE_NUMBER
    • API ou service Web : exécutez une requête Place Details (ancienne version) et spécifiez le champ du numéro de téléphone : getPlaceDetails(fields: formatted_phone_number)
    Sur votre facture, les SKU suivants sont indiqués (lorsque vous affichez votre facture par SKU) :
    • Places Details
    • Contact Data
  3. Effectuez l'un de ces appels ou requêtes :
    • Mobile : appelez fetchPlace() sur Android ou fetchPlaceFromPlaceID: sur iOS, et spécifiez tous les champs
    • API ou service Web : effectuez une requête Place Details (ancienne version) et spécifiez tous les champs (ce type de requête est le type par défaut si vous ne spécifiez aucun champ) : getPlaceDetails().
    Sur votre facture, les SKU suivants sont indiqués (lorsque vous affichez votre facture par SKU) :
    • Places Details
    • Champs "Basic Data"
    • Contact Data
    • Atmosphere Data
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

[ Enterprise: Places Legacy ]

Code SKU : Atmosphere Data

SKU de données facturé pour les champs de données Atmosphere Data dans une requête Place Details ou Find Place.

  Catégorie Enterprise
  SKU ID

D63D-5CC5-302A (monde)

0CE0-1963-137E (Inde)
  API Places Details (ancien) avec des champs Atmosphere
Find Place (ancien) avec des champs Atmosphere
  Événement facturable Requête réussie pour les champs de données d'atmosphère
  Déclencheurs
  Exemples de facturation avec masque de champ

Votre requête est facturée en fonction des champs fournis dans le masque de champ. Exemple :

  • Si votre masque de champ n'inclut que des champs de ce SKU : la requête est facturée au tarif de ce SKU.
  • Si votre masque de champ inclut des champs d'autres SKU : la requête est facturée au tarif du SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs d'un SKU Essentials et d'un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

Code SKU : Contact Data

SKU Data qui facture les champs Contact Data dans une requête Places Details ou Find Place.

  Catégorie Enterprise
  SKU ID

F095-CD01-81B2 (mondial)

A03F-5079-C66C (Inde)
  API Places Details (ancien) avec des champs Contact
Find Place (ancien) avec des champs Contact
  Événement facturable Requête réussie pour les champs de données Contact
  Déclencheurs

Champs pour le SDK Android

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * Utilisez cette option à la place de Place.Field.PHONE_NUMBER (obsolète).
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

Champs pour le SDK iOS

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

Champs pour le service Web

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  Facturation du masque de champ

Votre requête est facturée en fonction des champs fournis dans le masque de champ. Exemple :

  • Si votre masque de champ n'inclut que des champs de ce SKU : la requête est facturée au tarif de ce SKU.
  • Si votre masque de champ inclut des champs d'autres SKU : la requête est facturée au tarif du SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs d'un SKU Essentials et d'un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

Code SKU : Places Photo

  Catégorie Enterprise
  SKU ID

81E7-85D0-58A7 (Global)

9F4B-2E19-1B63 (Inde)
  API Places Photo (ancienne version)
  Événement facturable Demande de photo réussie
  Déclencheurs
  • Android : requêtes vers fetchPhoto()
  • iOS : requêtes envoyées à loadPlacePhoto:
  • JavaScript : requêtes envoyées à PlacePhoto.getUrl() pour charger des données de pixels d'image.
  • Service Web : requêtes envoyées au service Place Photos de l'API Places.
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

Anciens SKU de l'API Routes

[ Essentials: Routes Legacy ]

SKU : Directions

  Catégorie Essentials
  SKU ID

28A8-3EB4-4595 (Global)

4714-291C-3199 (Inde)
  API Service Directions de l'API Maps JavaScript,
API Directions (ancienne version)
  Événement facturable Requête réussie sans fonctionnalités Pro ni Enterprise
  Déclencheurs Requêtes qui ne déclenchent pas de SKU plus coûteux
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

SKU : Matrice des distances

  Catégorie Essentials
  SKU ID

C1B6-FF9D-7700 (mondial)

558A-4F88-F361 (Inde)
  API API Distance Matrix (ancienne version),
Service Distance Matrix de l'API Maps JavaScript
  Événement facturable Chaque élément qui ne contient pas de fonctionnalités Pro ou Enterprise. Chaque requête envoyée à l'API Distance Matrix génère des éléments. Le nombre d'éléments s'obtient en multipliant le nombre de origins par le nombre de destinations.
  Déclencheurs Requêtes d'éléments qui ne déclenchent pas de SKU plus chers
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

[ Pro: Routes Legacy ]

SKU : Directions Advanced

  Catégorie Pro
  SKU ID

9407-00C2-CF85 (monde)

E27B-BD57-FD7D (Inde)
  API Service Directions de l'API Maps JavaScript,
API Directions (ancienne version)
  Événement facturable Requête réussie avec les fonctionnalités Pro
  Déclencheurs
  Tarifs Tarifs (monde entier)
Tarifs (Inde)

SKU : Matrice des distances avancée

  Catégorie Pro
  SKU ID

DFAE-763F-CF6E (Global)

C0F4-32AE-F6D1 (Inde)
  API API Distance Matrix (ancienne version),
Service Distance Matrix de l'API Maps JavaScript
  Événement facturable Chaque élément est renvoyé avec les fonctionnalités Pro. Chaque requête envoyée à l'API Distance Matrix génère des éléments. Le nombre d'éléments s'obtient en multipliant le nombre de origins par le nombre de destinations.
  Déclencheurs
  Tarifs Tarifs (monde entier)
Tarifs (Inde)