نمای کلی Elevation API

Elevation API سرویسی است که داده های ارتفاع را برای یک مکان روی زمین، یا داده های ارتفاع نمونه برداری شده در طول مسیرها را برمی گرداند.

چرا از Elevation API استفاده کنیم؟

با Elevation API، می‌توانید برنامه‌هایی را برای پشتیبانی از مشتریان خود با فعالیت‌های حساس به ارتفاع، برنامه‌های موقعیت‌یابی، یا برنامه‌های کاربردی کم نقشه‌برداری که شامل ارتفاعات و تغییرات ارتفاع در طول مسیرها هستند، توسعه دهید. به عنوان مثال، می‌توانید داده‌های افزایش و تلفات ارتفاع را برای بهبود یک برنامه ورزشی برای فعالیت‌هایی مانند پیاده‌روی، دوچرخه‌سواری یا غواصی ارائه دهید.

کارهایی که می توانید با Elevation API انجام دهید

با Elevation API، می توانید داده های ارتفاع را در برنامه های خود یا روی نقشه قرار دهید. به عنوان مثال:

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

Elevation API چگونه کار می کند

Elevation API یک درخواست را به عنوان یک URL رمزگذاری شده با مختصات طول و عرض جغرافیایی می پذیرد که به صورت مکان های مجزا یا به صورت مجموعه ای از مکان ها در امتداد یک مسیر ارائه می شود. این درخواست، برای مثال، ارتفاع مرکز دنور، کلرادو را جستجو می‌کند و بازگشتی را در قالب JSON مشخص می‌کند.
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

این سرویس ارتفاع را برای مختصات ارائه شده استخراج می کند. همچنین ارتفاع را برای یک مکان بدون ارتفاع درون‌یابی می‌کند و میانگینی را از چهار نزدیک‌ترین مکان که داده‌های ارتفاعی را ارائه می‌دهند، ارائه می‌کند. در نهایت، وضوح کلی مکان را تعیین می کند.

منابع

جدول زیر منابع موجود از طریق Elevation API را به همراه داده هایی که برمی گرداند خلاصه می کند.

منابع داده داده ها برگردانده شد فرمت بازگشت
مختصات طول و عرض جغرافیایی

می توانید داده ها را به صورت مجموعه ای از یک یا چند مکان یا به صورت مجموعه ای در طول یک مسیر ارائه دهید. شما همچنین می توانید مختصات رمزگذاری شده را ارائه دهید. تا 512 مختصات را پاس کنید.

Elevation API ارتفاع را بر حسب متر نسبت به سطح متوسط ​​محلی دریا (LMSL) فراهم می کند. ارتفاع را می توان به صورت مقادیر مثبت یا منفی که در زیر نشان داده شده است برگرداند:

  • مقادیر مثبت مکان‌های بالای LMSL را نشان می‌دهند، از جمله مکان‌های سطحی یا کف دریاچه‌های با ارتفاع بالا.
  • مقادیر منفی مکان هایی را نشان می دهد که زیر LMSL هستند، از جمله مکان هایی روی سطح یا کف اقیانوس.
  • وضوح فاصله بین نقطه داده و ارتفاع را بر حسب متر نشان می دهد.
  • JSON
  • XML

نحوه استفاده از Elevation API

1 راه اندازی شود. با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی را تکمیل کنید.
2 درخواست ارتفاع را امتحان کنید هنگامی که یک کلید API دارید، می توانید آزمایش Elevation API را مستقیماً از مرورگر خود شروع کنید. برای جزئیات بیشتر به نمونه درخواست ها در راهنمای شروع کار مراجعه کنید.
3 درخواست پیچیده تری بنویسید پس از راه‌اندازی پروژه، درخواستی را امتحان کنید که داده‌های مکان را در طول یک مسیر ارائه می‌کند. برای جزئیات بیشتر به تعیین مسیرها مراجعه کنید.
4 اصول پاسخگویی را درک کنید برای آماده شدن برای استفاده از داده های ارتفاع برای برنامه خود، پاسخ های داده های ارتفاع را کاوش کنید. برای جزئیات بیشتر به پاسخ های ارتفاعی مراجعه کنید.
5 داده های ارتفاع را در برنامه خود بگنجانید! می‌توانید از داده‌های ارتفاع برای بهبود برنامه‌های مبتنی بر مکان، مانند برنامه‌های فعالیت‌های ورزشی یا داده‌های نظرسنجی استفاده کنید.

کتابخانه های مشتری موجود

این API را به زبان انتخابی خود از طریق یکی از کتابخانه های سرویس گیرنده زیر فراخوانی کنید:

Java Client، Python Client، Go Client و Node.js Client برای سرویس‌های Google Maps، کتابخانه‌های مشتری پشتیبانی شده توسط جامعه هستند که تحت مجوز Apache 2.0 منبع باز هستند. آنها را از GitHub دانلود کنید، جایی که می توانید دستورالعمل های نصب و کد نمونه را پیدا کنید.

بعدش چی