نمای کلی Elevation API

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

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

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

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

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

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

نحوه عملکرد Elevation API

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

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

منابع

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

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

می‌توانید داده‌ها را به‌صورت مجموعه‌ای از یک یا چند مکان، یا به‌صورت مجموعه‌ای درطول یک مسیر ارائه دهید. همچنین می‌توانید مختصات کدگذاری‌شده ارائه دهید. حداکثر ۵۱۲ مختصات را ارسال کنید.

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

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

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

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

کتابخانه‌های کارخواه دردسترس

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

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

قدم بعدی چیست