Questions fréquentes sur le geocoding

Ces questions fréquentes portent sur 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 de geocoding d'adresses.

Dépannage

Dépannage

J'obtiens plus de requêtes renvoyant ZERO_RESULTS avec le geocoder. Pourquoi ?

Dans le geocoder, 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 est introuvable, ZERO_RESULTS est préférable à un résultat partiel (par exemple, en indiquant uniquement la 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 produire des résultats de meilleure qualité. Place Autocomplete permet aux utilisateurs de faire leur choix dans un ensemble de résultats en fonction de ce qu'ils ont saisi, ce qui leur permet de choisir entre des résultats portant un nom similaire et d'ajuster leur requête si une adresse est mal orthographiée.

Si votre application traite des requêtes ambiguës ou incomplètes ou susceptibles de 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 les bonnes pratiques pour le geocoding d'adresses et l' article de blog sur le geocoding d'adresses dans 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 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 dans JavaScript, Android ou iOS) plutôt que le geocoding d'adresses. Comme la fonctionnalité Place Autocomplete est optimisée pour une utilisation interactive, elle assure une latence très faible.

Le geocoding d'adresses dans l'API Geocoding est optimisé pour être utilisé avec des adresses complètes, claires 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 geocoder avant offre une plus grande couverture et une meilleure qualité de résultats, mais avec une latence un peu plus élevée.

Comment atténuer la latence sur les API Directions et Distance Matrix ?

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

Lorsque les API Directions ou Distance Matrix sont interrogées avec une chaîne d'adresse plutôt qu'un identifiant 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 l'itinéraire. Place Autocomplete est plus rapide que le geocoding d'adresses. Pour les applications qui utilisent l'API Directions ou Distance Matrix dans des situations très sensibles à la latence, par exemple pour répondre à une saisie 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 à 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 des itinéraires.

Comment signaler des bugs dans le geocoder ?

Si vous avez des rapports de bugs ou des demandes de fonctionnalités concernant le service de geocoder vers l'avant, veuillez nous en informer via notre outil public de suivi des problèmes.

Les résultats du geocoder ne sont pas satisfaisants pour mon cas d'utilisation. Quelle est l'aide disponible ?

Veuillez nous en informer à l'aide de notre outil public de suivi des problèmes en nous envoyant quelques requêtes spécifiques. Nous pourrons ainsi rechercher d'éventuels bugs ou problèmes systémiques à l'origine de problèmes de qualité des résultats, ou si nous pourrions apporter des modifications au guide des bonnes pratiques pour aider les développeurs à obtenir de meilleurs résultats.

Comment obtenir les meilleurs résultats possible avec le geocoder grâce au filtrage par composants ?

Dans le geocoder, le filtrage par 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 restreindre les codes postaux à un pays spécifique, veillez à spécifier la restriction par 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 locale à 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 geocoding pour components=country:FRA|locality:gallus renvoie la sous-localité de Gallus à Francfort-sur-le-Main, en Allemagne. En effet, le code pays à trois lettres correspondant à la France (FRA) n'est pas accepté. Par conséquent, les résultats dans tous les pays sont autorisés, et le résultat pour Francfort est plus adapté que tous les autres pays 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, USA", mais aucune des autres villes des États-Unis nommée "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 pondérer les résultats de localisation génèrent une réponse avec plusieurs villes des États-Unis nommée "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