Elevation

فئة ElevationService

صف واحد (google.maps.ElevationService)

تحدد فئة الخدمة التي تتواصل مباشرةً إلى خوادم Google لطلب بيانات المسقط الرأسي.

يمكنك الوصول من خلال الاتصال على الرقم const {ElevationService} = await google.maps.importLibrary("elevation"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

INVALID_REQUEST هذا الطلب غير صالح.
OK لم يواجه الطلب أي أخطاء.
OVER_QUERY_LIMIT تجاوزت صفحة الويب الحد الأقصى للطلبات خلال فترة زمنية قصيرة جدًا.
REQUEST_DENIED لا يُسمح لصفحة الويب باستخدام خدمة المسقط الرأسي.
UNKNOWN_ERROR تعذَّرت معالجة طلب الترقية بنجاح، إلا أنّ السبب الدقيق للفشل غير معروف.