Class Geocoder

Geokodowanie

Umożliwia konwersję adresu na współrzędne geograficzne i odwrotnie.
Przykład poniżej pokazuje, jak za pomocą tej klasy znaleźć 9 najlepszych dopasowań do lokalizacji „Main St” w Kolorado, dodać je do mapy, a potem osadzić ją w nowym dokumencie Google.

// 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'));

Zobacz też

• Google Geocoding API

Metody

Metoda	Zwracany typ	Krótki opis
geocode(address)	Object	Pobiera przybliżone punkty geograficzne dla danego adresu.
reverseGeocode(latitude, longitude)	Object	Pobiera przybliżone adresy dla danego punktu geograficznego.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)	Geocoder	Określa granice obszaru, który powinien być preferowany w wynikach.
setLanguage(language)	Geocoder	Określa język, który ma być używany w wynikach.
setRegion(region)	Geocoder	Określa region używany podczas interpretowania nazw lokalizacji.

Szczegółowa dokumentacja

geocode(address)

Pobiera przybliżone punkty geograficzne dla danego adresu.

// 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,
  );
}

Parametry

Nazwa	Typ	Opis
address	String	adres

Powrót

Object – obiekt JSON zawierający dane geokodowania opisane tutaj

---

reverseGeocode(latitude, longitude)

Pobiera przybliżone adresy dla danego punktu geograficznego.

// 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,
  );
}

Parametry

Nazwa	Typ	Opis
latitude	Number	szerokość geograficzna punktu
longitude	Number	długość geograficzna punktu

Powrót

Object – obiekt JSON zawierający dane odwrotnego geokodowania opisane tutaj.

Zobacz też

• Google Geocoding API

---

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Określa granice obszaru, który powinien być preferowany w wynikach.

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

Parametry

Nazwa	Typ	Opis
swLatitude	Number	szerokość geograficzną punktu południowo-zachodniego na granicy
swLongitude	Number	długość geograficzna punktu południowo-zachodniego narożnika granic
neLatitude	Number	szerokość geograficzna punktu północno-wschodniego na granicy
neLongitude	Number	długość geograficzna punktu północno-wschodniego na granicy

Powrót

Geocoder – obiekt Geocoder ułatwiający łańcuch wywołań

Zobacz też

• Google Geocoding API

---

setLanguage(language)

Określa język, który ma być używany w wynikach.

// Creates a Geocoder with the language set to French.
const geocoder = Maps.newGeocoder().setLanguage('fr');

Parametry

Nazwa	Typ	Opis
language	String	identyfikator języka BCP-47.

Powrót

Geocoder – obiekt Geocoder ułatwiający łańcuch wywołań.

Zobacz też

• Format zakodowanej linii wielokątnej

---

setRegion(region)

Określa region używany podczas interpretowania nazw lokalizacji. Obsługiwane kody regionów odpowiadają domenom ccTLD obsługiwanym przez Mapy Google. Na przykład kod regionu „uk” odpowiada do domeny „maps.google.co.uk”.

// Creates a Geocoder with the region set to France.
const geocoder = Maps.newGeocoder().setRegion('fr');

Parametry

Nazwa	Typ	Opis
region	String	kod regionu, którego chcesz użyć;

Powrót

Geocoder – obiekt Geocoder ułatwiający łańcuch wywołań

Zobacz też

• Google Geocoding API