Class Geocoder

ژئوکدر

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

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

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

روش ها

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

مستندات دقیق

geocode(address)

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

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

پارامترها

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

بازگشت

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

reverse Geocode(latitude, longitude)

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

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

پارامترها

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

بازگشت

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

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

set Bounds(swLatitude, swLongitude, neLatitude, neLongitude)

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

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

پارامترها

نام تایپ کنید توضیحات
sw Latitude Number عرض جغرافیایی گوشه جنوب غربی محدوده
sw Longitude Number طول جغرافیایی گوشه جنوب غربی محدوده
ne Latitude Number عرض جغرافیایی گوشه شمال شرقی محدوده
ne Longitude Number طول جغرافیایی گوشه شمال شرقی محدوده

بازگشت

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

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

set Language(language)

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

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

پارامترها

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

بازگشت

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

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

set Region(region)

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

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

پارامترها

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

بازگشت

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

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