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:

Yöntemler

YöntemDönüş türüKısa açıklama
geocode(address)ObjectBelirli bir adresin yaklaşık coğrafi noktalarını alır.
reverseGeocode(latitude, longitude)ObjectBelirli bir coğrafi nokta için yaklaşık adresleri alır.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)GeocoderSonuçlarda ekstra tercih edilmesi gereken bir alanın sınırlarını belirler.
setLanguage(language)GeocoderSonuçlarda kullanılacak dili ayarlar.
setRegion(region)GeocoderKonum 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

AdTürAçıklama
addressStringBir 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

AdTürAçıklama
latitudeNumberNoktanın enlemi.
longitudeNumberNoktanı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:

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

AdTürAçıklama
swLatitudeNumberSınırların güneybatı köşesinin enlemi.
swLongitudeNumberSınırların güneybatı köşesinin boylamı.
neLatitudeNumberSınırların kuzeydoğu köşesinin enlemi.
neLongitudeNumberSı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:

setLanguage(language)

Sonuçlarda kullanılacak dili ayarlar. 

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

Parametreler

AdTürAçıklama
languageStringBCP-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:

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

AdTürAçıklama
regionStringKullanılacak bölge kodu.

Return

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

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