Questions fréquentes sur le geocoding

Ces questions fréquentes abordent des points spécifiques concernant l'API Geocoding. Consultez la FAQ Google Maps Platform pour toutes les questions courantes concernant ce produit. Consultez également Bonnes pratiques pour géocoder des adresses.

Dépannage

Dépannage

J'obtiens plus de requêtes qui renvoient ZERO_RESULTS avec le geocoder. Que se passe-t-il ?

Dans le geocoder, les requêtes ambiguës, incomplètes et mal formatées, telles que des adresses mal orthographiées ou inexistantes, sont susceptibles de produire ZERO_RESULTS. Si l'adresse est introuvable, il est préférable de renvoyer ZERO_RESULTS plutôt qu'un résultat partiel (par exemple, en ne renvoyant que la banlieue au lieu d'une adresse).

Si votre application traite des adresses saisies par les utilisateurs, la fonctionnalité Place Autocomplete de l'API Places peut produire des résultats de meilleure qualité. Place Autocomplete permet aux utilisateurs de sélectionner un résultat parmi un ensemble de résultats en fonction de ce qu'ils ont saisi. Ils peuvent ainsi choisir entre des résultats portant des noms similaires et ajuster leur requête s'ils ont mal orthographié une adresse.

Si votre application traite des requêtes ambiguës ou incomplètes, ou des requêtes pouvant contenir des erreurs, nous vous recommandons d'utiliser la fonctionnalité Place Autocomplete de l'API Places plutôt que le geocoder standard disponible dans l'API Geocoding. Pour en savoir plus, consultez Bonnes pratiques pour géocoder des adresses et l' article de blog sur le géocodage d'adresses dans les API Google Maps.

J'ai besoin de réponses rapides, et le geocoder est trop lent pour mon application. Quels outils puis-je utiliser pour obtenir des réponses plus rapidement ?

Nous recommandons aux applications qui répondent aux saisies des utilisateurs et qui sont donc très sensibles à la latence d'utiliser la fonctionnalité Place Autocomplete de l'API Places (également disponible dans JavaScript, Android ou iOS) plutôt que le géocodage d'adresses. Comme la fonctionnalité Place Autocomplete est optimisée pour une utilisation interactive, elle assure une latence très faible.

Le géocodage d'adresse dans l'API Geocoding est optimisé pour être utilisé avec des adresses complètes, non ambiguës et bien formatées, telles que les adresses de livraison saisies dans des formulaires en ligne. Il présente donc une latence plus élevée que Place Autocomplete. Le geocodeur direct offre une couverture plus étendue et une meilleure qualité des résultats, mais avec une latence légèrement plus élevée.

Comment puis-je réduire la latence sur l'API Directions (ancienne) et l'API Distance Matrix (ancienne) ?

Au lieu d'adresses, utilisez des ID de lieu pour spécifier les points de cheminement, l'origine et la destination. Il est préférable d'obtenir les ID de lieu à partir de la fonctionnalité Place Autocomplete de l'API Places ou de la bibliothèque Places de l'API Maps JavaScript. Consultez également les informations sur l'option placeIdOnly, qui peut être utilisée pour réduire le coût de Place Autocomplete.

Lorsque l'API Directions (ancienne) ou l'API Distance Matrix (ancienne) sont interrogées avec une chaîne d'adresse plutôt qu'un ID de lieu ou des coordonnées de latitude/longitude, elles utilisent le même backend que l'API Geocoding pour convertir cette adresse en ID de lieu avant de calculer l'itinéraire. Place Autocomplete est plus rapide que le géocodage d'adresses. Pour les applications qui utilisent les anciennes API Directions ou Distance Matrix dans des situations très sensibles à la latence, comme la réponse à une saisie utilisateur, nous vous recommandons d'utiliser Place Autocomplete pour obtenir les ID de lieu correspondant à ces adresses, puis de transmettre ces ID aux anciennes API Directions ou Distance Matrix. Cette approche réduit considérablement la latence. Consultez notre documentation pour découvrir un exemple d'utilisation de Place Autocomplete avec des itinéraires.

Comment signaler des bugs dans le geocoder ?

Si vous avez des rapports de bug ou des demandes de fonctionnalités pour le service de géocodage direct, faites-le nous savoir à l'aide de notre outil public de suivi des problèmes.

Le géocodeur ne produit pas de bons résultats pour mon cas d'utilisation. Quelle est l'aide disponible ?

Faites-le-nous savoir en utilisant notre outil public de suivi des problèmes et en partageant quelques requêtes spécifiques. Nous pourrons ainsi déterminer si des bugs ou des problèmes systémiques affectent la qualité des résultats, ou si nous pouvons apporter des modifications au guide des bonnes pratiques pour aider les développeurs à obtenir de meilleurs résultats.

Comment obtenir les meilleurs résultats avec le geocoder en utilisant le filtrage par composants ?

Dans le geocoder, le filtrage des composants n'applique que les restrictions postal_code et country. Les exemples suivants illustrent la meilleure façon d'utiliser le filtrage des composants, en fonction des résultats dont vous avez besoin. Dans les URL de requête d'exemple, veillez à remplacer `YOUR_API_KEY` par votre clé API réelle.

  • Pour limiter les codes postaux à un pays spécifique, veillez à spécifier la restriction géographique à l'aide d'un code pays ISO 3166-2. Par exemple, components=country:CH|postal_code:8000 renvoie "8000 Zurich, Suisse". 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • Pour limiter les requêtes à un pays spécifique, veillez à spécifier la restriction de pays à l'aide d'un code pays ISO 3166-2. Les noms de pays et d'autres abréviations peuvent ne pas produire les mêmes résultats que les codes pays.

    Exemples :

    • Le géocodage de components=country:FRA|locality:gallus renvoie la sous-localité de Gallus à Francfort-sur-le-Main, en Allemagne. En effet, le code pays à trois lettres pour la France (FRA) n'est pas accepté. Par conséquent, les résultats dans n'importe quel pays sont autorisés, et le résultat à Francfort correspond mieux à la requête que ceux en France. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • L'API Geocoding ne renvoie pas nécessairement plusieurs résultats pour les requêtes ambiguës. La saisie semi-automatique de lieux est plus adaptée pour répondre à ces requêtes.

    Exemples :

    • Le géocodage de components=country:US|locality:madrid renvoie "Madrid, NM 87010, USA", mais aucune des autres villes des États-Unis nommées "Madrid". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • Si vous utilisez Place Autocomplete pour input=madrid&components=country:us&types=(regions) et que vous spécifiez également une fenêtre d'affichage à l'aide de location et radius pour biaiser les résultats de localisation, vous obtenez une réponse avec plusieurs villes des États-Unis nommées "Madrid". 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY