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 Übereinstimmungen für den Ort „Main St“ in Colorado finden, sie einer Karte hinzufügen und die Karte dann in ein neues Google-Dokument einbetten. 

// 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

Methoden

MethodeRückgabetypKurzbeschreibung
geocode(address)ObjectRuft die ungefähren geografischen Punkte für eine bestimmte Adresse ab.
reverseGeocode(latitude, longitude)ObjectRuft die ungefähren Adressen für einen bestimmten geografischen Punkt ab.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)GeocoderLegt die Grenzen eines Bereichs fest, der in den Ergebnissen besonders berücksichtigt werden soll.
setLanguage(language)GeocoderLegt die Sprache fest, die in den Ergebnissen verwendet werden soll.
setRegion(region)GeocoderLegt eine Region fest, die beim Interpretieren 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

NameTypBeschreibung
addressStringEine 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

NameTypBeschreibung
latitudeNumberDer Breitengrad des Punktes.
longitudeNumberDer Längengrad des Punkts.

Rückflug

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

Weitere Informationen

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Legt die Grenzen eines Bereichs fest, der in den Ergebnissen besonders berücksichtigt 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

NameTypBeschreibung
swLatitudeNumberDer Breitengrad der Südwestecke des Rechtecks.
swLongitudeNumberDer Längengrad der südwestlichen Ecke des Rechtecks.
neLatitudeNumberDer Breitengrad der Nordostecke des Rechtecks.
neLongitudeNumberDer Längengrad der Nordostecke des Rechtecks.

Rückflug

Geocoder: Das Geocoder-Objekt zum Verketten von Aufrufen.

Weitere Informationen

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

NameTypBeschreibung
languageStringEine BCP-47-Sprachkennung.

Rückflug

Geocoder: Das Geocoder-Objekt zum Verketten von Aufrufen.

Weitere Informationen

setRegion(region)

Legt eine Region fest, die beim Interpretieren von Ortsnamen verwendet werden soll. Die unterstützten Regionscodes entsprechen den von Google Maps unterstützten 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

NameTypBeschreibung
regionStringDer zu verwendende Regionscode.

Rückflug

Geocoder: Das Geocoder-Objekt zum Verketten von Aufrufen.

Weitere Informationen