Questions fréquentes sur le geocoding

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

Dépannage

Dépannage

Je reçois de plus en plus de requêtes qui renvoient ZERO_RESULTS avec le géocodeur. Que se passe-t-il ?

Dans le géocodeur, les requêtes ambiguës, incomplètes et mal formatées, telles que les adresses mal orthographiées ou inexistantes, sont susceptibles de générer ZERO_RESULTS. Si l'adresse ne peut pas être trouvée, ZERO_RESULTS est préférable à un résultat partiel (par exemple, renvoyer uniquement le quartier au lieu d'une adresse).

Si votre application traite des adresses saisies par l'utilisateur, la fonctionnalité Place Autocomplete de l'API Places peut produire des résultats de meilleure qualité. Place Autocomplete permet aux utilisateurs de choisir parmi un ensemble de résultats en fonction de ce qu'ils ont saisi. Ils peuvent ainsi choisir entre des résultats portant un nom similaire 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 susceptibles de 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 les bonnes pratiques pour géocoder des adresses et l'article de blog Géocoder des adresses dans les API Google Maps.

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

Nous recommandons aux applications qui répondent aux entrées utilisateur et qui sont donc très sensibles à la latence d'utiliser la fonctionnalité Place Autocomplete de l'API Places (également disponible en 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.

La géolocalisation des adresses dans l'API Geocoding est optimisée pour les adresses complètes, sans ambiguïté et bien formatées, telles que les adresses de livraison saisies dans des formulaires en ligne. Elle présente donc une latence plus élevée que Place Autocomplete. Le géocodeur direct offre une couverture plus étendue et une meilleure qualité de résultat, mais avec une latence légèrement plus élevée.

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

Au lieu d'utiliser des adresses, utilisez des ID de lieu pour spécifier les points de cheminement, le point de départ 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 les coûts de Place Autocomplete.

Lorsque l'API Directions ou l'API Distance Matrix est interrogée avec une chaîne d'adresse plutôt qu'un ID de lieu ou une latitude/longitude, elles utilisent le même backend que l'API Geocoding pour convertir cette adresse en ID de lieu avant de calculer un 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 aux temps de latence, telles que la réponse aux entrées utilisateur, nous vous recommandons d'utiliser Place Autocomplete pour obtenir les identifiants de lieu correspondant à ces adresses, puis de les transmettre à l'API Directions ou à l'API Distance Matrix. Cette approche réduit considérablement la latence. Consultez notre documentation pour obtenir un exemple d'utilisation de Place Autocomplete avec les itinéraires.

Comment signaler des bugs dans le géocodeur ?

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

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

Pour nous en informer, utilisez notre outil de suivi des problèmes public et partagez quelques requêtes spécifiques. Nous pourrons ainsi déterminer s'il existe des bugs ou des problèmes systémiques qui 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 géocodeur à l'aide du filtrage par composants ?

Dans le géocodeur, le filtrage des composants n'applique que les restrictions postal_code et country. Les exemples suivants montrent comment utiliser au mieux le filtrage des composants, en fonction des résultats dont vous avez besoin. Dans les exemples d'URL de requête, veillez à remplacer "VOTRE_CLÉ_API" par votre clé API réelle.

  • Pour limiter les codes postaux à un pays spécifique, veillez à spécifier la restriction de pays à l'aide d'un code pays ISO 3166-2. Par exemple, components=country:CH|postal_code:8000 renvoie "8000 Zürich, 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. Il n'est pas garanti que les noms de pays et 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 pays de trois lettres pour la France (FRA) n'est pas accepté. Par conséquent, les résultats de n'importe quel pays sont autorisés, et le résultat de Francfort correspond mieux que tout autre résultat 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. Ces requêtes sont mieux traitées par Place Autocomplete.

    Exemples :

    • Le géocodage de components=country:US|locality:madrid renvoie "Madrid, NM 87010, États-Unis", mais aucune autre ville des États-Unis ne porte le nom de "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) et la spécification d'une fenêtre d'affichage à l'aide de location et radius pour orienter les résultats de localisation génère une réponse avec plusieurs villes aux É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