شروع به کار

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

این سرویس همچنین به عنوان بخشی از API جاوا اسکریپت Maps سمت کلاینت یا برای استفاده سمت سرور با Java Client، Python Client، Go Client و Node.js Client برای سرویس‌های نقشه‌های گوگل در دسترس است.

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

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

مثال زیر ارتفاع شهر دنور، کلرادو، "شهر مایل های"، را در قالب JSON درخواست می‌کند:

آدرس اینترنتی 
https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY
حلقه 
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 های درخواست و پارامترهای موجود و درک پاسخ، به راهنمای توسعه دهنده مراجعه کنید.

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

جی‌سون 
      
{
  "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>
</pre>
شروع به کدنویسی با کتابخانه‌های کلاینت ما کنید

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

احراز هویت، سهمیه‌ها، قیمت‌گذاری و سیاست‌ها احراز هویت

برای استفاده از Elevation API، ابتدا باید API را فعال کرده و اعتبارنامه‌های احراز هویت مناسب را دریافت کنید. برای اطلاعات بیشتر، به «شروع به کار با پلتفرم نقشه‌های گوگل» مراجعه کنید.

سهمیه‌ها و قیمت‌گذاری

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

سیاست‌ها

استفاده از API مربوط به ارتفاع باید مطابق با سیاست‌های API باشد.

بیشتر بدانید

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

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