À 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 (nouveau)
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 (nouveau). 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 Places Details (New) ni aucune requête 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.
Un jeton de session ne convient que pour une seule session. 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'avait été fourni.
Détails et tarifs des SKU pour l'API Places
Le tableau suivant indique les détails et les tarifs des SKU pour l'API Places.
Limites d'utilisation
Pour examiner et gérer vos quotas et limites d'utilisation, consultez Quotas et alertes de quota.
API Places (nouvelle version) : la limite de débit par minute s'applique à chaque méthode d'API par projet. Autrement dit, chaque méthode d'API dispose d'un quota distinct.
API Places (ancienne version) : la limite de fréquence par minute est calculée en additionnant les 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écifiques 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 la valeur d'un quota pour votre API, procédez comme suit :
- Dans la console Cloud, accédez à Google Maps Platform > Quotas.
- Sélectionnez l'API pour laquelle vous souhaitez modifier le quota.
- Identifiez la valeur de quota que vous souhaitez modifier, puis cochez la case correspondante.
- Cliquez sur Modifier, saisissez une nouvelle valeur de quota, puis cliquez sur Envoyer la demande.
Afficher les demandes d'augmentation de quota
Pour afficher toutes les demandes d'augmentation de quota, y compris celles en attente et celles qui ont été traitées :
- Dans la console Cloud, accédez à Google Maps Platform > Quotas.
- Sélectionnez l'API pour laquelle vous souhaitez afficher la demande d'augmentation de quota.
- 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 licences des conditions d'utilisation de Google Maps Platform.