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 interface

google.maps.LocationElevationRequest interface

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

LocationElevationResponse interface

google.maps.LocationElevationResponse interface

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

PathElevationRequest interface

google.maps.PathElevationRequest interface

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

واجهة PathElevationResponse

google.maps.PathElevationResponse interface

تمثّل هذه السمة استجابة بشأن الارتفاع يتم عرضها من خلال ElevationService، وهي تحتوي على قائمة ElevationResults موزّعة بالتساوي على طول مسار PathElevationRequest.
results
النوع:  Array<ElevationResult>
قائمة ElevationResult المطابقة لعينات PathElevationRequest

واجهة ElevationResult

google.maps.ElevationResult interface

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

ElevationStatus 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 تعذّر إكمال طلب رفع مستوى الأذونات بنجاح، ولكن السبب الدقيق لهذا التعذّر غير معروف.