Elevation

فئة ElevationService

google.maps.ElevationService الصف الدراسي

تحدّد فئة الخدمة التي تتواصل مباشرةً مع خوادم Google لطلب بيانات الارتفاع.

الوصول من خلال الاتصال بـ const {ElevationService} = await google.maps.importLibrary("elevation"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
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 والتي تحتوي على قائمة ElevationResults متباعدة بالتساوي على طول مسار 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"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
INVALID_REQUEST الطلب غير صالح.
OK لم يواجه الطلب أي أخطاء.
OVER_QUERY_LIMIT تجاوزت صفحة الويب حد الطلبات في فترة زمنية قصيرة جدًا.
REQUEST_DENIED غير مسموح لصفحة الويب باستخدام خدمة الارتفاع.
UNKNOWN_ERROR تعذرت معالجة طلب الارتفاع بنجاح، ولكن سبب الفشل الدقيق غير معروف حتى الآن.