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 برای تسهیل زنجیره ای شدن تماس ها

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