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ż

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ć preferowany w wynikach.
setLanguage(language)GeocoderOkreśla język, który ma być używany w wynikach.
setRegion(region)GeocoderOkreś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

NazwaTypOpis
addressStringadres

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

NazwaTypOpis
latitudeNumberszerokość geograficzna punktu
longitudeNumberdługość geograficzna punktu

Powrót

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

Zobacz też

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

NazwaTypOpis
swLatitudeNumberszerokość geograficzną punktu południowo-zachodniego na granicy
swLongitudeNumberdługość geograficzna punktu południowo-zachodniego narożnika granic
neLatitudeNumberszerokość geograficzna punktu północno-wschodniego na granicy
neLongitudeNumberdługość geograficzna punktu północno-wschodniego na granicy

Powrót

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

Zobacz też

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

NazwaTypOpis
languageStringidentyfikator języka BCP-47.

Powrót

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

Zobacz też

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

NazwaTypOpis
regionStringkod regionu, którego chcesz użyć;

Powrót

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

Zobacz też