Class Geocoder

Geokoder

Umożliwia konwersję adresu na współrzędne geograficzne i odwrotnie.
W przykładzie poniżej pokazujemy, jak za pomocą tej klasy znaleźć 9 najtrafniejszych wyników dla lokalizacji „Main St” w Kolorado, dodać je do mapy, a następnie umieścić 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ż

Metody

MetodaZwracany typKrótki opis
geocode(address)ObjectPobiera przybliżone punkty geograficzne dla danego adresu.
reverseGeocode(latitude, longitude)ObjectPobiera przybliżone adresy dla danego punktu geograficznego.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)GeocoderOkreśla granice obszaru, który powinien być traktowany priorytetowo w wynikach.
setLanguage(language)GeocoderUstawia język, który ma być używany w wynikach.
setRegion(region)GeocoderUstawia region, który będzie 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

NazwaTypOpis
addressStringadres,

Powrót

Object – obiekt JSON zawierający dane geokodowania, zgodnie z opisem 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

NazwaTypOpis
latitudeNumberSzerokość geograficzna punktu.
longitudeNumberDługość geograficzna punktu.

Powrót

Object – obiekt JSON zawierający dane geokodowania zwrotnego, zgodnie z opisem tutaj.

Zobacz też

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Określa granice obszaru, który powinien być traktowany priorytetowo 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

NazwaTypOpis
swLatitudeNumberSzerokość geograficzna południowo-zachodniego rogu obszaru.
swLongitudeNumberDługość geograficzna południowo-zachodniego rogu obszaru.
neLatitudeNumberSzerokość geograficzna północno-wschodniego rogu obszaru.
neLongitudeNumberDługość geograficzna północno-wschodniego rogu obszaru.

Powrót

Geocoder – obiekt Geocoder, który ułatwia łączenie wywołań.

Zobacz też

setLanguage(language)

Ustawia 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

NazwaTypOpis
languageStringIdentyfikator języka BCP-47.

Powrót

Geocoder – obiekt Geocoder, który ułatwia łączenie wywołań.

Zobacz też

setRegion(region)

Ustawia region, który będzie używany podczas interpretowania nazw lokalizacji. Obsługiwane kody regionów odpowiadają krajowym domenom najwyższego poziomu obsługiwanym przez Mapy Google. Na przykład kod regionu „uk” odpowiada domenie „maps.google.co.uk”. 

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

Parametry

NazwaTypOpis
regionStringKod regionu do użycia.

Powrót

Geocoder – obiekt Geocoder, który ułatwia łączenie wywołań.

Zobacz też