Class Geocoder

Coğrafi kodlayıcı

Adres ile coğrafi koordinatlar arasında dönüştürme yapılmasını sağlar.
Aşağıdaki örnekte, bu sınıfın İstanbul'daki "Main St" konumu için ilk dokuz eşleşmeyi bulmak, bunları bir haritaya eklemek ve ardından yeni bir Google Dokümanına yerleştirmek için bu sınıfı nasıl kullanabileceğiniz gösterilmektedir.

// Find the best matches for "Main St" in Colorado.
var 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.
var doc = DocumentApp.create('My Map');
var map = Maps.newStaticMap();

// Add each result to the map and doc.
for (var i = 0; i < response.results.length && i < 9; i++) {
  var 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 adres için yaklaşık coğrafi noktaları verir.
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ı ayarlar.
setLanguage(language)GeocoderSonuçlarda kullanılacak dili ayarlar.
setRegion(region)GeocoderKonum adları yorumlanırken kullanılacak bir bölge ayarlar.

Ayrıntılı belgeler

geocode(address)

Belirli bir adres için yaklaşık coğrafi noktaları verir.

// Gets the geographic coordinates for Times Square.
var response = Maps.newGeocoder().geocode('Times Square, New York, NY');
for (var i = 0; i < response.results.length; i++) {
  var result = response.results[i];
  Logger.log('%s: %s, %s', result.formatted_address, result.geometry.location.lat,
      result.geometry.location.lng);
}

Parametreler

AdTürAçıklama
addressStringadres

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.
var response = Maps.newGeocoder().reverseGeocode(40.758577, -73.984464);
for (var i = 0; i < response.results.length; i++) {
  var 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ı ayarlar.

// Creates a Geocoder that prefers points in the area of Manhattan.
var 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 zincirleme olarak kurulmasını 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.
var geocoder = Maps.newGeocoder().setLanguage('fr');

Parametreler

AdTürAçıklama
languageStringBCP-47 dil tanımlayıcısı

Return

Geocoder — Çağrıların zincirleme olarak kurulmasını kolaylaştıran Geocoder nesnesi.

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


setRegion(region)

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

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

Parametreler

AdTürAçıklama
regionStringkullanılacak bölge kodunu

Return

Geocoder — Çağrıların zincirleme olarak kurulmasını kolaylaştıran Geocoder nesnesi

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