Utilisation et facturation de l'API Places

L'API Places utilise un modèle de paiement à l'usage. Les requêtes API Places génèrent des appels vers plusieurs codes SKU. En plus des conditions d'utilisation générales de Google, il existe des limites d'utilisation spécifiques à l'API Places. Gérez vos coûts et votre utilisation à l'aide des outils disponibles dans Google Cloud Console.

Facturation de l'API Places

L'API Places utilise un modèle de paiement à l'usage. Les API et les SDK Google Maps Platform sont facturés en fonction du code SKU. L'utilisation est suivie pour chaque SKU, et chaque API ou SDK peut être associé à plusieurs SKU de produits. Le coût est calculé de la façon suivante :

Utilisation du code SKU × Prix par utilisation

Utilisez notre simulateur de prix et d'utilisation pour estimer votre coût d'utilisation par API ou SDK. Un crédit Google Maps Platform de 200 USD est disponible pour chaque compte de facturation pour les SKU Google Maps Platform éligibles. Il est automatiquement appliqué1 aux codes SKU éligibles.

Tarifs de l'API Places

À 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 Places Details est effectué), vous devez démarrer une nouvelle session à l'aide d'un nouveau jeton.

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 en réutilisez un, la session est considérée comme non valide, et les requêtes sont facturées comme si aucun jeton n'était fourni.

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

À propos des codes SKU Places Data

Les trois codes SKU Places Data sont les suivants: 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 en tant que code SKU Place Details.

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

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

Code SKU : Basic Data

Si vous utilisez le paramètre "fields" dans votre requête Places Details ou Find Place, vous pouvez limiter la réponse à ces champs spécifiés uniquement. Les champs de la catégorie Basic sont inclus dans le coût de base de la requête Places et n'entraînent aucuns frais supplémentaires. Le code SKU Basic Data se déclenche lorsque l'un de ces champs est demandé :

  • 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 ou Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • iOS:GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinesssStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes ou GMSPlaceFieldViewport
  • 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 ou wheelchair_accessible_entrance
VOLUME MENSUEL
(prix par APPEL)
0-100 000 100 001-500 000 500 000 ou plus
Coût des requêtes Places
+ 0 USD		 Coût des requêtes Places
+ 0 USD		 Coût des requêtes Places
+ 0 USD

Code SKU : Contact Data

Si vous utilisez le paramètre "fields" dans votre requête Places Details ou Find Place pour les services Web, ou un tableau de valeurs Place.Field pour Android ou iOS, vous pouvez limiter la réponse à ces champs spécifiés uniquement. Les champs de la catégorie Contact génèrent des frais supplémentaires. Le code SKU Contact Data se déclenche lorsque l'un des champs suivants est demandé :

  • Android:Place.Field.CURRENT_OPENING_HOURS, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.SECONDARY_OPENING_HOURS ou Place.Field.WEBSITE_URI
  • iOS:GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber ou GMSPlaceFieldWebsite
  • Service Web:formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours ou website
VOLUME MENSUEL
(prix par APPEL)
0-100 000 100 001-500 000 500 000 ou plus
Coût des requêtes Places
+ 0,003 USD par appel
(+ 3 USD pour 1 000)		 Coût des requêtes Places
+ 0,0024 USD par appel
(+ 2,40 USD pour 1 000)		 Contactez le service commercial pour connaître le prix sur d'autres volumes

Code SKU : Atmosphere Data

Si vous utilisez le paramètre "fields" dans votre requête Places Details ou Find Place, vous pouvez limiter la réponse à ces champs spécifiés uniquement. Les champs de la catégorie Atmosphere génèrent des frais supplémentaires. Le code SKU Atmosphere Data se déclenche lorsque l'un des champs suivants est demandé :

  • Android:Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, 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 ou Place.Field.USER_RATINGS_TOTAL
  • iOS : GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch ou GMSPlaceFieldServesVegetarianFood.
  • JavaScript : consultez Champs (Place Details).
  • Service 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 ou user_ratings_total.
VOLUME MENSUEL
(prix par APPEL)
0-100 000 100 001-500 000 500 000 ou plus
Coût des requêtes Places
+ 0,005 USD prix unitaire
(+ 5 USD pour 1 000)		 Coût des requêtes Places
+ 0,004 USD prix unitaire
(+ 4 USD pour 1 000)		 Contactez le service commercial pour connaître le prix sur d'autres volumes

Code SKU : Autocomplete – Per Request

Le code SKU Autocomplete – Per Request est facturé pour chaque appel ou requête qui n'inclut pas de jeton de session :

Les appels effectués à partir d'une session Autocomplete non valide (par exemple, une session qui réutilise un jeton de session) sont également facturés à hauteur d'un code SKU Autocomplete – Per Request.

