Class Geocoder

Geocoder

Permet de convertir une adresse en coordonnées géographiques, et vice versa.
L'exemple ci-dessous montre comment utiliser cette classe pour trouver les neuf meilleurs résultats pour l'emplacement "Main St" au Colorado, les ajouter à une carte, puis l'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	Obtient les points géographiques approximatifs pour une adresse donnée.
reverseGeocode(latitude, longitude)	Object	Obtient les adresses approximatives pour un point géographique donné.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)	Geocoder	Définit les limites d'une zone à laquelle une préférence supplémentaire doit être accordé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)

Obtient les points géographiques approximatifs pour 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)

Obtient les adresses approximatives pour 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	Latitude du point.
longitude	Number	Longitude du point.

Renvois

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

Voir aussi

• API Google Geocoding

---

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Définit les limites d'une zone à laquelle une préférence supplémentaire doit être accordé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 du coin 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	Identifiant de langue BCP-47.

Renvois

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

Voir aussi

• Format des polylignes encodées

---

setRegion(region)

Définit une région à utiliser lors de l'interprétation des noms de lieux. Les codes de région compatibles correspondent aux ccTLD compatibles avec 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