Api Google Maps flèche Geocodeur flèche Comment géocoder une adresse postale au format .xml.

GÉOCODEZ UNE ADRESSE POSTALE AU FORMAT .XML

Article créé le : 13/01/2009
Dernière modification le : 31/10/2009

Présentation

XML est un langage extensible utilisant des balises. Chaque donnée est identifiée par balise. Toute balise ouverte doit obligatoirement être fermée.

Exemple :

On va placer la donnée "47.127268" à l'intérieur de la balise nommée "latitude" :

  • 1 / Ouverture de la balise nommée "latitude" : <latitude>
  • 2 / Insertion de la donnée : 47.127268
  • 3 / Fermeture de la balise nommée "latitude" en ajoutant un "/" devant le nom de la balise : </latitude>

Ce qui nous donne : <latitude>47.127268</latitude>

Si la balise nommée "latitude" ne comporte aucune donnée, elle peut-être écrite comme ceci :

  • <latitude></latitude>

ou comme cela

  • <latitude />

Ce langage est extensible car il vous permet de décrire et de personnaliser la structure de vos données.

Exemple :


<mesdonnees>

	<marqueur>

		<nom>Le logis royal à Loches</nom>

		<latitude>47.127268</latitude>

		<longitude>0.998905</longitude>

		<infobulle>Il est l'un des mieux conservés. Modèle d'architecture militaire, il est transformé en prison royale par Louis XI.</infobulle>

	</marqueur>

	<marqueur>

		<nom>Le château de Chinon</nom>

		<latitude>47.168079</latitude>

		<longitude>0.236120</longitude>

		<infobulle>Surplombant la Vienne, le château de Chinon fait partie des châteaux de la Loire ayant accueilli le roi de France.</infobulle>

	</marqueur>

</mesdonnees>

Pour plus d'informations concernant le format XML vous pouvez lire :

Géocoder une adresse : Géocoder consiste à estimer les coordonnées GPS (la latitude et la longitude) d'un lieu donné (adresse postale).

Vous pouvez accéder directement au géocodeur de Google Maps grâce à cette requête HTTP :

  http://maps.google.com/maps/geo?

en utilisant les paramètres suivants :

  • q  obligatoire  :
    • Adresse postale que vous souhaitez géocoder.
    • Latitude,Longitude que vous souhaitez transformer en adresse postale.
  • key  obligatoire  :
    • Votre clé API.
  • sensor  obligatoire  :
    • Indique si le demande de géocodage vient d'un GPS. Valeurs possibles : true ou false.
  • output  obligatoire  :
    • Format de la réponse. Les options possibles sont : xml - kml - csv - json (  par défaut  ).
  • oe facultatif mais  fortement conseillé  :
    • Format d'encodage de la réponse. Il est fortement recommandé d'utiliser l'encodage utf8, sauf si vous souhaitez utiliser impérativement un autre type d'encodage.
  • ll  facultatif  :
    • Centre de la fenêtre, sous la forme suivante : ll = latitude, longitude
    • Exemple : ll=40.479581, -117.773438. Ce paramètre n'a de sens que si le paramètre spn est également transmis au géocodeur.
  • spn  facultatif  :
    • Le "span" de la fenêtre, exprimée sous la forme suivante : spn = latitude, longitude
    • Exemple : spn=11.1873,22.5. Ce paramètre n'a de sens que si le paramètre ll est également transmis au géocodage.

Notez que les paramètres suivants gl et spn, ll vont influencer, sans restreindre, les résultats du géocodeur.

Pour géocoder une adresse postale, au format .xml, il vous suffit d'envoyer une requête HTTP de la forme :


  http://maps.google.com/maps/geo?q=adresse+a+geocoder&output=xml&oe=utf8&sensor=false&key=VOTRE_CLE_API

Exemple I :

requête à envoyer, pour obtenir une réponse au format "xml" concernant l'adresse 10 rue bretonneau 37000 tours : 


  http://maps.google.com/maps/geo?q=10+rue+bretonneau+37000+tours+fr&output=xml&oe=utf8&sensor=false&key=ABQIAAAATndsWAV5Q2y7pRRi-22W_hTxw9fvAnrsiYejTsRxd4b0cj9HKxSNCXUxAANaoACDzXWznNLVPto_jA

Réponse obtenue au format .xml :

<kml xmlns="http://earth.google.com/kml/2.0">
	<Response> 
		<name>10 rue bretonneau 37000 tours fr</name> 
		<Status> 
			<code>200</code> 
			<request>geocode</request> 
		</Status> 
		<Placemark id="p1"> 
			<address>10 Rue Bretonneau, 37000 Tours, France</address> 
			<AddressDetails Accuracy="8" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">
				<Country>
					<CountryNameCode>FR</CountryNameCode>
					<CountryName>France</CountryName>
					<AdministrativeArea>
						<AdministrativeAreaName>Centre</AdministrativeAreaName>
						<SubAdministrativeArea>
							<SubAdministrativeAreaName>Indre-et-Loire</SubAdministrativeAreaName>
							<Locality>
								<LocalityName>Tours</LocalityName>
								<Thoroughfare>
									<ThoroughfareName>10 Rue Bretonneau</ThoroughfareName>
								</Thoroughfare>
								<PostalCode>
									<PostalCodeNumber>37000</PostalCodeNumber>
								</PostalCode>
							</Locality>
						</SubAdministrativeArea>
					</AdministrativeArea>
				</Country>
			</AddressDetails> 
			<ExtendedData> 
				<LatLonBox north="47.3985537" south="47.3922579" east="0.6835145" west="0.6772192" /> 
			</ExtendedData> 
			<Point>
				<coordinates>0.6803765,47.3954067,0</coordinates>
			</Point> 
		</Placemark> 
	</Response>
</kml>

Exemple II :

Impact de la précision de l'adresse sur l'Exactitude, la Latitude et la Longitude.

Voici les réponses obtenues pour quatre adresses, plus ou moins précises, classées par ordre croissant d'exactitude :

Localisation, sur une carte, des différentes adresses figurant dans le tableau ci-dessus.

Adresse postale soumise Icône Code statut Exactitude Latitude Longitude
tours pointeur rouge 200 4 47.39029420.6888514
37000 tours pointeur orange 200 547.38327450.6897966
rue bretonneau 37000 tours pointeur bleu 200 647.39501870.6803994
10 rue bretonneau 37000 tours pointeur vert 200 847.39540670.6803765

Remarque(s)

Autres articles :