Les requêtes Autocomplete du widget Place Autocomplete de l'API Maps JavaScript peuvent être facturées à hauteur d'un code SKU Autocomplete – Per Request si les appels sont effectués à 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.

VOLUME MENSUEL
(prix par REQUÊTE)
0-100 000 100 001-500 000 + de 500 000
0,00283 USD prix unitaire
(2,83 USD pour 1 000)		 0,00227 USD prix unitaire
(2,27 USD pour 1 000)		 Contactez le service commercial pour connaître le prix sur d'autres volumes

Code SKU : Autocomplete without Place Details – Per Session

Le code SKU Autocomplete without Places Details – Per Session est facturé pour une session Autocomplete qui n'inclut pas une requête Place Details (dans les quelques minutes qui suivent le début de la session).

VOLUME MENSUEL
(prix par SESSION)
0-100 000 100 001-500 000 + de 500 000
0,017 USD prix unitaire
(17,00 USD pour 1 000)		 0,0136 USD prix unitaire
(13,60 USD pour 1 000)		 Contactez le service commercial pour connaître le prix sur d'autres volumes

Exemple

Si votre application émet les deux appels suivants au cours d'une même session :

Android

iOS

Service Web

Sur votre facture, le code SKU suivant est indiqué (lorsque vous affichez votre facture par code SKU) :

  • Autocomplete without Place Details – Per Session (prix à compter de 0,017 USD par session)

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

Le code SKU Autocomplete (included with Place Details) – Per Session est facturé pour chaque session Autocomplete qui inclut l'un des éléments suivants :

  • Android : appel fait à fetchPlace()
  • iOS : appel fait à fetchPlaceFromPlaceID:
  • Service Web : requête Places Details

La requête Autocomplete est disponible sans frais, et l'appel Place Details qui s'ensuit est facturé en fonction du tarif Place Details standard.

Une requête Places Details génère des codes SKU Data (Basic, Contact et/ou Atmosphere), en fonction des champs spécifiés dans la requête.

Si vous ne précisez pas de champs dans la requête Places Details, tous les codes SKU Data sont déclenchés (Basic, Contact et Atmosphere).

Les requêtes d'actualisation d'ID Place Details (requêtes qui ne spécifient que le champ place_id) lors d'une session Autocomplete sont facturées comme code SKU Autocomplete without Place Details – Per Session.

VOLUME MENSUEL
(prix par SESSION)
0-100 000 100 001-500 000 + de 500 000
0,00 USD 0,00 USD 0,00 USD

Exemple

Si votre application émet les trois appels suivants au cours d'une même session :

Android

iOS

Service Web

Sur votre facture, les codes SKU suivants sont indiqués (lorsque vous affichez votre facture par code SKU) :

  • Autocomplete (included with Place Details) – Per Session (facturé à 0,00 USD)
  • Place Details (prix à partir de 0,017 USD par session)
  • Basic Data (facturé à 0 USD)

Code SKU : Query Autocomplete – Per Request

Un code SKU Query Autocomplete – Per Request est facturé pour chaque requête envoyée aux éléments suivants :

VOLUME MENSUEL
(prix par REQUÊTE)
0-100 000 100 001-500 000 + de 500 000
0,00283 USD prix unitaire
(2,83 USD pour 1 000)		 0,00227 USD prix unitaire
(2,27 USD pour 1 000)		 Contactez le service commercial pour connaître le prix sur d'autres volumes

La tarification par session Autocomplete n'est pas compatible avec la requête Query Autocomplete. Les appels Places Details qui s'ensuivent sont facturés en fonction du tarif Places Details standard.

Code SKU : Place Details

Les appels Place Details sont facturés comme suit :

VOLUME MENSUEL
(prix par APPEL)
0-100 000 100 001-500 000 + de 500 000
0,017 USD prix unitaire
(17,00 USD pour 1 000)		 0,0136 USD prix unitaire
(13,60 USD pour 1 000)		 Contactez le service commercial pour connaître le prix sur d'autres volumes

Le code SKU Place Details est généré à partir des API suivantes :

Avec l'API et les services Web, le code SKU Place Details est facturé, qu'un jeton de session soit fourni ou non.

