GClientGeocoder
   API Google Maps version 2
   Référence et Guide du développeur en Français

Attention :

L'API Google Maps Javascript Version 2 a été officiellement déclarée obsolète le 19 mai 2010 par Google.

L'API Version 2 continuera cependant à fonctionner durant encore trois ans, à compter de cette date, conformément à la politique de dépréciation de Google.

Conlusion, si vous devez développer une application aujourd'hui utilisez d'ores et déjà la version 3 de l'API Google Maps Javascript ( cela vous évitera d'avoir à tout recommencer ou à tout repayer dans 3 ans ! ) ou migrez votre application actuelle vers la version 3.

La classe GClientGeocoder en Français - Google Maps API Version 2

Cette classe est utilisée pour communiquer directement avec les serveurs de Google afin de géocoder les adresses postales spécifiées par les utilisateurs. En outre, le géocodeur gère son propre cache d'adresses, qui permet aux requêtes répétitives d'être résolues sans émettre de requête vers le serveur. D'une manière générale, il n'est pas recommandé d'utiliser les fonctions GClientGeocoder dans une boucle. Les développeurs qui ont de nombreuses adresses postales à géocoder devront utiliser le Geocodeur HTTP à la place.

Haut de page

Constructeur

Constructeur

Description

GClientGeocoder(cache?:GGeocodeCache)

Créé une nouvelle instance d'un géocodeur qui communique directement avec les serveurs de Google.

Le paramètre optionnel cache permet de spécifier, côté client, un cache personnalisé pour les adresses postales connues.

Si rien n'est spécifié, GFactualGeocodeCache est utilisé.

Depuis la version 2.55

Haut de page

Méthodes

Méthode

Return Value

Description

getLatLng(address:String, callback:function)

Aucune

Envoie une requête vers les serveurs de Google pour géocoder l'adresse postale spécifiée.

Si l'adresse postale a été correctement localisée, la fonction de callback spécifiée par l'utilisateur est invoquée avec le point GLatLng.

Sinon, la fonction de callback retourne un point null.

En cas d'adresse postale ambiguë, seul le point de la meilleure adéquation est passé à la fonction de rappel callback.

Depuis la version 2.55

getLocations(address:String, callback:function)

Aucune

Cette méthode effectue un géocodage, c'est à dire la conversion d'une adresse postale lisible par l'homme en une paire de données latitude et longitude.

getLocations() envoie une requête au service de géocodage de Google, en lui demandant d'analyser l'adresse postale address donnée puis transmet la réponse dans la fonction de rappel callback indiqué.

Comme cette méthode nécessite un appel à un serveur de Google, vous devez également transmettre une méthode de callback pour gérer la réponse.

Cette réponse contient un code de Status et en cas de succès, un ou plusieurs objets Placemark.

Notez que depuis la version 2.133, cette méthode a été améliorée pour permettre également le passage d'objets GLatLng permettant le géocodage inversé.

Pour plus d'information voir ci-dessous.

Depuis la version 2.55

getLocations(latlng:GLatLng, callback:function)

Aucune

Cette méthode effectue un géocodage inversé, c'est à dire la conversion d'une paire de données latitude et longitude, en une adresse postale lisible par l'homme.

getLocations() envoie une requête au service de géocodage Google, en lui demandant de retourner l'adresse postale correspondant au latlng envoyé puis transmet la réponse dans la fonction de rappel callback indiqué.

Comme cette méthode nécessite un appel à un serveur de Google, vous devez transmettre également une méthode de callback pour gérer la réponse.

Cette réponse contient un code de Status et, en cas de succès, un ou plusieurs objets Placemark.

Notez que cette méthode peut, au lieu de cela, passer une adresse postale sous forme de Chaîne , comme indiqué ci-dessus, et dans ce cas, le service effectuera un géocodage standard.

Toutefois, si le premier argument contient une GLatLng le service fera un géocodage inversé.

Depuis la version 2.133

getCache()

GGeocodeCache

Retourne le cache actuellement utilisé par le géocodeur, ou null si aucune mise en cache côté client n'a été effectuée.

Depuis la version 2.55

setCache(cache:GGeocodeCache)

Aucune

Définit une nouvelle mise en cache côté client.

Si cette méthode est invoquée avec cache ayant pour valeur null alors, la mise en cache côté client est désactivée.

La définition d'un nouveau cache efface les adresses précédemment stockées.

Depuis la version 2.55

setViewport(bounds:GLatLngBounds)

Aucune

Indique au géocodeur de favoriser les résultats se stituant à l'intérieur ou proche de la zone indiquée.

La zone de recherche est délimitée à l'aide d'un rectangle GLatLngBounds .

Note :

Le fait de déterminer une zone de recherche, ne limite pas les résultats de la recherche à cette seule zone, mais il les favorise.

Depuis la version 2.82

getViewport()

GLatLngBounds

Retourne la zone de recherche pour laquelle les résultats du géocodeur seront favorisés s'ils sont situés à l'intérieur ou à proximité de celle-ci.

La zone de recherche est délimitée à l'aide d'un rectangle GLatLngBounds .

Depuis la version 2.82

setBaseCountryCode(countryCode:String)

Aucune

Paramètre le géocodeur pour qu'il effectue des recherches comme s'il elles avaient été envoyées à partir d'un domaine spécifié par le code à deux lettres utilisés pour désigner les domaines internet géographiques (ccTLD = country code Top Level Domains).

Le géocodage est pris en charge uniquement dans les pays ou ce service est disponible dans Google Maps.

La plupart des codes de ccTLD sont identiques aux codes de la norme ISO 3166-1 avec, cependant, quelques exceptions notables.

Par exemple, pour la Grande-Bretagne l'extension générique est "uk" ( .co.uk ) tandis que son code ISO 3166-1 est «GB».

Notez que le domaine par défaut est le domaine indiquez lorsque vous chargez l' API de Google Maps.

Note :

Les codes de pays, sont sensibles à la casse.

Depuis la version 2.82

getBaseCountryCode()

Chaîne

Retourne le code de pays en cours d'utilisation par le géocodeur donné.

Si aucun code de pays n'est défini, cette méthode retourne null.

Depuis la version 2.82

reset()

Aucune

Réinitialise le géocodeur.

En particulier, cette méthode appelle la méthode GGeocodeCache.reset() sur le cache côté client, si jamais il était utilisé par ce géocodeur.

Depuis la version 2.55

Haut de page


Ceci est une traduction non officielle de "Google Maps API Reference version 2".

La version originale, en Anglais, se situe ici : Google Maps API Reference version 2 #GClientGeocoder.

| | © 2010 | Référence Google Maps API Version 2 en Français |