Structure et paramètres de l'URL pour géocoder vos adresses avec l'API Google Geocoding
Une requête utilisant l'API Google Geocoding doit avoir la structure suivante :
http://maps.googleapis.com/maps/api/geocode/format_de_sortie?vos_parametres
où format_de_sortie peut prendre l'une des deux valeurs suivantes :
json(recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
http://maps.googleapis.com/maps/api/geocode/
json?vos_parametresxmlindique que la réponse doit être au format XML
http://maps.googleapis.com/maps/api/geocode/
xml?vos_parametres
Pour accéder à l'API Google Geocoding via le protocole HTTPS, utilisez la forme suivante :
https://maps.googleapis.com/maps/api/geocode/format_de_sortie?vos_parametres
Le protocole HTTPS est recommandé dans les applications où les requêtes peuvent comporter des données confidentielles sur l'utilisateur, tel que leur emplacement par exemple.
Dans tous les cas, certains paramètres vos_parametres sont obligatoires alors que d'autres sont facultatifs .
Les paramètres sont séparés par le caractère 'esperluette' ( & ).
Les paramètres sont énumérés et détaillés ci-dessous.
Les paramètres obligatoires dans l'URL pour géocoder vos adresses avec l'API Google Geocoding
L'URL utilisée pour le géocodage doit impérativement contenir l'un des 3 premiers paramètres ci-dessous (address ou latlng ou components) et obligatoirement le dernier (sensor) :
address : {string} Adresse postale que vous souhaitez géocoder.*
OU
latlng : {Latitude,Longitude} Latitude/longitude que vous souhaitez transformer en adresse postale (la plus proche), lisible par l'homme*
OU
components : { route | locality | administrative_area | postal_code | country } Un filtre de composant pour lequel vous désirez obtenir un géocodage.
Voir composant de filtrage pour plus d'informations.
Le filtrage par composants sera également accepté comme un paramètre optionnel si une adresse ( address ) est fournie.
sensor : {booléen} Indique si oui (true) ou non (false) la requête de géocodage provient d'un appareil mobile doté d'un GPS.
Les paramètres facultatifs dans l'URL pour géocoder vos adresses avec l'API Google Geocoding
L'URL utilisée pour le géocodage peut également contenir un ou plusieurs des paramètres facultatifs ci-dessous (bounds, region, language, component) :
bounds : Limite de la zone de sélection dans laquelle les résultats du géocodeur seront influencés de façon plus importante. Ce paramètre influence les résultats du géocodeur sans toutefois les restreindre. Pour plus d'informations, voir Influer sur les résultats du géocodeur en définissant une zone géographique.
region : Code du pays, indiqué sous la forme d'un ccTLD ("Top Level Domain") à deux cararctères. Ce paramètre influence les résultats du géocodeur sans toutefois les restreindre. Pour plus d'informations, voir Influer sur les résultats du géocodeur en définissant un pays.
language : Langue dans laquelle seront retournés les résultats. Voir la liste des langues supportées par l'API Google Maps. Notez que Google met souvent cette liste à jour, de ce fait elle n'est pas exhaustive. Si language n'est pas fourni, le géocodeur tentera d'utiliser la langue maternelle du domaine depuis lequel la requête a été envoyée, chaque fois que cela est possible.
component : Les filtres de composants sont séparés par une barre verticale ou pipe (|). Chaque filtre de composant est constitué d'une paire component:value et limitera totalement les résultats du géocodeur. Pour plus d'informations, consultez Filtrage par composants.
Note * :
Vous pouvez passer soit une address, soit un latlng dans la requête.
Si vous passez un latlng, le géocodeur exécutera alors un géocodage inversé. Voir Géocodage inversé ou Reverse geocoding pour plus d'informations.