Un appel ou une requête Place Details génère également des codes SKU Data (Basic, Contact et/ou Atmosphere), en fonction des champs spécifiés dans l'appel ou la requête. Si AUCUN champ dans l'appel ou la requête Places Details, TOUS les codes SKU Data sont déclenchés et vous êtes facturé pour l'appel ou la requête Places Details, ainsi que pour le coût de toutes les données.

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 et ne spécifiez que le champ d'adresse : getPlaceDetails(fields: formatted_address)
    Sur votre facture, les codes SKU suivants sont indiqués (lorsque vous affichez votre facture par code SKU) :
    • Place Details (prix à partir de 0,017 USD par session)
    • Basic Data (facturé à 0 USD)
  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 et spécifiez le champ du numéro de téléphone : getPlaceDetails(fields: formatted_phone_number)
    Sur votre facture, les codes SKU suivants sont indiqués (lorsque vous affichez votre facture par code SKU) :
    • Place Details (prix à partir de 0,017 USD par session)
    • Contact Data (prix à partir de 0,003 USD par requête)
  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 Places Details 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 codes SKU suivants sont indiqués (lorsque vous affichez votre facture par code SKU) :
    • Place Details (prix à partir de 0,017 USD par session)
    • Basic Data (facturé à 0 USD)
    • Contact Data (prix à partir de 0,003 USD par requête)
    • Atmosphere Data (prix à partir de 0,005 USD par requête)

Code SKU : Place Details – ID Refresh

Utilisez la requête Place Details pour mettre à jour les ID de lieu non actualisés. Les requêtes de ce type sont disponibles sans frais.

VOLUME MENSUEL
(prix par APPEL)
0-100 000 100 001-500 000 + de 500 000
0,00 USD 0,00 USD 0,00 USD

Exemple

Effectuez une requête Places Details en ne spécifiant que le champ d'identifiant de lieu : getPlaceDetails(fields: place_id). Sur votre facture, le code SKU suivant est indiqué (lorsque vous affichez votre facture par code SKU) :

  • Place Details – ID Refresh (facturé à 0 USD)

Code SKU : Find Place

Le code SKU Find Place est facturé par requête Find Place.

VOLUME MENSUEL
(prix par APPEL)
0-100 000 100 001-500 000 + de 500 000
0,017 USD prix unitaire
(17,00 USD pour 1 000)		 0,0136 USD prix unitaire
(13,60 USD pour 1 000)		 Contactez le service commercial pour connaître le prix sur d'autres volumes

Les requêtes Find Place génèrent aussi des codes SKU Data (Basic, Contact et/ou Atmosphere), en fonction des champs spécifiés dans la requête. Comme c'est le cas pour les requêtes Place Details, vous pouvez utiliser le paramètre "fields" dans votre requête Find Place afin de limiter la réponse à ces champs spécifiés uniquement. Les requêtes Find Place et les données demandées vous sont facturées. Par défaut, si AUCUN champ n'est demandé, seul l'identifiant de lieu est renvoyé. Par conséquent, aucuns frais de données supplémentaires ne sont facturés.

Exemples

  1. Vous exécutez une requête Find Place et ne spécifiez que le champ d'adresse : FindPlace(fields: formatted_address). Sur votre facture, les codes SKU suivants sont indiqués (lorsque vous affichez votre facture par code SKU) :
    • Find Place (prix à partir de 0,017 USD par appel)
    • Basic Data (facturé à 0 USD)
  2. Vous exécutez une requête Find Place et spécifiez le champ du numéro de téléphone : FindPlace(fields: formatted_phone_number). Sur votre facture, les codes SKU suivants sont indiqués (lorsque vous affichez votre facture par code SKU) :
    • Find Place (prix à partir de 0,017 USD par appel)
    • Contact Data (prix à partir de 0,003 USD par requête)
  3. Vous effectuez une requête Find Place et spécifiez des champs provenant des trois buckets de types de données : FindPlace(fields: formatted_address, opening_hours, price_level). Sur votre facture, les codes SKU suivants sont indiqués (lorsque vous affichez votre facture par code SKU) :
    • Find Place (prix à partir de 0,017 USD par appel)
    • Basic Data (facturé à 0 USD)
    • Contact Data (prix à partir de 0,003 USD par requête)
    • Atmosphere Data (prix à partir de 0,005 USD par requête)

Code SKU : Find Place – ID only

Le code SKU Find Place– ID only est facturé en fonction des requêtes Find Place qui ne spécifie que l'identifiant de lieu à renvoyer. Par défaut, si aucun champ n'est spécifié dans la requête Find Place, seul l'identifiant de lieu est renvoyé.

VOLUME MENSUEL
(prix par APPEL)
0-100 000 100 001-500 000 + de 500 000
0,00 USD 0,00 USD 0,00 USD

Exemple

Vous exécutez une requête Find Place et ne spécifiez que le champ place_id : FindPlace(fields: place_id). Sur votre facture, le code SKU suivant est indiqué (lorsque vous affichez votre facture par code SKU) :

  • Find Place – ID only (facturé à 0,00 USD)

Un code SKU Place - Nearby Search est facturé pour les requêtes envoyées au service Place Nearby Search de l'API Maps JavaScript (nearbySearch()) ou au service Nearby Search de l'API Places

VOLUME MENSUEL
(prix par APPEL)
0-100 000 100 001-500 000 + de 500 000
0,032 USD prix unitaire
(32,00 USD pour 1 000)		 0,0256 USD prix unitaire
(25,60 USD pour 1 000)		 Contactez le service commercial pour connaître le prix sur d'autres volumes

