Class Geocoder

ژئوکدر

امکان تبدیل بین یک آدرس و مختصات جغرافیایی را فراهم می کند.
مثال زیر نشان می‌دهد که چگونه می‌توانید از این کلاس استفاده کنید تا 9 مورد برتر را برای مکان "Main St" در کلرادو پیدا کنید، آنها را به نقشه اضافه کنید و سپس آن را در Google Doc جدید جاسازی کنید. 

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

همچنین ببینید

روش ها

روش نوع برگشت شرح مختصر
geocode(address) Object نقاط جغرافیایی تقریبی یک آدرس را دریافت می کند.
reverseGeocode(latitude, longitude) Object آدرس های تقریبی یک نقطه جغرافیایی معین را دریافت می کند.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude) Geocoder محدوده ناحیه ای را که باید در نتایج اولویت بیشتری داشته باشد را تعیین می کند.
setLanguage(language) Geocoder زبان مورد استفاده در نتایج را تنظیم می کند.
setRegion(region) Geocoder منطقه ای را برای استفاده در هنگام تفسیر نام مکان ها تنظیم می کند.

مستندات دقیق

geocode(address)

نقاط جغرافیایی تقریبی یک آدرس را دریافت می کند. 

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

پارامترها

نام تایپ کنید توضیحات
address String یک آدرس

بازگشت

Object - یک شی JSON حاوی داده های رمزگذاری جغرافیایی، همانطور که در اینجا توضیح داده شده است

reverseGeocode(latitude, longitude)

آدرس های تقریبی یک نقطه جغرافیایی معین را دریافت می کند. 

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

پارامترها

نام تایپ کنید توضیحات
latitude Number عرض جغرافیایی نقطه
longitude Number طول جغرافیایی نقطه

بازگشت

Object - یک شی JSON حاوی داده های معکوس جغرافیایی، همانطور که در اینجا توضیح داده شده است

همچنین ببینید

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

محدوده ناحیه ای را که باید در نتایج اولویت بیشتری داشته باشد را تعیین می کند. 

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

پارامترها

نام تایپ کنید توضیحات
swLatitude Number عرض جغرافیایی گوشه جنوب غربی محدوده
swLongitude Number طول جغرافیایی گوشه جنوب غربی محدوده
neLatitude Number عرض جغرافیایی گوشه شمال شرقی محدوده
neLongitude Number طول جغرافیایی گوشه شمال شرقی محدوده

بازگشت

Geocoder - شی Geocoder برای تسهیل زنجیره ای شدن تماس ها

همچنین ببینید

setLanguage(language)

زبان مورد استفاده در نتایج را تنظیم می کند. 

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

پارامترها

نام تایپ کنید توضیحات
language String یک شناسه زبان BCP-47

بازگشت

Geocoder - شی Geocoder برای تسهیل زنجیره ای شدن تماس ها.

همچنین ببینید

setRegion(region)

منطقه ای را برای استفاده در هنگام تفسیر نام مکان ها تنظیم می کند. کدهای منطقه پشتیبانی شده با ccTLD های پشتیبانی شده توسط Google Maps مطابقت دارد. برای مثال، کد منطقه "uk" با "maps.google.co.uk" مطابقت دارد. 

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

پارامترها

نام تایپ کنید توضیحات
region String کد منطقه برای استفاده

بازگشت

Geocoder - شی Geocoder برای تسهیل زنجیره ای شدن تماس ها

همچنین ببینید