Elevation

فئة ElevationService

google.maps.ElevationService صف
مكتبة "elevation"

يحدّد فئة خدمة تتواصل مباشرةً مع خوادم 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 interface

واجهة google.maps.LocationElevationRequest

طلب ارتفاع أرسلته ElevationService يحتوي على قائمة الإحداثيات المنفصلة (LatLng) التي سيتم عرض بيانات الارتفاع لها.
locations
اختياري
النوع: Array<LatLng|LatLngLiteral> optional
المواقع الجغرافية المنفصلة المطلوب استرداد الارتفاعات لها

LocationElevationResponse interface

واجهة google.maps.LocationElevationResponse

استجابة الارتفاع التي تعرضها ElevationService وتحتوي على قائمة ElevationResult التي تتطابق مع المواقع الجغرافية في LocationElevationRequest.
results
النوع: Array<ElevationResult>
قائمة ElevationResult التي تتطابق مع المواقع الجغرافية لـ LocationElevationRequest.

واجهة PathElevationRequest

واجهة google.maps.PathElevationRequest

طلب بحث عن الارتفاع أرسله ElevationService يحتوي على المسار الذي سيتم عرض عيّنات البيانات على طوله. يحدّد هذا الطلب مسارًا متواصلاً على طول الأرض يجب أخذ عينات الارتفاع منه على مسافات متساوية. تستخدم جميع المسارات من رأس إلى رأس أجزاء من الدائرة الكبرى بين هاتين النقطتين.
samples
النوع: number
الحقل مطلوب. عدد النقاط المتساوية المسافة على طول المسار المحدّد المطلوب استرداد بيانات الارتفاع لها، بما في ذلك نقاط النهاية. يجب أن يكون عدد العيّنات قيمة تتراوح بين 2 و512 (بما يشمل هذين الرقمَين).
path
اختياري
النوع: Array<LatLng|LatLngLiteral> optional
المسار الذي سيتم جمع قيم الارتفاع على طوله

واجهة PathElevationResponse

واجهة google.maps.PathElevationResponse

استجابة الارتفاع التي تعرضها ElevationService وتحتوي على قائمة ElevationResult متباعدة بشكل متساوٍ على طول مسار PathElevationRequest.
results
النوع: Array<ElevationResult>
قائمة ElevationResults التي تطابق عيّنات PathElevationRequest.

واجهة ElevationResult

واجهة google.maps.ElevationResult

نتيجة طلب ElevationService، وتتألف من مجموعة إحداثيات الارتفاع وقيم الارتفاع يُرجى العِلم أنّ طلبًا واحدًا قد يؤدي إلى إنشاء عدة ElevationResult.
elevation
النوع: number
ارتفاع هذه النقطة على الأرض، بالأمتار فوق مستوى سطح البحر
resolution
النوع: number
المسافة بالأمتار بين نقاط العيّنات التي تم استقراء الارتفاع منها لن تظهر هذه السمة إذا لم تكن الدقة معروفة. يُرجى العِلم أنّ بيانات الارتفاع تصبح أكثر خشونة (قيم resolution أكبر) عند تمرير نقاط متعددة. للحصول على قيمة الارتفاع الأكثر دقة لنقطة معيّنة، يجب الاستعلام عنها بشكل مستقل.
location
اختياري
النوع: LatLng optional
الموقع الجغرافي لنتيجة الارتفاع هذه

ثوابت ElevationStatus

google.maps.ElevationStatus ثوابت
مكتبة "elevation"

الحالة التي يعرضها ElevationService عند اكتمال طلب رفع مستوى الوصول. حدِّد هذه القيم حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'OK' أو google.maps.ElevationStatus.OK.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع ElevationStatusString.

const {ElevationStatus} = await google.maps.importLibrary("elevation");
INVALID_REQUEST كان الطلب غير صالح.
OK لم يواجه الطلب أي أخطاء.
OVER_QUERY_LIMIT تجاوزت صفحة الويب الحدّ الأقصى لعدد الطلبات في فترة زمنية قصيرة جدًا.
REQUEST_DENIED لا يُسمح لصفحة الويب باستخدام خدمة الارتفاع.
UNKNOWN_ERROR تعذّرت معالجة طلب الترقية بنجاح، ولكن السبب الدقيق للفشل غير معروف.