Elevation

کلاس ElevationService

google.maps . 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 رابط google.maps . LocationElevationRequest

یک درخواست ارتفاع ارسال شده توسط ElevationService حاوی لیست مختصات گسسته ( LatLng s) که برای بازگرداندن داده های ارتفاعی.

locations optional
نوع: Array < LatLng | LatLngLiteral > optional
مکان های مجزا که برای بازیابی ارتفاعات.

رابط LocationElevationResponse

google.maps . LocationElevationResponse رابط google.maps . LocationElevationResponse

یک پاسخ ارتفاعی که توسط ElevationService برگردانده شده است، حاوی لیستی از ElevationResult که با مکان‌های LocationElevationRequest مطابقت دارند.

results
نوع: Array < ElevationResult >
لیست ElevationResult که با مکان های LocationElevationRequest مطابقت دارد.

رابط PathElevationRequest

google.maps . PathElevationRequest رابط google.maps . PathElevationRequest

یک درخواست ارتفاع ارسال شده توسط ElevationService که حاوی مسیری است که در امتداد آن داده های نمونه برگردانده می شود. این درخواست یک مسیر پیوسته را در امتداد زمین تعریف می کند که در طول آن نمونه های ارتفاعی باید در فواصل مساوی گرفته شوند. همه مسیرها از راس به رأس از بخش هایی از دایره بزرگ بین آن دو نقطه استفاده می کنند.

samples
نوع: number
ضروری. تعداد نقاط مساوی در طول مسیر داده شده برای بازیابی اطلاعات ارتفاع، از جمله نقاط پایانی. تعداد نمونه ها باید مقداری بین 2 تا 512 باشد.
path optional
نوع: Array < LatLng | LatLngLiteral > optional
مسیری که در طول آن مقادیر ارتفاع جمع آوری می شود.

رابط PathElevationResponse

google.maps . PathElevationResponse رابط google.maps . PathElevationResponse

یک پاسخ ارتفاعی که توسط ElevationService برگردانده شده است، حاوی لیستی از ElevationResult با فاصله مساوی در طول مسیر PathElevationRequest .

results
نوع: Array < ElevationResult >
لیست ElevationResult که با نمونه های PathElevationRequest مطابقت دارد.

رابط ElevationResult

google.maps . ElevationResult رابط google.maps . ElevationResult

نتیجه یک درخواست ElevationService ، شامل مجموعه مختصات ارتفاع و مقادیر ارتفاع آنها. توجه داشته باشید که یک درخواست ممکن است چندین ElevationResult تولید کند.

elevation
نوع: number
ارتفاع این نقطه روی زمین، بر حسب متر از سطح دریا.
resolution
نوع: number
فاصله، بر حسب متر، بین نقاط نمونه که ارتفاع از آن درون یابی شده است. اگر وضوح مشخص نباشد، این ویژگی از بین خواهد رفت. توجه داشته باشید که داده‌های ارتفاعی درشت‌تر می‌شوند (مقادیر resolution بزرگ‌تر) با عبور از چندین نقطه. برای به دست آوردن دقیق ترین مقدار ارتفاع برای یک نقطه، باید به طور مستقل از آن پرس و جو کرد.
location optional
نوع: LatLng optional
محل این ارتفاع نتیجه.

ثابت های وضعیت ارتفاع

google.maps . 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 درخواست ارتفاع نمی تواند با موفقیت پردازش شود، اما دلیل دقیق شکست مشخص نیست.