Class Geocoder

أداة الترميز الجغرافي

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

// 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 - كائن Geocoder لتسهيل تسلسل المكالمات

انظر أيضًا

setLanguage(language)

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

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

المعلمات

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

الإرجاع

Geocoder - كائن Geocoder لتسهيل تسلسل المكالمات.

انظر أيضًا

setRegion(region)

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

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

المعلمات

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

الإرجاع

Geocoder - كائن Geocoder لتسهيل تسلسل المكالمات

انظر أيضًا