Elevation

کلاس ElevationService

‫google.maps.ElevationService کلاس

کلاس سرویسی را تعریف می‌کند که مستقیماً با سرورهای Google برای درخواست داده‌های ارتفاع صحبت می‌کند.

با تماس با const {ElevationService} = await google.maps.importLibrary("elevation") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

سازنده
ElevationService	ElevationService() پارامترها:  هیچ نمونه جدیدی از ElevationService ایجاد می‌کند که پُرسمان‌های ارتفاع را به سرورهای Google ارسال می‌کند.

روش‌ها
getElevationAlongPath	getElevationAlongPath(request[, callback]) پارامترها:  ‫request:  PathElevationRequest ‫callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional مقدار برگشتی:  Promise<PathElevationResponse> درخواست ارتفاع را درطول یک مسیر ایجاد می‌کند، جایی که داده‌های ارتفاع به‌عنوان نمونه‌های مبتنی بر فاصله درطول آن مسیر برگردانده می‌شوند.
getElevationForLocations	getElevationForLocations(request[, callback]) پارامترها:  ‫request:  LocationElevationRequest ‫callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional مقدار برگشتی:  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 الزامی. تعداد نقاط با فاصله مساوی در امتداد مسیر ارائه‌شده که داده‌های ارتفاع برای آن‌ها بازیابی می‌شود، ازجمله نقاط پایانی. تعداد نمونه‌ها باید مقداری بین ۲ تا ۵۱۲ باشد.
path optional	نوع:  Array<LatLng|LatLngLiteral> optional مسیری که مقادیر ارتفاع در آن جمع‌آوری می‌شود.

میانای PathElevationResponse

میانا google.maps.PathElevationResponse

پاسخ ارتفاعی که توسط ElevationService برگردانده شده است و حاوی فهرست ElevationResultهایی است که به‌طور مساوی درطول مسیر 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") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

ثابت‌ها
INVALID_REQUEST	درخواست نامعتبر بود.
OK	درخواست با هیچ خطایی مواجه نشد.
OVER_QUERY_LIMIT	صفحه وب در مدت زمان بسیار کوتاهی از حد مجاز درخواست‌ها فراتر رفته است.
REQUEST_DENIED	صفحه وب مجاز به استفاده از سرویس ارتفاع نیست.
UNKNOWN_ERROR	درخواست ارتقا با موفقیت پردازش نشد، اما دلیل دقیق این شکست مشخص نیست.