تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

يمكن أيضًا مراجعة

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

المَعلمات

الاسم	Type	الوصف
`address`	`String`	عنوان جغرافي

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`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.
var geocoder = Maps.newGeocoder()
    .setBounds(40.699642, -74.021072, 40.877569, -73.908548);

المَعلمات

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

استرجاع الكرة

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

يمكن أيضًا مراجعة

Google Geocoding API

`setLanguage(language)`

تحدِّد هذه السياسة اللغة التي سيتم استخدامها في النتائج.

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

المَعلمات

الاسم	Type	الوصف
`language`	`String`	معرّف اللغة 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');

المَعلمات

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

استرجاع الكرة

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

يمكن أيضًا مراجعة

Google Geocoding API