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öntem | Dönüş türü | Kısa açıklama |
---|---|---|
geocode(address) | Object | Belirli bir adres için yaklaşık coğrafi noktaları verir. |
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ı ayarlar. |
setLanguage(language) | Geocoder | Sonuçlarda kullanılacak dili ayarlar. |
setRegion(region) | Geocoder | Konum 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
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 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
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:
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
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 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
Ad | Tür | Açıklama |
---|---|---|
language | String | BCP-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
Ad | Tür | Açıklama |
---|---|---|
region | String | kullanılacak bölge kodunu |
Return
Geocoder
— Çağrıların zincirleme olarak kurulmasını kolaylaştıran Geocoder nesnesi