Class Geocoder

ژئوکودر

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

// 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 برای تسهیل زنجیره‌سازی فراخوانی‌ها.

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