Ermöglicht die Konvertierung zwischen einer Adresse und geografischen Koordinaten.
Das folgende Beispiel zeigt, wie Sie diese Klasse verwenden können, um die neun besten Übereinstimmungen für den Standort zu finden.
„Hauptstraße“ in Colorado auf, fügen Sie sie einer Karte hinzu und betten Sie sie dann in einem neuen Google-Dokument ein.
// 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 angegebene 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 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 beim Interpretieren von Standortnamen verwendet werden soll. |
Detaillierte Dokumentation
geocode(address)
Ruft die ungefähren geografischen Punkte für eine angegebene 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 |
Rückflug
Object
: Ein JSON-Objekt, das die Geocodierungsdaten 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 | Breitengrad des Punkts |
longitude | Number | der Längengrad des Punkts |
Rückflug
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 Bereichs fest, der 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 | der Längengrad der südwestlichen Ecke der Grenzen |
neLatitude | Number | Breitengrad der nordöstlichen Ecke der Begrenzungen |
neLongitude | Number | der Längengrad der nordöstlichen Ecke der Begrenzungen |
Rückflug
Geocoder
: das Geocoder-Objekt für die einfachere 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-Sprachkennzeichnung |
Rückflug
Geocoder
: Das Geocoder-Objekt für die einfachere Verkettung von Aufrufen.
Weitere Informationen
setRegion(region)
Legt eine Region fest, die beim Interpretieren von Standortnamen verwendet werden soll. Die unterstützten Regionscodes entsprechen die von Google Maps unterstützten ccTLDs. Beispiel: Der Regionscode „uk“ entspricht "maps.google.co.uk" an.
// 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 |
Rückflug
Geocoder
: das Geocoder-Objekt für die einfachere Verkettung von Aufrufen