Class Geocoder

Geocoder

Ermöglicht die Umwandlung zwischen einer Adresse und geografischen Koordinaten.
Im folgenden Beispiel wird gezeigt, wie Sie mit dieser Klasse die neun besten Treffer für den Standort „Main St“ in Colorado finden, sie einer Karte hinzufügen und diese dann in ein neues Google-Dokument einbetten können.

// 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'));

Weitere Informationen

• Google Geocoding API

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
geocode(address)	Object	Ruft die ungefähren geografischen Punkte für eine bestimmte Adresse ab.
reverseGeocode(latitude, longitude)	Object	Ruft die ungefähren Adressen für einen bestimmten geografischen Punkt ab.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)	Geocoder	Legt die Grenzen eines Bereichs fest, der in den Ergebnissen bevorzugt werden soll.
setLanguage(language)	Geocoder	Legt die Sprache fest, die in den Ergebnissen verwendet werden soll.
setRegion(region)	Geocoder	Legt eine Region fest, die bei der Interpretation von Ortsnamen verwendet werden soll.

Detaillierte Dokumentation

geocode(address)

Ruft die ungefähren geografischen Punkte für eine bestimmte Adresse ab.

// 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,
  );
}

Parameter

Name	Typ	Beschreibung
address	String	Eine Adresse.

Rückflug

Object : Ein JSON-Objekt mit den Geocoding-Daten, wie hier beschrieben.

---

reverseGeocode(latitude, longitude)

Ruft die ungefähren Adressen für einen bestimmten geografischen Punkt ab.

// 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,
  );
}

Parameter

Name	Typ	Beschreibung
latitude	Number	Der Breitengrad des Punkts.
longitude	Number	Der Längengrad des Punkts.

Rückflug

Object : Ein JSON-Objekt mit den Daten für das Reverse-Geocoding, wie hier beschrieben.

Weitere Informationen

• Google Geocoding API

---

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Legt die Grenzen eines Bereichs fest, der in den Ergebnissen bevorzugt werden soll.

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

Parameter

Name	Typ	Beschreibung
swLatitude	Number	Der Breitengrad der südwestlichen Ecke der Grenzen.
swLongitude	Number	Der Längengrad der südwestlichen Ecke der Grenzen.
neLatitude	Number	Der Breitengrad der nordöstlichen Ecke der Grenzen.
neLongitude	Number	Der Längengrad der nordöstlichen Ecke der Grenzen.

Rückflug

Geocoder : Das Geocoder-Objekt, um die Verkettung von Aufrufen zu erleichtern.

Weitere Informationen

• Google Geocoding API

---

setLanguage(language)

Legt die Sprache fest, die in den Ergebnissen verwendet werden soll.

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

Parameter

Name	Typ	Beschreibung
language	String	Eine BCP-47-Sprachkennung.

Rückflug

Geocoder : Das Geocoder-Objekt, um die Verkettung von Aufrufen zu erleichtern.

Weitere Informationen

• Codiertes Polylinienformat

---

setRegion(region)

Legt eine Region fest, die bei der Interpretation von Ortsnamen verwendet werden soll. Die unterstützten Regionscodes entsprechen den von Google Maps unterstützten länderspezifischen Top-Level-Domains (country code top-level domains, ccTLDs). Der Regionscode „uk“ entspricht beispielsweise „maps.google.co.uk“.

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

Parameter

Name	Typ	Beschreibung
region	String	Der zu verwendende Regionscode.

Rückflug

Geocoder : Das Geocoder-Objekt, um die Verkettung von Aufrufen zu erleichtern.

Weitere Informationen

• Google Geocoding API