Utilisation et facturation de l'API Places

À propos des masques de champ

Pour Place Details (New), Nearby Search (New) et Text Search (New), utilisez l'en-tête FieldMask dans les requêtes API afin de spécifier la liste des champs à renvoyer dans la réponse. Vous serez ensuite facturé selon le SKU le plus élevé applicable à votre requête. Par conséquent, si vous sélectionnez des champs à la fois dans les SKU Essentials et Pro, vous serez facturé sur le SKU Pro.

Le masquage de champ est une bonne pratique à appliquer pour vous assurer de ne pas demander de données inutiles. Vous pourrez ainsi réduire le temps de traitement et les frais facturés.

À propos des sessions Autocomplete (New)

Une session Autocomplete (New) inclut une ou plusieurs requêtes Autocomplete (New), ainsi qu'une requête Place Details (New) ou Address Validation. Le même jeton de session est transmis à la requête Autocomplete (New), puis à la requête Place Details (New) ou Address Validation qui s'ensuit.

Une session commence par la première requête Autocomplete (New). Une requête Place Details (New) ou Address Validation est ensuite effectuée lorsque l'utilisateur a sélectionné l'une des suggestions Autocomplete (New). Si une session est abandonnée, c'est-à-dire qu'aucune requête Place Details (New) ou Address Validation n'est effectuée, les requêtes Autocomplete (New) sont facturées comme si aucun jeton de session n'avait été fourni.

Une fois qu'un utilisateur a sélectionné un lieu (c'est-à-dire qu'une requête Place Details (New) ou Address Validation est effectuée), vous devez démarrer une nouvelle session à l'aide d'un nouveau jeton de session.

Un jeton de session ne convient que pour une seule session. 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.

Détails et tarifs des SKU pour l'API Places

Le tableau suivant présente les détails et les tarifs des SKU pour l'API Places.

CatégorieDétails des SKU pour l'API Places (New)Tarifs des SKU
Essentials SKU : Requêtes Autocomplete Liste de prix principale
Liste de prix pour l'Inde
Essentials SKU: Autocomplete Session Usage Liste de prix principale
Liste de prix pour l'Inde
Essentials SKU: Place Details Essentials (IDs Only) Liste de prix principale
Liste de prix pour l'Inde
Essentials SKU: Place Details Essentials Liste de prix principale
Liste de prix pour l'Inde
Essentials SKU: Text Search Essentials (IDs Only) Liste de prix principale
Liste de prix pour l'Inde
Pro SKU: Nearby Search Pro Liste de prix principale
Liste de prix pour l'Inde
Pro SKU: Place Details Pro Liste de prix principale
Liste de prix pour l'Inde
Pro SKU: Text Search Pro Liste de prix principale
Liste de prix pour l'Inde
Enterprise SKU: Nearby Search Enterprise Liste de prix principale
Liste de prix pour l'Inde
Enterprise SKU: Nearby Search Enterprise + Atmosphere Liste de prix principale
Liste de prix pour l'Inde
Enterprise SKU: Place Details Enterprise Liste de prix principale
Liste de prix pour l'Inde
Enterprise SKU: Place Details Enterprise + Atmosphere Liste de prix principale
Liste de prix pour l'Inde
Enterprise SKU: Text Search Enterprise Liste de prix principale
Liste de prix pour l'Inde
Enterprise SKU: Text Search Enterprise + Atmosphere Liste de prix principale
Liste de prix pour l'Inde
Enterprise SKU: Place Details Photos Liste de prix principale
Liste de prix pour l'Inde
CatégorieDétails des SKU pour l'API Places (Legacy)Tarifs des SKU
Essentials SKU : Autocomplete – Per Request Liste de prix principale
Liste de prix pour l'Inde
Essentials SKU : Autocomplete (included with Place Details) – Per Session Liste de prix principale
Liste de prix pour l'Inde
Essentials

SKU: Basic Data

Frais supplémentaires :

Liste de prix principale
Liste de prix pour l'Inde
Essentials SKU : Find Place – ID only Liste de prix principale
Liste de prix pour l'Inde
Essentials SKU : Place Details Essentials – ID Refresh Liste de prix principale
Liste de prix pour l'Inde
Essentials SKU : Query Autocomplete – Per Request Liste de prix principale
Liste de prix pour l'Inde
Pro SKU : Autocomplete without Place Details – Per Session Liste de prix principale
Liste de prix pour l'Inde
Pro

SKU: Find Place

Frais supplémentaires :

Liste de prix principale
Liste de prix pour l'Inde
Pro

SKU : Places – Nearby Search

Frais supplémentaires :

Liste de prix principale
Liste de prix pour l'Inde
Pro

SKU : Places – Text Search

Frais supplémentaires :

Liste de prix principale
Liste de prix pour l'Inde
Pro

SKU: Places Details

Frais supplémentaires :

Liste de prix principale
Liste de prix pour l'Inde
Enterprise

SKU: Atmosphere Data

Frais supplémentaires :

Liste de prix principale
Liste de prix pour l'Inde
Enterprise

SKU: Contact Data

Frais supplémentaires :

Liste de prix principale
Liste de prix pour l'Inde
Enterprise SKU: Place Photos Liste de prix principale
Liste de prix pour l'Inde

Limites d'utilisation

Pour consulter et gérer vos quotas et limites d'utilisation, consultez Quotas et alertes de quota.

  • API Places (New) : la limite de débit par minute s'applique par méthode d'API et par projet. Cela signifie que chaque méthode d'API dispose d'un quota distinct.

  • API Places (Legacy) : la limite de débit par minute est calculée comme la somme des requêtes côté client et côté serveur pour toutes les applications utilisant les identifiants du même projet.

Ajuster le quota

Les limites de quota définissent le nombre maximal de requêtes autorisées pour une API ou un service spécifique au cours d'une période donnée. Lorsque le nombre de requêtes dans votre projet atteint la limite de quota, votre service cesse de répondre aux requêtes.

Pour modifier une valeur de quota pour votre API, procédez comme suit :

  1. Dans la console Cloud, accédez à Google Maps Platform > Quotas.
  2. Sélectionnez l'API pour laquelle vous souhaitez modifier le quota.
  3. Identifiez la valeur de quota que vous souhaitez modifier, puis cochez la case correspondante.
  4. Cliquez sur Modifier, saisissez une nouvelle valeur de quota, puis cliquez sur Envoyer la requête.

Afficher les demandes d'augmentation de quota

Pour afficher toutes les demandes d'augmentation de quota, y compris les demandes passées et en attente :

  1. Dans la console Cloud, accédez à Google Maps Platform > Quotas.
  2. Sélectionnez l'API pour laquelle vous souhaitez afficher la demande d'augmentation de quota.
  3. Cliquez sur Augmenter les demandes.

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 Restrictions liées aux conditions de licence dans les conditions d'utilisation Google Maps Platform.