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 auf einer Karte hinzufügen und 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
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
geocode(address) | Object | Die ungefähren geografischen Punkte für eine bestimmte Adresse abrufen. |
reverse | Object | Ruft die ungefähren Adressen für einen bestimmten geografischen Punkt ab. |
set | Geocoder | Hiermit werden die Grenzen eines Gebiets festgelegt, das in den Ergebnissen bevorzugt berücksichtigt werden soll. |
set | Geocoder | Hier legen Sie die Sprache fest, die in den Ergebnissen verwendet werden soll. |
set | Geocoder | Hier legen Sie eine Region fest, die bei der Interpretation von Ortsnamen verwendet werden soll. |
Detaillierte Dokumentation
geocode(address)
Die ungefähren geografischen Punkte für eine bestimmte Adresse abrufen.
// 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 Geocodierungsdaten, wie hier beschrieben
reverse Geocode(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 | den Breitengrad des Punkts |
longitude | Number | den Längengrad des Punkts |
Rückflug
Object
: Ein JSON-Objekt mit den Daten für den umgekehrten Geocoding, wie hier beschrieben
Weitere Informationen
set Bounds(swLatitude, swLongitude, neLatitude, neLongitude)
Hiermit werden die Grenzen eines Gebiets festgelegt, das in den Ergebnissen bevorzugt 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
Name | Typ | Beschreibung |
---|---|---|
sw | Number | der Breitengrad der südwestlichen Ecke der Begrenzung |
sw | Number | der Längengrad der südwestlichen Ecke des Begrenzungsbereichs |
ne | Number | der Breitengrad der nordöstlichen Ecke der Begrenzung |
ne | Number | der Längengrad der nordöstlichen Ecke des Begrenzungsbereichs |
Rückflug
Geocoder
– das Geocoder-Objekt, das die Verkettung von Aufrufen vereinfacht
Weitere Informationen
set Language(language)
Hier legen Sie 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-Sprachkennzeichnung |
Rückflug
Geocoder
: Das Geocoder-Objekt, das die Verkettung von Aufrufen vereinfacht.
Weitere Informationen
set Region(region)
Hier legen Sie 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. Der Regionscode „de“ entspricht beispielsweise „maps.google.de“.
// Creates a Geocoder with the region set to France. const geocoder = Maps.newGeocoder().setRegion('fr');
Parameter
Name | Typ | Beschreibung |
---|---|---|
region | String | den zu verwendenden Regionscode |
Rückflug
Geocoder
– das Geocoder-Objekt, das die Verkettung von Aufrufen vereinfacht