Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Maps Geocoding API

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou sélectionner un projet
  2. Activer Google Maps Geocoding API
  3. Créer les clés appropriées
Continuer

Questions fréquentes sur le nouveau géocodeur avant

Cette section de questions fréquentes aborde des questions spécifiques au nouveau géocodeur avant annoncé dans l'article de blog Address Geocoding in the Google Maps APIs. Voir aussi la page sur les meilleures pratiques de géocodage des adresses.

Si vous avez des questions communes à toutes les Google Maps APIs, voir la page des questions fréquentes sur les Google Maps APIs.

Premiers pas

Résolution des erreurs

Premiers pas

À partir de quand le nouveau géocodeur avant sera-t-il utilisé par défaut ?
  • Dans le cas des requêtes Google Maps Geocoding API et Google Maps JavaScript API envoyées au service de géocodage, le nouveau géocodeur avant est désormais utilisé par défaut pour les requêtes non identifiées et les clients du plan Standard. Pour les clients Premium Plan qui utilisent ces API, ce changement est prévu pour le 17 janvier 2017.
  • Pour tous les clients (plan Standard et Premium Plan) qui utilisent Google Maps Directions API, Google Maps Distance Matrix API, Google Static Maps API et Google Street View Image API, et pour les requêtes Google Maps JavaScript API envoyées aux services Directions et Distance Matrix, le nouveau géocodeur avant devrait être utilisé par défaut à partir du 24 janvier 2017.
  • À la fin du mois de mars 2017, l'ancien géocodeur deviendra définitivement obsolète.

Ces dates sont susceptibles d'être retardées, en cas de problèmes imprévus ou si d'autres fonctionnalités sont lancées au même moment. Si vous souhaitez modifier votre système avant le déploiement du nouveau géocodeur, assurez-vous de mettre ces modifications en service avant ces dates.

Quelles sont les API qui utiliseront le nouveau géocodeur avant ?

Les Google Maps APIs suivantes se basent sur le même géocodeur pour les requêtes ci-dessous :

Remarque : Le nouveau géocodeur avant n'est jamais utilisé lors de l'extraction de détails pour un identifiant de lieu.

Comment procéder pour utiliser le nouveau géocodeur avant s'il n'est pas encore défini comme géocodeur par défaut ?

Vous pouvez utiliser le nouveau géocodeur avant dès maintenant avec Geocoding API, Directions API et Distance Matrix API, ainsi qu'avec les services Geocoding, Directions et Distance Matrix disponibles dans Maps JavaScript API.

Pour Geocoding API, Directions API et Distance Matrix API, ajoutez le paramètre facultatif new_forward_geocoder=true à vos requêtes.

Dans le cas des bibliothèques client des services Web Google Maps APIs, ajoutez new_forward_geocoder=true à vos requêtes si vous souhaitez utiliser le nouveau géocodeur avant. Ce paramètre d'URL personnalisé a été ajouté récemment aux bibliothèques client.

Pour les services Geocoding, Directions et Distance Matrix disponibles dans Maps JavaScript API, définissez le nouveau paramètre facultatif newForwardGeocoder: true dans l'objet de requête approprié. Ce paramètre est disponible dans les versions Experimental et Release.

Un paramètre facultatif a été ajouté au géocodeur de Google Maps API. Lorsque vous utilisez l'outil, sélectionnez l'option « Use the new forward geocoder » si vous souhaitez obtenir des résultats basés sur les fonctionnalités du nouveau géocodeur avant.

Remarque : Le nouveau géocodeur avant n'est pas encore disponible dans Static Maps API et Street View Image API.

Comment procéder pour utiliser l'ancien géocodeur avant s'il n'est plus le géocodeur par défaut ?

Vous pouvez continuer d'utiliser l'ancien géocodeur avant jusqu'au 29 mars 2017, date à laquelle il deviendra définitivement obsolète.

Pour Geocoding API, Directions API et Distance Matrix API, ajoutez le paramètre facultatif new_forward_geocoder=false à vos requêtes.

Dans le cas des bibliothèques client des services Web Google Maps APIs, ajoutez new_forward_geocoder=false à vos requêtes si vous souhaitez utiliser l'ancien géocodeur avant. Ce paramètre d'URL personnalisé a été ajouté récemment aux bibliothèques client.

