API de saisie semi-automatique d'adresses

Suggérez des adresses, des rues, des villes et des lieux pendant la saisie. Chaque suggestion porte ses propres coordonnées et sa précision : quand l'utilisateur en choisit une, vous avez déjà tout ce dont vous avez besoin. Pas de jetons de session, pas d'appel de détails séparé, pas de tarification par session.

GEThttps://api.mygeocode.com/v1/autocomplete?q=...

Essayer dans la démo Référence complète

Exemple

Requête

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/autocomplete?q=10+Downing&country=gb&limit=3"

Les réponses sont optimisées pour la saisie : elles reviennent en quelques dizaines de millisecondes et tolèrent les lettres manquantes et les mots inversés. Envoyez proximity=lat,lon pour classer d'abord les lieux proches, ce qui compte beaucoup pour les noms de rue présents dans de nombreuses villes.

Appliquez un anti-rebond d'environ 150 ms aux frappes. Choisir une adresse type nécessite de 4 à 6 requêtes.

Réponse

{
  "status": "ok",
  "query": "10 Downing",
  "suggestions": [
    {
      "text": "10 Downing Street, London SW1A 2AA, United Kingdom",
      "lat": 51.503396,
      "lon": -0.12764,
      "type": "address",
      "precision": "house",
      "place_id": "gb.addr.7f3c2a19"
    },
    {
      "text": "10 Downing Place, Cambridge CB2 3EN, United Kingdom",
      "lat": 52.203042,
      "lon": 0.121811,
      "type": "address",
      "precision": "house",
      "place_id": "gb.addr.a01d9e44"
    },
    {
      "text": "10 Downing Road, Dagenham RM9 6NP, United Kingdom",
      "lat": 51.536118,
      "lon": 0.137204,
      "type": "address",
      "precision": "house",
      "place_id": "gb.addr.c58b7e02"
    }
  ]
}

Ce que vous recevez

Champ	Signification
`text`	La suggestion telle qu'elle doit être affichée, sur une ligne.
`lat`, `lon`	Coordonnées de la suggestion. Présentes sur chaque suggestion.
`type`	`address`, `street`, `postcode`, `city`, `region`, `country` ou `poi`.
`precision`	Les mêmes quatre valeurs que pour le géocodage.
`place_id`	Un identifiant stable. Transmettez-le à `/v1/forward?place_id=...` si vous voulez les éléments complets et l'emprise de la suggestion choisie.

Où elle est utilisée

Formulaires d'adresse au paiement

Un champ au lieu de six. Le place_id de la suggestion choisie récupère les éléments pour remplir le reste du formulaire.

Champs de recherche sur les cartes

Transmettez le centre de la carte comme proximity pour que « Grande Rue » désigne celle qui est à l'écran.

Remplacer Places Autocomplete

Le remplacement compatible de Google Maps JavaScript fournit google.maps.places.Autocomplete reposant sur cet endpoint, sans tarification par session.

Prix et limites

Chaque appel compte pour une requête. Il n'y a pas de tarification par session ni de frais séparés pour le choix d'une suggestion. Chaque clé dispose de 2 500 requêtes gratuites par jour ; au-delà, 0,0001 € chacune en crédit prépayé, ou rien avec une clé Unlimited (50 € par mois). Tarifs.