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