Class Geocoder

Coğrafi kodlayıcı

Adres ile coğrafi koordinatlar arasında dönüşüm yapılmasına olanak tanır.
Aşağıdaki örnekte, bu sınıfı kullanarak Colorado'daki "Main St" konumunun en iyi dokuz eşleşmesini nasıl bulabileceğiniz, bunları bir haritaya nasıl ekleyebileceğiniz ve ardından yeni bir Google Dokümanı'na nasıl yerleştirebileceğiniz gösterilmektedir.

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Google Geocoding API

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
geocode(address)	Object	Belirli bir adresin yaklaşık coğrafi noktalarını alır.
reverseGeocode(latitude, longitude)	Object	Belirli bir coğrafi nokta için yaklaşık adresleri alır.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)	Geocoder	Sonuçlarda ekstra tercih edilmesi gereken bir alanın sınırlarını belirler.
setLanguage(language)	Geocoder	Sonuçlarda kullanılacak dili ayarlar.
setRegion(region)	Geocoder	Konum adlarını yorumlarken kullanılacak bir bölge ayarlar.

Ayrıntılı belgeler

geocode(address)

Belirli bir adresin yaklaşık coğrafi noktalarını alır.

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

Parametreler

Ad	Tür	Açıklama
address	String	Bir adres.

Return

Object: Burada açıklandığı gibi, coğrafi kodlama verilerini içeren bir JSON nesnesi.

---

reverseGeocode(latitude, longitude)

Belirli bir coğrafi nokta için yaklaşık adresleri alır.

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

Parametreler

Ad	Tür	Açıklama
latitude	Number	Noktanın enlemi.
longitude	Number	Noktanın boylamı.

Return

Object: Burada açıklandığı gibi, ters coğrafi kodlama verilerini içeren bir JSON nesnesi.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Google Geocoding API

---

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Sonuçlarda ekstra tercih edilmesi gereken bir alanın sınırlarını belirler.

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

Parametreler

Ad	Tür	Açıklama
swLatitude	Number	Sınırların güneybatı köşesinin enlemi.
swLongitude	Number	Sınırların güneybatı köşesinin boylamı.
neLatitude	Number	Sınırların kuzeydoğu köşesinin enlemi.
neLongitude	Number	Sınırların kuzeydoğu köşesinin boylamı.

Return

Geocoder: Çağrıların zincirlenmesini kolaylaştıran Geocoder nesnesi.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Google Geocoding API

---

setLanguage(language)

Sonuçlarda kullanılacak dili ayarlar.

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

Parametreler

Ad	Tür	Açıklama
language	String	BCP-47 dil tanımlayıcısı.

Return

Geocoder: Çağrıların zincirlenmesini kolaylaştıran Geocoder nesnesi.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Encoded Polyline Format

---

setRegion(region)

Konum adlarını yorumlarken kullanılacak bir bölge ayarlar. Desteklenen bölge kodları, Google Haritalar tarafından desteklenen ccTLD'lere karşılık gelir. Örneğin, "uk" bölge kodu "maps.google.co.uk" ile eşleşir.

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

Parametreler

Ad	Tür	Açıklama
region	String	Kullanılacak bölge kodu.

Return

Geocoder: Çağrıların zincirlenmesini kolaylaştıran Geocoder nesnesi.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Google Geocoding API