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" konumuyla en iyi dokuz eşleşmeyi nasıl bulacağınız, bunları bir haritaya nasıl ekleyeceğiniz ve ardından yeni bir Google Dokümanı'na nasıl yerleştireceğ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 noktanın yaklaşık adreslerini 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ı dokümanlar

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	adres

Return

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

---

reverseGeocode(latitude, longitude)

Belirli bir coğrafi noktanın yaklaşık adreslerini 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ırı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: Aramaların zincirlenmesini kolaylaştırmak için kullanılan Coğrafi Kodlayıcı 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: Aramaların zincirlenmesini kolaylaştıran Coğrafi Kodlayıcı nesnesi.

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

• Kodlanmış Poli çizgi Biçimi

---

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: Aramaların zincirlenmesini kolaylaştırmak için kullanılan Coğrafi Kodlayıcı nesnesi

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

• Google Geocoding API