À 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 avec paiement à l'usage pour l'API Places.
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. En d'autres termes, 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.
Stratégies rentables pour l'API Places
Cette section explique comment optimiser votre utilisation et réduire les coûts associés à l'API Places.
Utiliser des masques de champ
L'utilisation du masquage de champ vous permet de ne pas demander de données inutiles, ce qui contribue à réduire la latence et les frais de facturation.
Pour les requêtes Place Details (New), Nearby Search (New) et Text Search (New), utilisez un masque de champ pour 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 exemple, si vous sélectionnez des champs à la fois dans les SKU Essentials et Pro, vous serez facturé sur le SKU Pro.
Utiliser la tarification par session avec Place Details (New)
Si le volume d'appels mensuel de vos applications est compris entre
Pour en savoir plus, consultez Tarification par session et Autocomplete (New).
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 dans un délai donné. Lorsque le nombre de requêtes de 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 :
- 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 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 :
- 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.