Elevation

فئة 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 تعذّرت معالجة طلب الترقية بنجاح، ولكن لا يُعرف السبب الدقيق للتعذّر.