فئة ElevationService
google.maps.ElevationService
class
تحدِّد فئة الخدمة التي تتواصل مباشرةً مع خوادم Google لطلب بيانات الارتفاع.
يمكنك الوصول إليه من خلال الاتصال بالرقم const {ElevationService} = await google.maps.importLibrary("elevation"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
الشركة المصنِّعة | |
|---|---|
ElevationService |
ElevationService()المَعلمات: بدون
تُنشئ هذه الوظيفة نسخة جديدة من ElevationService تُرسِل طلبات بحث عن الارتفاع إلى خوادم Google. |
الطُرق | |
|---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback])المَعلمات:
القيمة المعروضة:
Promise<PathElevationResponse>يُجري طلبًا لارتفاع على طول مسار، حيث يتم عرض بيانات الارتفاع كعيّنات مستندة إلى المسافة على طول هذا المسار. |
getElevationForLocations |
getElevationForLocations(request[, callback])المَعلمات:
القيمة المعروضة:
Promise<LocationElevationResponse>يُجري طلبًا لارتفاع قائمة بالمواقع الجغرافية المنفصلة. |
واجهة LocationElevationRequest
google.maps.LocationElevationRequest
واجهة
طلب ارتفاع أرسله ElevationService يتضمّن قائمة الإحداثيات المنفصلة (LatLng) المطلوب عرض بيانات الارتفاع لها
الخصائص | |
|---|---|
locations optional |
النوع:
Array<LatLng|LatLngLiteral> optionalالمواقع الجغرافية المنفصلة التي يجب استرداد ارتفاعاتها |
واجهة LocationElevationResponse
google.maps.LocationElevationResponse
واجهة
استجابة الإرتفاع التي يعرضها ElevationService والتي تحتوي على قائمة ElevationResult التي تتطابق مع المواقع الجغرافية LocationElevationRequest
الخصائص | |
|---|---|
results |
النوع:
Array<ElevationResult>قائمة ElevationResult التي تتطابق مع المواقع الجغرافية LocationElevationRequest |
PathElevationRequest
google.maps.PathElevationRequest
واجهة
استعلام عن الارتفاع أرسله ElevationService يحتوي على المسار الذي سيتم من خلاله عرض البيانات المستندة إلى عيّنات. يحدِّد هذا الطلب مسارًا مستمرًا على سطح الأرض يجب أخذ عيّنات الارتفاع على طوله على مسافات متساوية. تستخدم جميع المسارات من رأس إلى رأس أجزاء من الدائرة العظمى بين هاتين النقطتَين.
الخصائص | |
|---|---|
samples |
النوع:
numberمطلوب. عدد النقاط على مسافة متساوية على طول المسار المحدّد لاسترداد بيانات الارتفاع، بما في ذلك نقاط النهاية يجب أن يكون عدد العيّنات قيمة تتراوح بين 2 و512، بما في ذلك هذين الرقمَين. |
path optional |
النوع:
Array<LatLng|LatLngLiteral> optionalالمسار الذي يتم من خلاله جمع قيم الارتفاع |
واجهة PathElevationResponse
google.maps.PathElevationResponse
واجهة
استجابة ارتفاع يعرضها ElevationService تحتوي على قائمة ElevationResult متباعدة بالتساوي على طول مسار PathElevationRequest
الخصائص | |
|---|---|
results |
النوع:
Array<ElevationResult>قائمة ElevationResult التي تتطابق مع عيّنات PathElevationRequest |
واجهة ElevationResult
google.maps.ElevationResult
واجهة
نتيجة طلب ElevationService، تتألف من مجموعة إحداثيات الارتفاع وقيم الارتفاع يُرجى العِلم أنّ طلبًا واحدًا قد ينتج عنه ElevationResult متعددة.
الخصائص | |
|---|---|
elevation |
النوع:
numberارتفاع هذه النقطة على سطح الأرض، بالكيلومترات فوق مستوى سطح البحر |
resolution |
النوع:
numberالمسافة، بالمتر، بين نقاط العيّنات التي تمّت من خلالها الاستقراء لتحديد الارتفاع لن تتوفّر هذه السمة إذا لم تكن درجة الدقة معروفة. يُرجى العِلم أنّ بيانات الارتفاع تصبح أكثر تقريبية (قيم resolution أكبر) عند تمرير نقاط متعدّدة. للحصول على قيمة الارتفاع الأكثر دقة لنقطة معيّنة، يجب البحث عنها بشكل مستقل. |
location optional |
النوع:
LatLng optionalالموقع الجغرافي لنتيجة الارتفاع هذه. |
ElevationStatus الثوابت
google.maps.ElevationStatus
الثوابت
الحالة التي يعرضها ElevationService عند اكتمال طلب ترقية. حدِّد هذه العناصر حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'OK' أو google.maps.ElevationStatus.OK.
يمكنك الوصول إليه من خلال الاتصال بالرقم const {ElevationStatus} = await google.maps.importLibrary("elevation"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
الثوابت | |
|---|---|
INVALID_REQUEST |
الطلب غير صالح. |
OK |
لم يواجه الطلب أي أخطاء. |
OVER_QUERY_LIMIT |
تجاوزت صفحة الويب الحدّ الأقصى للطلبات في فترة زمنية قصيرة جدًا. |
REQUEST_DENIED |
لا يُسمح لصفحة الويب باستخدام خدمة الارتفاع. |
UNKNOWN_ERROR |
تعذّرت معالجة طلب الترقية بنجاح، ولكن لا يُعرف السبب الدقيق للتعذّر. |