Questions fréquentes sur le geocoding
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 ayant 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.
Le géocodage d'adresses dans l'API Geocoding est optimisé pour les adresses complètes, sans ambiguïté 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 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 l'API Directions (ancienne) et l'API Distance Matrix (ancienne) ?
-
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 (ancienne) ou l'API Distance Matrix (ancienne) 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 (ancienne) ou l'API Distance Matrix (ancienne) 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, puis de les transmettre à l'API Directions (ancienne) ou à l'API Distance Matrix (ancienne).
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. Les noms de pays et autres abréviations ne donnent pas toujours 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 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
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eThis FAQ addresses questions about the Geocoding API; for general Google Maps Platform questions, refer to the Google Maps Platform FAQ.\u003c/p\u003e\n"],["\u003cp\u003eFor applications with user input and latency sensitivity, Google recommends using Place Autocomplete instead of address geocoding for better results and speed.\u003c/p\u003e\n"],["\u003cp\u003eTo improve latency with the Directions or Distance Matrix APIs, use place IDs obtained from Place Autocomplete instead of addresses.\u003c/p\u003e\n"],["\u003cp\u003eYou can report bugs or request features for the Geocoding API through the public issue tracker.\u003c/p\u003e\n"],["\u003cp\u003eComponent filtering in the Geocoding API is primarily used to restrict results by country and postal code.\u003c/p\u003e\n"]]],[],null,["This FAQ covers questions specific to the Geocoding API.\nRefer to the [Google Maps Platform FAQ](/maps/faq) for questions\ncommon to all Google Maps Platform. See also\n[Best Practices When Geocoding Addresses](/maps/documentation/geocoding/best-practices).\n\nTroubleshooting\n\n- [I'm getting more queries that return ZERO_RESULTS with the geocoder. What's going on?](#trbl-zero-results)\n- [I need fast responses, and the geocoder is too slow for my application. What can\n I use for faster responses?](#trbl-slow)\n- [How can I mitigate the latency on the Directions API (Legacy) and\n Distance Matrix API (Legacy)?](#trbl-latency)\n- [How do I report bugs in the geocoder?](#trbl-report-bug)\n- [The geocoder isn't producing good results for my use case. What help is available?](#trbl-help)\n- [How do I get the best results with the geocoder using component filtering?](#trbl-component-filtering)\n\nTroubleshooting\n\n\nI'm getting more queries that return ZERO_RESULTS with the geocoder. What's going on?\n\n: In the geocoder, ambiguous, incomplete and badly formatted queries, such as\n misspelled or nonexistent addresses, are prone to produce ZERO_RESULTS.\n If the address cannot be found, ZERO_RESULTS is preferable to a partial\n result (for example returning only the suburb in lieu of an address).\n\n If your application deals with user input of addresses, the\n [Place Autocomplete](/maps/documentation/places/web-service/autocomplete) feature\n in the Places API may produce better quality results.\n Place Autocomplete allows users to select from a set of results based on what\n they've typed, which allows users to choose between similarly named results,\n and to adjust their query if they misspell an address.\n\n If you have an application dealing with ambiguous or incomplete queries or queries\n that may contain errors, we recommend you use the\n [Place Autocomplete](/maps/documentation/places/web-service/autocomplete) feature\n in the Places API rather than the forward geocoder\n available in the Geocoding API. For more details, see\n [Best Practices When Geocoding Addresses](/maps/documentation/geocoding/best-practices) and the\n [Address Geocoding in the Google Maps APIs blog post](https://mapsplatform.google.com/resources/blog/address-geocoding-in-google-maps-apis/).\n\n\nI need fast responses, and the geocoder is too slow for my application. What can\nI use for faster responses?\n\n: We recommend that applications that respond to user input, and therefore are highly\n latency-sensitive, use the [Place Autocomplete](/maps/documentation/places/web-service/autocomplete)\n feature in the Places API (also available in\n [JavaScript](/maps/documentation/javascript/places-autocomplete),\n [Android](/maps/documentation/places/android-sdk/autocomplete), or\n [iOS](/maps/documentation/places/ios-sdk/autocomplete)) rather than address geocoding.\n Place Autocomplete is optimized to be used interactively, and thus has very low latency.\n\n Address geocoding in the Geocoding API is optimized for use with\n complete, unambiguous, well formatted addresses, such as delivery addresses entered into\n online forms, and thus has higher latency than Place Autocomplete. The forward geocoder\n has greater coverage and better result quality, but with somewhat higher latency.\n\n\nHow can I mitigate the latency on the Directions API (Legacy) and\nDistance Matrix API (Legacy)?\n\n: Instead of addresses, use [place IDs](/maps/documentation/places/web-service/place-id) to\n specify waypoints, origin, and destination. Place IDs are best obtained from the\n [Place Autocomplete](/maps/documentation/places/web-service/autocomplete)\n feature in the Places API or the\n [Places library](/maps/documentation/javascript/places-autocomplete) in the\n Maps JavaScript API. See also the information on the\n [`placeIdOnly`](/maps/documentation/javascript/places-autocomplete#placeidonly) option, which can be used to reduce the cost of\n Place Autocomplete.\n\n When the Directions API (Legacy) or Distance Matrix API (Legacy)\n is queried with an address string rather than a place ID or latlng, they use the same\n backend as the Geocoding API to convert that address into a\n place ID prior to calculating directions. Place Autocomplete is faster than address\n geocoding. For applications that use the Directions API (Legacy) or\n Distance Matrix API (Legacy) in highly latency-sensitive situations, such as\n responding to user input, we recommended you use Place Autocomplete to get the place IDs\n corresponding to those addresses, and pass the place IDs to the\n Directions API (Legacy) or Distance Matrix API (Legacy).\n This approach reduces latency significantly. See our documentation for an\n [example of how to use Place Autocomplete with directions](/maps/documentation/javascript/examples/places-autocomplete-directions).\n\n\nHow do I report bugs in the geocoder?\n\n: If you have any\n [bug reports](https://issuetracker.google.com/savedsearches/558483) or\n [feature requests](https://issuetracker.google.com/issues/new?component=188871&template=788905) for the forward geocoder service, let us know using our public\n [issue tracker](https://issuetracker.google.com/issues/new?component=188871&template=788906).\n\n\nThe geocoder isn't producing good results for my use case. What help is available?\n\n: Let us know using our public\n [issue tracker](https://issuetracker.google.com/savedsearches/558483), sharing a few specific queries, so we can investigate to\n see if there are any bugs or systemic issues causing problems with result\n quality, or if there are any changes we can make to the\n [best practices guide](/maps/documentation/geocoding/best-practices)\n to help developers get better results.\n\n\nHow do I get the best results with the geocoder using component filtering?\n\n: In the geocoder, [component filtering](/maps/documentation/geocoding/overview#component-filtering) enforces only `postal_code` and\n `country` restrictions. The following examples illustrate how best to use component\n filtering, depending on the results you need. In the sample request URLs, be sure to\n replace \\`YOUR_API_KEY\\` with your actual API key.\n\n - To restrict postal codes to a specific country, be sure to specify the country restriction using an [ISO 3166-2 country code](https://en.wikipedia.org/wiki/ISO_3166-2). For example: `components=country:CH|postal_code:8000` returns \"8000 Zürich, Switzerland\". \n\n ```scdoc\n https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY\n ```\n - To restrict queries to a specific country, be sure to specify the country restriction using an [ISO 3166-2 country code](https://en.wikipedia.org/wiki/ISO_3166-2). Country names and other abbreviations may not produce the same results as country codes.\n\n Examples:\n - Geocoding for `components=country:FRA|locality:gallus` returns the sublocality of Gallus in Frankfurt am Main, Germany. This is because the 3-letter country code for France (FRA) isn't supported, thus results in any country are allowed and the result in Frankfurt is a better fit than anything in France. \n\n ```scdoc\n https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY\n ```\n - Geocoding API won't necessarily return multiple results for ambiguous queries. Such queries are better answered by the Place Autocomplete. Examples:\n\n - Geocoding for `components=country:US|locality:madrid` returns \"Madrid, NM 87010, USA\" but none of the other cities in the USA named \"Madrid\". \n\n ```scdoc\n https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY\n ```\n - Using Place Autocomplete for `input=madrid&components=country:us&types=(regions)`, and also specifying a viewport using `location` and `radius` to [bias the location results](/maps/documentation/places/web-service/autocomplete#location_biasing), generates a response with several cities in the USA named \"Madrid\". \n\n ```carbon\n 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\n ```"]]
