يسمح بالتحويل بين العنوان والإحداثيات الجغرافية.
يوضِّح المثال أدناه كيفية استخدام هذه الفئة للعثور على أهم تسعة مطابقات للموقع الجغرافي "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'));
انظر أيضًا
الطُرق
| الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
|---|---|---|
geocode(address) | Object | تحصل على النقاط الجغرافية التقريبية لعنوان معيّن. |
reverse | Object | تحصل على العناوين التقريبية لنقطة جغرافية معيّنة. |
set | Geocoder | لضبط حدود منطقة يجب منحها الأولوية الإضافية في النتائج |
set | Geocoder | لضبط اللغة التي سيتم استخدامها في النتائج |
set | 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
تحصل على العناوين التقريبية لنقطة جغرافية معيّنة.
// 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
لضبط حدود منطقة يجب منحها الأولوية الإضافية في النتائج
// 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 | Number | خط العرض للزاوية الجنوبية الغربية للحدود |
sw | Number | خط الطول للزاوية الجنوبية الغربية للحدود |
ne | Number | خط العرض للزاوية الشمالية الشرقية للحدود |
ne | Number | خط الطول للزاوية الشمالية الشرقية للحدود |
الإرجاع
Geocoder - عنصر Geocoder لتسهيل تسلسل المكالمات
انظر أيضًا
set
لضبط اللغة التي سيتم استخدامها في النتائج
// Creates a Geocoder with the language set to French.
const geocoder = Maps.newGeocoder().setLanguage('fr');
المعلَمات
| الاسم | النوع | الوصف |
|---|---|---|
language | String | معرّف لغة BCP-47 |
الإرجاع
Geocoder: عنصر Geocoder لتسهيل تسلسل طلبات البيانات
انظر أيضًا
set
لتحديد منطقة لاستخدامها عند تفسير أسماء المواقع الجغرافية تتطابق رموز المناطق المتوافقة مع نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد (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 لتسهيل تسلسل المكالمات