Les requêtes Nearby Search renvoient une liste de lieux, mais ne permettent pas de spécifier les champs renvoyés. Elles renvoient un sous-ensemble des champs de données compatibles. La requête Nearby Search vous est facturée à partir de 0,032 USD par requête, ainsi que pour tous les codes SKU de type données (Basic Data, Contact Data et Atmosphere Data).

Exemple

Vous effectuez une requête Nearby Search, par exemple : NearbySearch (San Francisco, 100 meters). Sur votre facture, les codes SKU suivants sont indiqués (lorsque vous affichez votre facture par code SKU) :

  • Place – Nearby Search (prix à partir de 0,032 USD par appel)
  • Basic Data (facturé à 0 USD)
  • Contact Data (prix à partir de 0,003 USD par requête)
  • Atmosphere Data (prix à partir de 0,005 USD par requête)

Code SKU : Place – Text Search

Un code SKU Place - Text Search est facturé pour les requêtes envoyées au service Places Text Search de l'API Maps JavaScript (textSearch()) ou au service Text Search de l'API Places

VOLUME MENSUEL
(prix par APPEL)
0-100 000 100 001-500 000 + de 500 000
0,032 USD prix unitaire
(32,00 USD pour 1 000)		 0,0256 USD prix unitaire
(25,60 USD pour 1 000)		 Contactez le service commercial pour connaître le prix sur d'autres volumes

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

Le SKU Place – Text Search est également généré par lewidget 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 de champ de recherche, après avoir saisi "pizza" dans le champ de recherche, vous remarquerez qu'une icône de loupe est affichée à côté de livraison de pizzas, indiquant qu'il s'agit d'une requête de lieu (et non d'un résultat).

Exemple

Vous effectuez une requête Text Search, par exemple : TextSearch(123 Main Street). Sur votre facture, les codes SKU suivants sont indiqués (lorsque vous affichez votre facture par code SKU) :

  • Place – Text Search (prix à partir de 0,032 USD par appel)
  • Basic Data (facturé à 0 USD)
  • Contact Data (prix à partir de 0,003 USD par requête)
  • Atmosphere Data (prix à partir de 0,005 USD par requête)

Code SKU : Place Photo

Un code SKU Place Photo est facturé pour :

Pour le service JavaScript, appeler la méthode PlacePhoto.getUrl() n'entraîne pas de facturation tant que l'URL n'est pas réellement utilisée pour obtenir les données de pixels.

VOLUME MENSUEL
(prix par APPEL)
0-100 000 100 001-500 000 + de 500 000
0,007 USD prix unitaire
(7,00 USD pour 1 000)		 0,0056 USD prix unitaire
(5,60 USD pour 1 000)		 Contactez le service commercial pour connaître le prix sur d'autres volumes

Autres limites d'utilisation

Bien qu'il n'y ait pas de nombre maximal de requêtes par jour, la limite d'utilisation suivante s'applique toujours lorsque vous utilisez l'API Places:

  • La limite est de 100 requêtes par seconde. Il s'agit de la somme des requêtes côté client et côté serveur pour toutes les applications utilisant les identifiants d'un même projet.

Restrictions liées aux conditions d'utilisation

Pour en savoir plus sur les conditions d'utilisation, consultez les Règles de l'API Places et la Section sur les restrictions de licence des conditions d'utilisation de Google Maps Platform.

Gérer vos coûts d'utilisation

Afin de gérer vos coûts d'utilisation des API Google Maps Platform, définissez des limites de quota quotidiennes pour toutes les requêtes adressées à une API facturable. Les quotas quotidiens sont réinitialisés à minuit, heure du Pacifique.

Pour afficher ou modifier les limites de quota de l'API Places:

  1. Dans la console Cloud, ouvrez la page Quotas Google Maps Platform.
  2. Cliquez sur le menu déroulant des API, puis sélectionnez API Places.
  3. Pour afficher les limites de quota, faites défiler la page jusqu'à la fiche Requêtes.
    Un tableau liste les noms et les limites de quota.
  4. Pour modifier une limite de quota, cliquez sur l'icône Modifier correspondante.
    Dans le champ Limite de quota de la boîte de dialogue qui s'affiche, saisissez la limite de quota quotidienne facturable souhaitée (dans la limite autorisée, si elle est spécifiée par Google), puis sélectionnez Enregistrer.

Si votre utilisation de l'API atteint la limite de quota facturable pour un jour donné, votre application ne pourra plus y accéder pendant le reste de cette journée.

  1. En Inde, les utilisateurs doivent créer un compte de facturation Google Cloud Platform avant de créer un compte de facturation Google Maps Platform afin de recevoir le crédit Maps Platform. ↩