L'API Google Geocoding retourne des résultats influencés par l'adresse de la région (généralement le pays) depuis laquelle la requête a été envoyée. Par exemple, les recherches sur "San Francisco" peuvent retourner des résultats différents si elles sont envoyées depuis un domaine situé aux Etats-Unis ou en Espagne.
Vous pouvez ordonner à l'API Google Geocoding de retourner des résultats influencés par une région particulière en utilisant le paramètre region. Ce paramètre prend un argument ccTLD (code pays du domaine de premier niveau) spécifiant la région influençant le résultat. La plupart des codes ccTLD sont identiques à ceux de l' ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD du Royaume-Uni est "uk" (.co.uk) tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité du "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord").
Les résultats du géocodage peuvent être influencés pour chaque domaine dans lequel l'application principale Google Maps est officiellement lancée. Notez que seuls influence uniquement les résultats pour un domaine spécifique, et si des résultats plus pertinents existent en dehors de ce domaine, ils peuvent être inclus.
Géocodeur et pays d'influence réponse au format JSON
Par exemple, le géocodage de "Toledo" retourne ce résultat, comme si le domaine par défaut pour l'API Google Geocoding était défini sur les Etats-Unis :
Requête :
http://maps.googleapis.com/maps/api/geocode/json?address=Toledo&sensor=true_OU_false
Important : dans la requête ci-dessus Le paramètre sensor a été laissé volontairement avec la variable true_OU_false afin de souligner que vous devez définir impérativement cette valeur de façon explicite sur true ou sur false.
Voici la réponse au format JSON :
/**
* Requête envoyée aux serveurs de Google :
*
* http://maps.googleapis.com/maps/api/geocode/json?address=Toledo&sensor=false
*
* Ci-dessous la réponse retournée au format json :
*
*/
{
"results" : [
{
"address_components" : [
{
"long_name" : "Tolède",
"short_name" : "Tolède",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Comté de Lucas",
"short_name" : "Comté de Lucas",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Ohio",
"short_name" : "OH",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "États-Unis",
"short_name" : "US",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Toledo, Ohio, États-Unis",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 41.7328440,
"lng" : -83.4542290
},
"southwest" : {
"lat" : 41.58026590,
"lng" : -83.69423700000002
}
},
"location" : {
"lat" : 41.66393830,
"lng" : -83.55521200000001
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 41.73058899999999,
"lng" : -83.42715260
},
"southwest" : {
"lat" : 41.59721860,
"lng" : -83.68327140
}
}
},
"types" : [ "locality", "political" ]
},
{
"address_components" : [
{
"long_name" : "Tolède",
"short_name" : "Tolède",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Comté de Lincoln",
"short_name" : "Comté de Lincoln",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Oregon",
"short_name" : "OR",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "États-Unis",
"short_name" : "US",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Tolède, Oregon, États-Unis",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 44.63832190,
"lng" : -123.9129440
},
"southwest" : {
"lat" : 44.5987760,
"lng" : -123.9545850
}
},
"location" : {
"lat" : 44.6215070,
"lng" : -123.93844780
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 44.63832190,
"lng" : -123.9129440
},
"southwest" : {
"lat" : 44.5987760,
"lng" : -123.9545850
}
}
},
"types" : [ "locality", "political" ]
},
{
"address_components" : [
{
"long_name" : "Tolède",
"short_name" : "Tolède",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Comté de Tama",
"short_name" : "Comté de Tama",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Iowa",
"short_name" : "IA",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "États-Unis",
"short_name" : "US",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Toledo, Iowa, États-Unis",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 42.00388600000001,
"lng" : -92.56695300000001
},
"southwest" : {
"lat" : 41.9784430,
"lng" : -92.60007299999999
}
},
"location" : {
"lat" : 41.99333330,
"lng" : -92.57916670
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 42.00388600000001,
"lng" : -92.56695300000001
},
"southwest" : {
"lat" : 41.9784430,
"lng" : -92.60007299999999
}
}
},
"types" : [ "locality", "political" ]
},
{
"address_components" : [
{
"long_name" : "Tolède",
"short_name" : "Tolède",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Sumpter",
"short_name" : "Sumpter",
"types" : [ "administrative_area_level_3", "political" ]
},
{
"long_name" : "Comté de Cumberland",
"short_name" : "Comté de Cumberland",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Illinois",
"short_name" : "IL",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "États-Unis",
"short_name" : "US",
"types" : [ "country", "political" ]
},
{
"long_name" : "62468",
"short_name" : "62468",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "Toledo, IL 62468, États-Unis",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 39.2843910,
"lng" : -88.2258810
},
"southwest" : {
"lat" : 39.2616990,
"lng" : -88.26420490
}
},
"location" : {
"lat" : 39.27364910,
"lng" : -88.24365220
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 39.2843910,
"lng" : -88.2258810
},
"southwest" : {
"lat" : 39.2616990,
"lng" : -88.26420490
}
}
},
"types" : [ "locality", "political" ]
},
{
"address_components" : [
{
"long_name" : "Tolède",
"short_name" : "Tolède",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Olequa",
"short_name" : "Olequa",
"types" : [ "administrative_area_level_3", "political" ]
},
{
"long_name" : "Comté de Lewis",
"short_name" : "Comté de Lewis",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "État de Washington",
"short_name" : "WA",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "États-Unis",
"short_name" : "US",
"types" : [ "country", "political" ]
},
{
"long_name" : "98591",
"short_name" : "98591",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "Tolède, État de Washington 98591, États-Unis",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 46.44799889999999,
"lng" : -122.8419250
},
"southwest" : {
"lat" : 46.432330,
"lng" : -122.855750
}
},
"location" : {
"lat" : 46.43983050,
"lng" : -122.8467830
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 46.44799889999999,
"lng" : -122.8419250
},
"southwest" : {
"lat" : 46.432330,
"lng" : -122.855750
}
}
},
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
Cliquez sur le lien ci-desssous pour voir le résultat dans votre navigateur :
http://maps.googleapis.com/maps/api/geocode/json?address=Toledo&sensor=false
Le géocodage de "Toledo" avec le paramètre region=es (Espagne) retournera la ville Espagnole.
Requête :
http://maps.googleapis.com/maps/api/geocode/json?address=Toledo®ion=es&sensor=true_OU_false
Important : dans la requête ci-dessus Le paramètre sensor a été laissé volontairement avec la variable true_OU_false afin de souligner que vous devez définir impérativement cette valeur de façon explicite sur true ou sur false.
Voici la réponse au format JSON :
/**
* Requête envoyée aux serveurs de Google :
*
* http://maps.googleapis.com/maps/api/geocode/json?address=Toledo®ion=es&sensor=false
*
* Ci-dessous la réponse retournée au format json :
*
*/
{
"results" : [
{
"address_components" : [
{
"long_name" : "Tolède",
"short_name" : "Tolède",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Tolède",
"short_name" : "TO",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Castille la Manche",
"short_name" : "CM",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "Espagne",
"short_name" : "ES",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Tolède, Espagne",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 40.13060130,
"lng" : -3.51353950
},
"southwest" : {
"lat" : 39.78692640,
"lng" : -4.17963540
}
},
"location" : {
"lat" : 39.85677750,
"lng" : -4.02447590
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 40.13060130,
"lng" : -3.51353950
},
"southwest" : {
"lat" : 39.78692640,
"lng" : -4.17963540
}
}
},
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
Cliquez sur le lien ci-desssous pour voir le résultat dans votre navigateur :
http://maps.googleapis.com/maps/api/geocode/json?address=Toledo®ion=es&sensor=false
Géocodeur et pays d'influence réponse au format XML
Les exemples qui suivent sont identiques aux précédents. Seul le format de sortie change : XML.
Par exemple, le géocodage de "Toledo" retourne ce résultat, comme si le domaine par défaut pour l'API Google Geocoding était défini sur les Etats-Unis :
Requête :
http://maps.googleapis.com/maps/api/geocode/xml?address=Toledo&sensor=true_OU_false
Important : dans la requête ci-dessus Le paramètre sensor a été laissé volontairement avec la variable true_OU_false afin de souligner que vous devez définir impérativement cette valeur de façon explicite sur true ou sur false.
Voici la réponse au format XML :
/** * Requête envoyée aux serveurs de Google : * * http://maps.googleapis.com/maps/api/geocode/xml?address=Toledo&sensor=false * * Ci-dessous la réponse retournée au format xml : * */ <?xml version="1.0" encoding="UTF-8"?> <GeocodeResponse> <status>OK</status> <result> <type>locality</type> <type>political</type> <formatted_address>Toledo, Ohio, États-Unis</formatted_address> <address_component> <long_name>Tolède</long_name> <short_name>Tolède</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>Comté de Lucas</long_name> <short_name>Comté de Lucas</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>Ohio</long_name> <short_name>OH</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>États-Unis</long_name> <short_name>US</short_name> <type>country</type> <type>political</type> </address_component> <geometry> <location> <lat>41.6639383</lat> <lng>-83.5552120</lng> </location> <location_type>APPROXIMATE</location_type> <viewport> <southwest> <lat>41.5972186</lat> <lng>-83.6832714</lng> </southwest> <northeast> <lat>41.7305890</lat> <lng>-83.4271526</lng> </northeast> </viewport> <bounds> <southwest> <lat>41.5802659</lat> <lng>-83.6942370</lng> </southwest> <northeast> <lat>41.7328440</lat> <lng>-83.4542290</lng> </northeast> </bounds> </geometry> </result> <result> <type>locality</type> <type>political</type> <formatted_address>Tolède, Oregon, États-Unis</formatted_address> <address_component> <long_name>Tolède</long_name> <short_name>Tolède</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>Toledo</long_name> <short_name>Toledo</short_name> <type>administrative_area_level_3</type> <type>political</type> </address_component> <address_component> <long_name>Comté de Lincoln</long_name> <short_name>Comté de Lincoln</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>Oregon</long_name> <short_name>OR</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>États-Unis</long_name> <short_name>US</short_name> <type>country</type> <type>political</type> </address_component> <geometry> <location> <lat>44.6215070</lat> <lng>-123.9384478</lng> </location> <location_type>APPROXIMATE</location_type> <viewport> <southwest> <lat>44.5987760</lat> <lng>-123.9545850</lng> </southwest> <northeast> <lat>44.6383219</lat> <lng>-123.9129440</lng> </northeast> </viewport> <bounds> <southwest> <lat>44.5987760</lat> <lng>-123.9545850</lng> </southwest> <northeast> <lat>44.6383219</lat> <lng>-123.9129440</lng> </northeast> </bounds> </geometry> </result> <result> <type>locality</type> <type>political</type> <formatted_address>Toledo, Iowa, États-Unis</formatted_address> <address_component> <long_name>Tolède</long_name> <short_name>Tolède</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>Comté de Tama</long_name> <short_name>Comté de Tama</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>Iowa</long_name> <short_name>IA</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>États-Unis</long_name> <short_name>US</short_name> <type>country</type> <type>political</type> </address_component> <geometry> <location> <lat>41.9933333</lat> <lng>-92.5791667</lng> </location> <location_type>APPROXIMATE</location_type> <viewport> <southwest> <lat>41.9784430</lat> <lng>-92.6000730</lng> </southwest> <northeast> <lat>42.0038860</lat> <lng>-92.5669530</lng> </northeast> </viewport> <bounds> <southwest> <lat>41.9784430</lat> <lng>-92.6000730</lng> </southwest> <northeast> <lat>42.0038860</lat> <lng>-92.5669530</lng> </northeast> </bounds> </geometry> </result> <result> <type>locality</type> <type>political</type> <formatted_address>Toledo, IL 62468, États-Unis</formatted_address> <address_component> <long_name>Tolède</long_name> <short_name>Tolède</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>Sumpter</long_name> <short_name>Sumpter</short_name> <type>administrative_area_level_3</type> <type>political</type> </address_component> <address_component> <long_name>Comté de Cumberland</long_name> <short_name>Comté de Cumberland</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>Illinois</long_name> <short_name>IL</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>États-Unis</long_name> <short_name>US</short_name> <type>country</type> <type>political</type> </address_component> <address_component> <long_name>62468</long_name> <short_name>62468</short_name> <type>postal_code</type> </address_component> <geometry> <location> <lat>39.2736491</lat> <lng>-88.2436522</lng> </location> <location_type>APPROXIMATE</location_type> <viewport> <southwest> <lat>39.2616990</lat> <lng>-88.2642049</lng> </southwest> <northeast> <lat>39.2843910</lat> <lng>-88.2258810</lng> </northeast> </viewport> <bounds> <southwest> <lat>39.2616990</lat> <lng>-88.2642049</lng> </southwest> <northeast> <lat>39.2843910</lat> <lng>-88.2258810</lng> </northeast> </bounds> </geometry> </result> <result> <type>locality</type> <type>political</type> <formatted_address>Tolède, État de Washington 98591, États-Unis</formatted_address> <address_component> <long_name>Tolède</long_name> <short_name>Tolède</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>Olequa</long_name> <short_name>Olequa</short_name> <type>administrative_area_level_3</type> <type>political</type> </address_component> <address_component> <long_name>Comté de Lewis</long_name> <short_name>Comté de Lewis</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>État de Washington</long_name> <short_name>WA</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>États-Unis</long_name> <short_name>US</short_name> <type>country</type> <type>political</type> </address_component> <address_component> <long_name>98591</long_name> <short_name>98591</short_name> <type>postal_code</type> </address_component> <geometry> <location> <lat>46.4398305</lat> <lng>-122.8467830</lng> </location> <location_type>APPROXIMATE</location_type> <viewport> <southwest> <lat>46.4323300</lat> <lng>-122.8557500</lng> </southwest> <northeast> <lat>46.4479989</lat> <lng>-122.8419250</lng> </northeast> </viewport> <bounds> <southwest> <lat>46.4323300</lat> <lng>-122.8557500</lng> </southwest> <northeast> <lat>46.4479989</lat> <lng>-122.8419250</lng> </northeast> </bounds> </geometry> </result> </GeocodeResponse>
Cliquez sur le lien ci-desssous pour voir le résultat dans votre navigateur :
http://maps.googleapis.com/maps/api/geocode/xml?address=Toledo&sensor=false
Le géocodage de "Toledo" avec le paramètre region=es (Espagne) retournera la ville Espagnole.
Requête :
http://maps.googleapis.com/maps/api/geocode/xml?address=Toledo®ion=es&sensor=true_OU_false
Important : dans la requête ci-dessus Le paramètre sensor a été laissé volontairement avec la variable true_OU_false afin de souligner que vous devez définir impérativement cette valeur de façon explicite sur true ou sur false.
Voici la réponse au format XML :
/** * Requête envoyée aux serveurs de Google : * * http://maps.googleapis.com/maps/api/geocode/xml?address=Toledo®ion=es&sensor=false * * Ci-dessous la réponse retournée au format xml : * */ <?xml version="1.0" encoding="UTF-8"?> <GeocodeResponse> <status>OK</status> <result> <type>locality</type> <type>political</type> <formatted_address>Tolède, Espagne</formatted_address> <address_component> <long_name>Tolède</long_name> <short_name>Tolède</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>Tolède</long_name> <short_name>TO</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>Castille la Manche</long_name> <short_name>CM</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>Espagne</long_name> <short_name>ES</short_name> <type>country</type> <type>political</type> </address_component> <geometry> <location> <lat>39.8567775</lat> <lng>-4.0244759</lng> </location> <location_type>APPROXIMATE</location_type> <viewport> <southwest> <lat>39.7869264</lat> <lng>-4.1796354</lng> </southwest> <northeast> <lat>40.1306013</lat> <lng>-3.5135395</lng> </northeast> </viewport> <bounds> <southwest> <lat>39.7869264</lat> <lng>-4.1796354</lng> </southwest> <northeast> <lat>40.1306013</lat> <lng>-3.5135395</lng> </northeast> </bounds> </geometry> </result> </GeocodeResponse>
Cliquez sur le lien ci-desssous pour voir le résultat dans votre navigateur :
http://maps.googleapis.com/maps/api/geocode/xml?address=Toledo®ion=es&sensor=false