Questions fréquentes sur le geocoding

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette FAQ couvre les questions propres à l'API Geocoding. Consultez les Questions fréquentes sur Google Maps Platform. Consultez également Bonnes pratiques de géocodage des adresses.

Dépannage

Dépannage

Je reçois plus de requêtes qui renvoient ZERO_RESULTS avec le geocoder. Pourquoi ?

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

Si votre application gère la saisie d'adresses par les utilisateurs, la fonctionnalité Place Autocomplete de l'API Places peut offrir de meilleurs résultats. Place Autocomplete permet aux utilisateurs de choisir parmi un ensemble de résultats en fonction de leur saisie, ce qui leur permet de choisir entre des résultats portant un nom similaire, et d'ajuster leur requête s'ils ont mal orthographié une adresse.

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

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

Nous vous recommandons d'utiliser la fonctionnalité Place Autocomplete de l'API Places (également disponible en JavaScript, Android ou iOS) pour les applications qui réagissent aux entrées des utilisateurs, plutôt que pour le geocoding. Comme la fonctionnalité Place Autocomplete est optimisée pour une utilisation interactive, elle assure une latence très faible.

Le geocoding des adresses dans l'API Geocoding est optimisé pour être utilisé avec des adresses complètes, non ambiguës et correctement formatées, comme les adresses de livraison saisies dans les formulaires en ligne. Il présente donc une latence plus élevée que Place Autocomplete. Le geocoder avant contient une couverture plus large et des résultats de meilleure qualité, mais avec une latence plus élevée.

Comment réduire la latence des API Directions et Distance Matrix ?

Au lieu des adresses, utilisez les ID de lieux pour spécifier les points de cheminement, le point de départ et la destination. Il est préférable d'obtenir les identifiants de lieu à l'aide de la fonctionnalité Place Autocomplete de l'API Places ou de la bibliothèque Places dans l'API Maps JavaScript. Consultez également les informations sur l'option placeIdOnly, qui permet de réduire le coût de Place Autocomplete.

Lorsque l'API Directions ou Distance Matrix est interrogée avec une chaîne d'adresse plutôt qu'un ID de lieu ou des coordonnées latlng, elle utilise 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 des adresses. Pour les applications qui utilisent l'API Directions ou l'API Distance Matrix dans des situations très sensibles à la latence, telles que la réponse aux entrées utilisateur, nous vous recommandons d'utiliser Place Autocomplete pour obtenir les ID de lieu correspondant à ces adresses, et de les transmettre à l'API Directions ou Distance Matrix. Cette approche réduit considérablement la latence. Consultez notre documentation pour obtenir un exemple d'utilisation de Place Autocomplete avec un itinéraire.

Comment signaler des bugs dans le geocoder ?

Si vous avez des rapports de bugs ou des demandes de fonctionnalités pour le service de géocodage de redirection, veuillez nous en informer à l'aide de notre outil de suivi des problèmes public.

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

N'hésitez pas à nous contacter en utilisant notre outil de suivi des problèmes public. Vous pourrez ainsi nous envoyer quelques requêtes spécifiques afin que nous puissions déterminer si des bugs ou des problèmes systémiques entraînent des problèmes de qualité des résultats, ou si nous pouvons modifier le guide des bonnes pratiques afin d'aider les développeurs à améliorer leurs résultats.

Comment obtenir de 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 par composants, en fonction des résultats dont vous avez besoin. Dans les exemples d'URL de requête, veillez à remplacer "YOUR_API_KEY" par votre clé API.

  • Pour limiter les codes postaux à un pays spécifique, spécifiez la restriction à l'aide d'un code pays au format 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, spécifiez la restriction à l'aide d'un code pays au format ISO 3166-2. Il n'est pas garanti que les noms de pays et les autres abréviations produisent 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 à trois lettres de la France (FRA) n'est pas accepté. Par conséquent, tous les pays sont autorisés, et le résultat à Francfort est plus adapté que tout autre produit 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. Place Autocomplete permet de mieux répondre à ces requêtes.

    Exemples :

    • Le geocoding pour components=country:US|locality:madrid renvoie "Madrid, NM 87010, États-Unis", 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
    • L'utilisation de Place Autocomplete pour input=madrid&components=country:us&types=(regions), ainsi que la spécification d'une fenêtre d'affichage à l'aide de location et radius pour pondérer les résultats des établissements, génère 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