À 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 envoyé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) ni 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 du SKU de paiement à l'usage 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 limitation du 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 (ancienne version) : la limitation du 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 économiques 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
Le masquage de champ vous permet de ne pas demander de données inutiles, ce qui réduit 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 vos applications ont un volume d'appels mensuel de
Pour en savoir plus, consultez Autocomplete (New) and session pricing (Autocomplete (New) et tarification des sessions).
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 :
- 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 sélectionnez-la à l'aide de la case à cocher.
- 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 les demandes passées et en attente, procédez comme suit :
- 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.