Pour les services Geocoding, Directions et Distance Matrix disponibles dans Maps JavaScript API, définissez le nouveau paramètre facultatif newForwardGeocoder: false dans l'objet de requête approprié. Ce paramètre est disponible dans les versions Experimental et Release.

Remarque : Le nouveau géocodeur avant n'est pas encore disponible pour Static Maps API et Street View Image API. Il est donc inutile de définir cette option sur false pour ces API. Pour le moment, Static Maps API et Street View Image API continuent d'utiliser l'ancien géocodeur avant.

Pourquoi ce changement ?

Le nouveau géocodeur avant est identique à celui qui est utilisé par l'application Google Maps grand public. L'ancien géocodeur est en processus de devenir obsolète.

Ce changement est-il rétrocompatible ?

Oui. Geocoding API conserve les anciens formats de requête et de réponse. Il est possible que le nouveau géocodeur produise des résultats différents pour de nombreuses requêtes, mais les requêtes restent opérationnelles dans leur format actuel, et les résultats affichent les mêmes champs qu'auparavant.

Résolution des erreurs

Avec le nouveau géocodeur, les requêtes renvoyant ZERO_RESULTS sont plus nombreuses. Pour quelle raison ?

Dans le nouveau géocodeur, toute requête ambiguë, incomplète ou de format incorrect est susceptible de renvoyer ZERO_RESULTS. Dans l'ancien géocodeur, une telle requête générait généralement un résultat incorrect, par exemple en renvoyant la banlieue si l'adresse est introuvable. Il nous semble plus correct de renvoyer ZERO_RESULTS dans une telle situation.

Si votre application gère des adresses saisies par les utilisateurs, vous obtiendrez peut-être des résultats de meilleure qualité avec la fonctionnalité Place Autocomplete de Places API. Cette fonctionnalité propose aux utilisateurs de faire leur choix dans un ensemble de résultats basés sur leur saisie. Ainsi, ils peuvent sélectionner un lieu parmi plusieurs résultats de noms similaires, ou encore ajuster leur requête si l'adresse saisie est mal orthographiée.

Si les données en entrée de l'application sont issues d'un système automatisé (donc sans utilisateur pour effectuer un choix parmi plusieurs suggestions de saisie semi-automatique) capable de gérer les requêtes ambiguës, incomplètes ou présentant des composants ne faisant pas partie de l'adresse (les noms des établissements, par exemple), il peut s'avérer plus judicieux d'utiliser la fonctionnalité Text Search de Places API. Vous obtiendrez plus facilement un résultat avec Text Search lorsque la requête est ambiguë, car ce type de requête peut contenir un nom d'établissement non pris en compte par Geocoding API.

Si votre application gère des requêtes ambiguës, incomplètes ou susceptibles d'inclure des composants ne faisant pas partie de l'adresse, nous vous recommandons d'utiliser Places API plutôt que le géocodeur avant disponible dans Geocoding API. Pour plus de détails, voir les meilleures pratiques de géocodage des adresses et l'article de blog dédié au géocodage des adresses dans Google Maps API.

J'ai besoin de réponses rapides et le nouveau géocodeur est trop lent pour mon application. Comment faire pour obtenir des réponses plus rapides ?

Lorsque l'application répond à des données saisies par l'utilisateur, la latence est un facteur important. Il est donc recommandé d'utiliser la fonctionnalité Place Autocomplete dans Places API (également disponible dans JavaScript, Android ou iOS), plutôt que le géocodage d'adresse. Comme la fonctionnalité Place Autocomplete est optimisée pour une utilisation interactive, elle assure une latence très faible.

Dans Geocoding API, le géocodage des adresses est optimisé pour des adresses complètes, non ambiguës et de format correct, telles que les adresses de livraison saisies dans les formulaires en ligne. Il présente donc une latence plus élevée que Place Autocomplete. C'était déjà le cas avec l'ancien géocodeur avant. Toutefois, la différence de latence entre Place Autocomplete et le nouveau géocodeur avant est encore plus accentuée, car le nouveau géocodeur offre une couverture plus étendue et des résultats de meilleure qualité, mais au prix d'une certaine augmentation de la latence.

Comment procéder pour limiter la latence sur Directions API et Distance Matrix API ?

