Class Geocoder

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
برنامج الترميز الجغرافي

تسمح بتحويل العنوان والإحداثيات الجغرافية.
يوضح المثال التالي كيفية استخدام هذا الصف للعثور على أفضل تسع مطابقات للموقع الجغرافي&.

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

المعلّمات

الاسمالنوعالوصف
addressStringعنوان

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
latitudeNumberخط العرض للنقطة
longitudeNumberخط الطول للنقطة

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
swLatitudeNumberخط العرض للزاوية الجنوبية الغربية للحدود
swLongitudeNumberخط الطول للجنوب والغرب من الحدود
neLatitudeNumberخط العرض للزاوية الشمالية الشرقية للحدود
neLongitudeNumberخط الطول للزاوية الشمالية الشرقية للحدود

تذكرة ذهاب وعودة

Geocoder: كائن ترميز المواقع الجغرافية لتسهيل تسلسل المكالمات

راجع أيضًا


setLanguage(language)

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

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

المعلّمات

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

تذكرة ذهاب وعودة

Geocoder: كائن ترميز المواقع الجغرافية لتسهيل تسلسل المكالمات.

راجع أيضًا


setRegion(region)

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

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

المعلّمات

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

تذكرة ذهاب وعودة

Geocoder: كائن ترميز المواقع الجغرافية لتسهيل تسلسل المكالمات

راجع أيضًا