شروع کنید

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

این سرویس همچنین به عنوان بخشی از Maps JavaScript API سمت سرویس گیرنده یا برای استفاده در سمت سرور با Java Client، Python Client، Go Client و Node.js Client برای خدمات Google Maps در دسترس است.

نمونه درخواست و پاسخ

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

مثال زیر ارتفاع دنور، کلرادو، "Mile High City" را در قالب JSON درخواست می کند:

URL 

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

CURL 

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

می‌توانید این مورد را با وارد کردن URL در مرورگر وب خود آزمایش کنید (حتماً YOUR_API_KEY با کلید API واقعی خود جایگزین کنید). پاسخ شامل ارتفاع در آن نقطه، بر حسب متر، همراه با مقدار وضوح (حداکثر فاصله بین نقاط داده ای که ارتفاع از آنها درون یابی شده، بر حسب متر) می باشد.

برای اطلاعات بیشتر در مورد ساخت URL های درخواست و پارامترهای موجود و درک پاسخ ، راهنمای توسعه دهنده را مشاهده کنید.

در زیر یک نمونه پاسخ آمده است:

JSON 

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
    ],
  "status": "OK",
}

XML 

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
</ElevationResponse>

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

کتابخانه‌های مشتری با ارائه پیاده‌سازی‌های ساده و بومی وظایف رایج، مانند احراز هویت، کاهش درخواست و تلاش مجدد خودکار، توسعه با سرویس وب Google Maps را آسان‌تر می‌کنند. Elevation API در Java Client، Python Client، Go Client و Node.js Client برای خدمات Google Maps موجود است.

احراز هویت، سهمیه بندی، قیمت گذاری، و سیاست ها

احراز هویت

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

سهمیه بندی و قیمت گذاری

صفحه استفاده و صورت‌حساب را برای جزئیات بیشتر در مورد سهمیه‌ها و قیمت‌گذاری تعیین‌شده برای Elevation API مرور کنید.

سیاست ها

استفاده از Elevation API باید مطابق با خط مشی های API باشد.

بیشتر بدانید

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

راهنمای توسعه‌دهنده Elevation API برای توسعه‌دهندگان وب‌سایت و تلفن همراه در نظر گرفته شده است که می‌خواهند از داده‌های ارتفاع در نقشه‌های ارائه‌شده توسط یکی از APIهای پلتفرم Google Maps استفاده کنند. مقدمه ای برای استفاده از API و مواد مرجع در پارامترهای موجود ارائه می دهد.