Class Geocoder

Geocoder

Ermöglicht die Konvertierung zwischen einer Adresse und geografischen Koordinaten.
Im Beispiel unten sehen Sie, wie Sie mit dieser Klasse die neun besten Übereinstimmungen für den Standort „Main St“ in Colorado finden, sie einer Karte hinzufügen und sie dann in ein neues Google-Dokument einbetten.

// Find the best matches for "Main St" in Colorado.
var 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.
var doc = DocumentApp.create('My Map');
var map = Maps.newStaticMap();

// Add each result to the map and doc.
for (var i = 0; i < response.results.length && i < 9; i++) {
  var 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 Gebiets fest, das in den Ergebnissen besonders bevorzugt werden soll.
setLanguage(language)GeocoderLegt die Sprache fest, die in den Ergebnissen verwendet werden soll.
setRegion(region)GeocoderLegt eine Region fest, die bei der Interpretation von Standortnamen 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.
var response = Maps.newGeocoder().geocode('Times Square, New York, NY');
for (var i = 0; i < response.results.length; i++) {
  var result = response.results[i];
  Logger.log('%s: %s, %s', result.formatted_address, result.geometry.location.lat,
      result.geometry.location.lng);
}

Parameter

NameTypBeschreibung
addressStringeine Adresse

Return

Object: ein JSON-Objekt, das die Geocoding-Daten enthält, 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.
var response = Maps.newGeocoder().reverseGeocode(40.758577, -73.984464);
for (var i = 0; i < response.results.length; i++) {
  var 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 Punkts
longitudeNumberder Längengrad des Punkts

Return

Object: ein JSON-Objekt, das die Daten für die umgekehrte Geocodierung enthält, wie hier beschrieben

Weitere Informationen


setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Legt die Grenzen eines Gebiets fest, das in den Ergebnissen besonders bevorzugt werden soll.

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

Parameter

NameTypBeschreibung
swLatitudeNumberBreitengrad der südwestlichen Ecke der Grenzen
swLongitudeNumberLängengrad der südwestlichen Ecke der Grenzen
neLatitudeNumberBreitengrad der nordöstlichen Ecke der Grenzen
neLongitudeNumberLängengrad der nordöstlichen Ecke der Grenzen

Return

Geocoder: Das Geocoder-Objekt zur Vereinfachung der Verkettung 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.
var geocoder = Maps.newGeocoder().setLanguage('fr');

Parameter

NameTypBeschreibung
languageStringeine BCP-47-Sprachkennung

Return

Geocoder: Das Geocoder-Objekt zur Vereinfachung der Verkettung von Aufrufen.

Weitere Informationen


setRegion(region)

Legt eine Region fest, die bei der Interpretation von Standortnamen 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.
var geocoder = Maps.newGeocoder().setRegion('fr');

Parameter

NameTypBeschreibung
regionStringden zu verwendenden Regionscode

Return

Geocoder: Das Geocoder-Objekt zur Vereinfachung der Verkettung von Aufrufen

Weitere Informationen