Au lieu d'utiliser des adresses, spécifiez les points de cheminement, le point de départ et la destination à l'aide d'identifiants de lieu. Pour obtenir les identifiants de lieu, l'idéal est d'utiliser la fonctionnalité Place Autocomplete de Places API ou la bibliothèque Places de Maps JavaScript API. Voir aussi les informations sur l'option placeIdOnly, que vous pouvez utiliser pour réduire le coût de Place Autocomplete.

Lorsque Directions API ou Distance Matrix API reçoit une requête contenant une adresse (chaîne) à la place d'un identifiant de lieu ou de coordonnées latlng, l'API utilise le même backend que Geocoding API pour convertir cette adresse en identifiant de lieu avant de calculer l'itinéraire. Place Autocomplete est plus rapide que le géocodage d'adresse. Dans le cas des applications faisant appel à Directions API ou Distance Matrix API dans des situations où la latence est un facteur important (réponse à des données saisies par l'utilisateur, par exemple), nous vous recommandons d'utiliser Place Autocomplete pour obtenir les identifiants de lieu correspondant à ces adresses, puis de transmettre ces identifiants de lieu à Directions API ou à Distance Matrix API. Cette approche réduit nettement la latence, même par rapport à l'ancien géocodeur d'adresses. Voir notre documentation pour obtenir un exemple d'utilisation de Place Autocomplete avec un itinéraire.

Je suis un client du plan Premium et Places API est trop coûteuse. Que puis-je faire pour en réduire le coût ?

Nous recommandons d'utiliser le widget Place autocomplete de Maps JavaScript API. Pour réduire le coût d'utilisation du widget autocomplete, utilisez la nouvelle option placeIdOnly afin d'activer l'accès direct aux identifiants de lieu à partir du service Place Autocomplete. L'option placeIdOnly ignore les requêtes Places Details lorsque l'application requiert seulement une adresse (et pas des coordonnées professionnelles complètes). Pour obtenir l'adresse correspondante, transmettez les identifiants de lieu au service de géocodage ou à Geocoding API. Vous pouvez également transmettre les identifiants de lieu aux services Directions ou Distance Matrix, ou encore à Directions API ou Distance Matrix API, à la place d'une chaîne de texte d'adresse ou d'une paire latitude/longitude.

Le géocodeur de Google Maps API et l'exemple de Place Autocomplete et Directions ont été mis à jour pour illustrer l'utilisation de la nouvelle option placeIdOnly.

Comment signaler un bug dans le nouveau géocodeur ?

Si vous souhaitez signaler un bug ou demander une fonctionnalité pour le nouveau service de géocodeur avant, utilisez notre outil de suivi des incidents public.

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

Signalez-nous tout problème à l'aide de notre outil de suivi des incidents public, en indiquant quelques requêtes spécifiques qui produisent de résultats particulièrement médiocres avec le nouveau géocodeur. Ainsi, nous pourrons les examiner pour déterminer si des bugs ou des problèmes systémiques sont à l'origine des problèmes de qualité des résultats, ou encore si nous pouvons apporter des modifications au guide des meilleures pratiques pour aider les développeurs à obtenir de meilleurs résultats.

Dans le nouveau géocodeur, le filtrage par composants ne fonctionne pas comme dans l'ancien. Comment améliorer les résultats obtenus en utilisant le nouveau géocodeur avec le filtrage par composants ?

Dans le nouveau géocodeur, la prise en charge complète du filtrage par composants n'est assurée que lorsque les résultats sont des adresses. Lorsque les résultats sont des localités ou encore plus génériques, une prise en charge partielle est assurée pour les restrictions de code pays (components=country:GB, par exemple) et de code postal. Les exemples ci-dessous montrent comment optimiser le filtrage par composants en fonction des résultats souhaités. Dans les exemples d'URL de requête, remplacez « YOUR_API_KEY » par votre clé d'API.

  • Pour limiter des adresses (y compris les bâtiments, rues et routes) à une zone politique (pays, localité, etc.), utilisez le filtrage par composants de la même façon que dans l'ancien géocodeur. Cet usage est pris en charge dans le nouveau géocodeur. Par exemple : address=gordon&components=locality:dublin renvoie « Gordon Way, Dublin, OH 43017, USA ».
    https://maps.googleapis.com/maps/api/geocode/json?new_forward_geocoder=true&address=gordon&components=locality:dublin&key=YOUR_API_KEY
    
  • Pour limiter les codes postaux à un pays particulier, utilisez le filtrage par composants de la même façon que dans l'ancien géocodeur, mais en spécifiant un code pays ISO 3166-2 pour indiquer la restriction de pays. Cet usage est pris en charge dans le nouveau géocodeur. Par exemple : components=country:CH|postal_code:2000 renvoie « 2000 Neuchâtel, Switzerland ».
    https://maps.googleapis.com/maps/api/geocode/json?new_forward_geocoder=true&components=country:CH%7Cpostal_code:2000&key=YOUR_API_KEY
    
  • Pour restreindre les requêtes ne portant pas sur des adresses (villes ou quartiers, par exemple), utilisez le filtrage par composants de la même façon que dans l'ancien géocodeur, mais en spécifiant un code pays ISO 3166-2 pour indiquer la restriction de pays. Vous n'obtiendrez pas forcément les mêmes résultats que dans l'ancien géocodeur. Utilisez Place Autocomplete pour obtenir de meilleurs résultats limités à un pays particulier.

    Exemples :

    • Avec l'ancien géocodeur, le géocodage de components=country:US%7Clocality:paris renvoie plusieurs villes des États-Unis qui s'appellent « Paris ».
      https://maps.googleapis.com/maps/api/geocode/json?new_forward_geocoder=false&components=country:US%7Clocality:paris&key=YOUR_API_KEY
      
    • Avec le nouveau géocodeur, le géocodage de components=country:US%7Clocality:paris renvoie « Paris, TX, USA », mais aucune des autres villes américaines appelées « Paris ».
      https://maps.googleapis.com/maps/api/geocode/json?new_forward_geocoder=true&components=country:US%7Clocality:paris&key=YOUR_API_KEY
      
    • Si vous utilisez Place Autocomplete pour input=paris&components=country:us&types=(regions), en spécifiant une fenêtre d'affichage avec location et radius pour biaiser les lieux obtenus, la réponse comprend plusieurs villes appelées « Paris » aux États-Unis.
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=paris&components=country:us&types=(regions)&key=YOUR_API_KEY
      
  • Si vous utilisez le filtrage par composants dans le nouveau géocodeur pour restreindre les requêtes ne portant pas sur des adresses (villes ou quartiers, par exemple) à une zone autre qu'un pays, vous n'obtiendrez pas forcément les mêmes résultats que dans l'ancien géocodeur. Utilisez Place Autocomplete pour obtenir de meilleurs résultats privilégiant la zone spécifiée (location et radius). Vous pouvez également utiliser le nouveau paramètre strictbounds pour limiter les résultats à la zone spécifiée.

    Exemples :

    • Avec l'ancien géocodeur, le géocodage de administrative_area:Anaga|locality:Santa+Cruz renvoie la localité de Santa Cruz de Tenerife et la région administrative d'Anaga.
      https://maps.googleapis.com/maps/api/geocode/json?new_forward_geocoder=false&components=administrative_area:Anaga%7Clocality:Santa%20Cruz&key=YOUR_API_KEY
      
    • Avec le nouveau géocodeur, le géocodage de administrative_area:Anaga|locality:Santa+Cruz renvoie uniquement la région administrative d'Anaga (pas la localité souhaitée de Santa Cruz de Tenerife).
      https://maps.googleapis.com/maps/api/geocode/json?new_forward_geocoder=true&components=administrative_area:Anaga%7Clocality:Santa%20Cruz&key=YOUR_API_KEY
      
    • Si vous utilisez Place Autocomplete avec les paramètres input=santa+cruz&location=28.494168,-16.275751&radius=20000&types=geocode, la requête renvoie d'abord « Santa Cruz de Tenerife, Spain », puis d'autres villes telles que « Santa Cruz de La Palma » (sur une autre île) et « Santa Cruz, CA, United States ».
      https://maps.googleapis.com/maps/api/place/autocomplete/json?input=santa+cruz&location=28.494168,-16.275751&radius=20000&types=geocode&key=YOUR_API_KEY
      
    • Ajoutez strictbounds à la requête Place Autocomplete ci-dessus pour limiter les résultats à la région spécifiée (« Anaga »).
      https://maps.googleapis.com/maps/api/place/autocomplete/json?input=santa+cruz&location=28.494168,-16.275751&radius=20000&types=geocode&strictbounds&key=YOUR_API_KEY
      

Envoyer des commentaires concernant…

Google Maps Geocoding API
Google Maps Geocoding API
Besoin d'aide ? Consultez notre page d'assistance.