La saisie semi-automatique d'adresses est un type de requête différent d'une simple recherche de géocodage : elle doit répondre à une saisie partielle et changeante plutôt qu'à une seule adresse terminée, généralement pendant que quelqu'un tape dans un formulaire. Nous avons étendu nos hôtes compatibles pour prendre en charge ce schéma également, en reprenant la forme des requêtes de saisie semi-automatique des fournisseurs qui la proposent.
Cela vient s'ajouter à notre endpoint natif /v1/autocomplete, documenté sur /docs/address-autocomplete/, qui traite directement le même type de requête d'adresse partielle. Chaque fois que le fournisseur d'origine d'un hôte compatible propose aussi la saisie semi-automatique, cette même forme de requête est désormais prise en charge sur notre hôte équivalent, à l'exception des mentions de droits d'auteur, des conditions et des textes de confidentialité, qui sont les nôtres.
L'authentification et la tarification des requêtes de saisie semi-automatique suivent exactement les mêmes règles que tous les autres types de requêtes de la plateforme. Une clé s'authentifie via un en-tête X-API-Key, un en-tête Authorization: Bearer, l'authentification HTTP Basic ou un paramètre de requête, et l'utilisation est décomptée du même quota quotidien gratuit, que ce quota provienne du réseau appelant ou de la clé elle-même. Au-delà du quota gratuit, les requêtes de saisie semi-automatique sont prélevées sur le crédit prépayé à 0,0001 € la requête ou couvertes par un forfait Unlimited, exactement comme pour tout autre endpoint.
Le trafic de saisie semi-automatique suit généralement un rythme différent d'une recherche de géocodage classique, se déclenchant souvent à chaque frappe pendant que quelqu'un tape une adresse dans un formulaire, plutôt qu'une fois par envoi terminé. La visibilité sur le quota est donc particulièrement utile ici : les mêmes en-têtes de quota joints à chaque réponse, X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining et les autres, permettent à une intégration de suivre la consommation en temps réel et d'adapter son comportement, par exemple en appliquant un debounce plus agressif aux requêtes, si l'utilisation est plus élevée que prévu.
Pour les équipes qui utilisent déjà un hôte compatible pour le géocodage et gèrent séparément la saisie semi-automatique via un autre fournisseur ou une seconde intégration, cette mise à jour signifie que la saisie semi-automatique peut désormais passer sur le même hôte et la même clé, regroupant les deux types de requêtes sous un seul compte au lieu de les répartir entre deux.
Les hôtes compatibles qui prennent en charge la saisie semi-automatique dépendent de sa prise en charge par leur fournisseur d'origine, et les détails de chacun sont documentés sur la page propre à cet hôte, accessible depuis la liste complète sur /compatibility/. Tester la saisie semi-automatique sur un hôte compatible ne coûte rien, grâce au quota gratuit dont dispose toute nouvelle clé.