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
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 Gebiets fest, das in den Ergebnissen besonders 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 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
Name | Typ | Beschreibung |
---|---|---|
address | String | eine 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
Name | Typ | Beschreibung |
---|---|---|
latitude | Number | der Breitengrad des Punkts |
longitude | Number | der 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
Name | Typ | Beschreibung |
---|---|---|
swLatitude | Number | Breitengrad der südwestlichen Ecke der Grenzen |
swLongitude | Number | Längengrad der südwestlichen Ecke der Grenzen |
neLatitude | Number | Breitengrad der nordöstlichen Ecke der Grenzen |
neLongitude | Number | Lä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
Name | Typ | Beschreibung |
---|---|---|
language | String | eine 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
Name | Typ | Beschreibung |
---|---|---|
region | String | den zu verwendenden Regionscode |
Return
Geocoder
: Das Geocoder-Objekt zur Vereinfachung der Verkettung von Aufrufen