Class Geocoder

Geocoder

Permet de convertir une adresse en coordonnées géographiques.
L'exemple ci-dessous montre comment utiliser cette classe pour trouver les neuf premiers résultats correspondant à l'emplacement "Main St" dans le Colorado, les ajouter à une carte, puis les intégrer dans un nouveau document Google.

// Find the best matches for "Main St" in Colorado.
const response = Maps.newGeocoder()
                     // The latitudes and longitudes of southwest and northeast
                     // corners of Colorado, respectively.
                     .setBounds(36.998166, -109.045486, 41.001666, -102.052002)
                     .geocode('Main St');

// Create a Google Doc and map.
const doc = DocumentApp.create('My Map');
const map = Maps.newStaticMap();

// Add each result to the map and doc.
for (let i = 0; i < response.results.length && i < 9; i++) {
  const result = response.results[i];
  map.setMarkerStyle(null, null, i + 1);
  map.addMarker(result.geometry.location.lat, result.geometry.location.lng);
  doc.appendListItem(result.formatted_address);
}

// Add the finished map to the doc.
doc.appendImage(Utilities.newBlob(map.getMapImage(), 'image/png'));

Voir aussi

• API Google Geocoding

Méthodes

Méthode	Type renvoyé	Brève description
geocode(address)	Object	Récupère les points géographiques approximatifs d'une adresse donnée.
reverseGeocode(latitude, longitude)	Object	Récupère les adresses approximatives d'un point géographique donné.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)	Geocoder	Définit les limites d'une zone qui doit être privilégiée dans les résultats.
setLanguage(language)	Geocoder	Définit la langue à utiliser dans les résultats.
setRegion(region)	Geocoder	Définit une région à utiliser lors de l'interprétation des noms de lieux.

Documentation détaillée

geocode(address)

Récupère les points géographiques approximatifs d'une adresse donnée.

// Gets the geographic coordinates for Times Square.
const response = Maps.newGeocoder().geocode('Times Square, New York, NY');
for (let i = 0; i < response.results.length; i++) {
  const result = response.results[i];
  Logger.log(
      '%s: %s, %s',
      result.formatted_address,
      result.geometry.location.lat,
      result.geometry.location.lng,
  );
}

Paramètres

Nom	Type	Description
address	String	une adresse

Renvois

Object : objet JSON contenant les données de géocodage, comme décrit ici

---

reverseGeocode(latitude, longitude)

Récupère les adresses approximatives d'un point géographique donné.

// Gets the address of a point in Times Square.
const response = Maps.newGeocoder().reverseGeocode(40.758577, -73.984464);
for (let i = 0; i < response.results.length; i++) {
  const result = response.results[i];
  Logger.log(
      '%s: %s, %s',
      result.formatted_address,
      result.geometry.location.lat,
      result.geometry.location.lng,
  );
}

Paramètres

Nom	Type	Description
latitude	Number	la latitude du point ;
longitude	Number	la longitude du point ;

Renvois

Object : objet JSON contenant les données de géocodage inverse, comme décrit ici

Voir aussi

• API Google Geocoding

---

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Définit les limites d'une zone qui doit être privilégiée dans les résultats.

// Creates a Geocoder that prefers points in the area of Manhattan.
const geocoder = Maps.newGeocoder().setBounds(
    40.699642,
    -74.021072,
    40.877569,
    -73.908548,
);

Paramètres

Nom	Type	Description
swLatitude	Number	latitude de l'angle sud-ouest des limites
swLongitude	Number	Longitude du coin sud-ouest des limites
neLatitude	Number	latitude du coin nord-est des limites
neLongitude	Number	Longitude du coin nord-est des limites

Renvois

Geocoder : objet Geocoder pour faciliter l'association en chaîne des appels

Voir aussi

• API Google Geocoding

---

setLanguage(language)

Définit la langue à utiliser dans les résultats.

// Creates a Geocoder with the language set to French.
const geocoder = Maps.newGeocoder().setLanguage('fr');

Paramètres

Nom	Type	Description
language	String	un identifiant de langue BCP-47

Renvois

Geocoder : objet Geocoder permettant de faciliter l'association en chaîne des appels.

Voir aussi

• Format de polyligne encodée

---

setRegion(region)

Définit une région à utiliser lors de l'interprétation des noms de lieux. Les codes de région acceptés correspondent aux ccTLD acceptés par Google Maps. Par exemple, le code de région "uk" correspond à "maps.google.co.uk".

// Creates a Geocoder with the region set to France.
const geocoder = Maps.newGeocoder().setRegion('fr');

Paramètres

Nom	Type	Description
region	String	Code de région à utiliser

Renvois

Geocoder : objet Geocoder pour faciliter l'association en chaîne des appels

Voir aussi

• API Google Geocoding