Class Geocoder

المشفِّر الجغرافي

يسمح بالتحويل بين العنوان والإحداثيات الجغرافية.
يوضِّح المثال أدناه كيفية استخدام هذه الفئة للعثور على أهم تسعة مطابقات للموقع الجغرافي "Main St" في كولورادو، وإضافتها إلى خريطة، ثم تضمينها في مستند جديد على "مستندات Google".

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

انظر أيضًا

• Google Geocoding API

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
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.
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 يحتوي على بيانات ترميز الموقع الجغرافي، كما هو موضّح هنا

---

reverseGeocode(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 يحتوي على بيانات الترميز الجغرافي العكسي، كما هو موضّح هنا

انظر أيضًا

• Google Geocoding API

---

setBounds(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,
);

المعلمات

الاسم	النوع	الوصف
swLatitude	Number	خط العرض للزاوية الجنوبية الغربية للحدود
swLongitude	Number	خط الطول للزاوية الجنوبية الغربية للحدود
neLatitude	Number	خط العرض للزاوية الشمالية الشرقية للحدود
neLongitude	Number	خط الطول للزاوية الشمالية الشرقية للحدود

الإرجاع

Geocoder - عنصر Geocoder لتسهيل تسلسل المكالمات

انظر أيضًا

• Google Geocoding API

---

setLanguage(language)

لضبط اللغة التي سيتم استخدامها في النتائج

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

المعلمات

الاسم	النوع	الوصف
language	String	معرّف لغة BCP-47

الإرجاع

‫Geocoder: عنصر Geocoder لتسهيل تسلسل طلبات البيانات

انظر أيضًا

• تنسيق الخطوط المتعددة المشفَّرة

---

setRegion(region)

لضبط منطقة لاستخدامها عند تفسير أسماء المواقع الجغرافية تتطابق رموز المناطق المتوافقة مع نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد (ccTLD) المتوافقة مع "خرائط Google". على سبيل المثال، يتوافق رمز المنطقة "uk" مع "maps.google.co.uk".

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

المعلمات

الاسم	النوع	الوصف
region	String	رمز المنطقة المراد استخدامها

الإرجاع

Geocoder - عنصر Geocoder لتسهيل تسلسل المكالمات

انظر أيضًا

• Google Geocoding API