הגישה ל-Elevation API מתבצעת דרך ממשק HTTP, עם בקשות שנוצרות כמחרוזת של כתובת URL, באמצעות קואורדינטות של רוחב וקו אורך כדי לזהות את המיקומים או את הקודקודים של הנתיב. הבקשות חייבות לכלול את מפתח ה-API.
בדוגמה הבאה מופיעה בקשה לקבלת הגובה של דנוור, קולורדו, 'העיר בגובה של מייל', בפורמט JSON:
כדי לבדוק זאת, מזינים את כתובת ה-URL בדפדפן האינטרנט (חשוב להחליף את YOUR_API_KEY במפתח ה-API בפועל).
התגובה כוללת את הגובה בנקודה הזו, במטרים, יחד עם ערך הרזולוציה (המרחק המקסימלי בין נקודות הנתונים שמהן בוצעה אינטרפולציה של הגובה, במטרים).
ספריות הלקוח מאפשרות לפתח בקלות באמצעות ממשקי ה-API של שירותי האינטרנט של מפות Google, על ידי מתן הטמעות פשוטות ונפוצות של משימות נפוצות, כמו אימות, הגבלת בקשות וניסיון חוזר אוטומטי. Elevation API זמין בלקוח Java, בלקוח Python, בלקוח Go ובלקוח Node.js לשירותי מפות Google.
המדריך למפתחים של Elevation API מיועד למפתחי אתרים ואפליקציות לנייד שרוצים להשתמש בנתוני גובה במפות שמספק אחד מממשקי ה-API של הפלטפורמה של מפות Google. במאמר הזה מוסבר איך משתמשים ב-API ומופיע חומר עזר בנושא הפרמטרים הזמינים.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-09-05 (שעון UTC)."],[[["\u003cp\u003eThe Elevation API provides elevation data for all locations on the surface of the earth, including ocean floor depths.\u003c/p\u003e\n"],["\u003cp\u003eYou can access the Elevation API through an HTTP interface using latitude/longitude coordinates, requiring an API key for requests.\u003c/p\u003e\n"],["\u003cp\u003eThe API can be used with client-side Maps JavaScript API or server-side with Java, Python, Go, and Node.js client libraries.\u003c/p\u003e\n"],["\u003cp\u003eA billing account and enabled Elevation API are prerequisites for using the API, and creating multiple project owners/billing administrators is recommended.\u003c/p\u003e\n"]]],[],null,["| **Before you begin:** Before you start using the Elevation API, you need a project with a billing account and the Elevation API enabled. We recommend creating multiple Project Owners and Billing Administrators, so that you'll always have someone with these roles available to your team. To learn more, see [Set up in Cloud console](/maps/documentation/elevation/cloud-setup).\n\nThe Elevation API provides elevation data for all locations on the\nsurface of the earth, including depth locations on the ocean floor (which\nreturn negative values). \nThis service is also available as part of the client-side\n[Maps JavaScript API](/maps/documentation/javascript/elevation),\nor for server-side use with the\n[Java Client,\nPython Client, Go Client and Node.js Client for Google Maps Services](/maps/documentation/elevation/client-library).\n\nSample request and response\n\nYou access the Elevation API through an HTTP interface, with\nrequests constructed as a URL string, using latitude/longitude coordinates to\nidentify the locations or path vertices. Requests must include your API key.\n\nThe following example requests the elevation for Denver, Colorado, the\n\"Mile High City\", in JSON format: \n\nURL \n\n```scdoc\nhttps://maps.googleapis.com/maps/api/elevation/json\n ?locations=39.7391536%2C-104.9847034\n &key=YOUR_API_KEY\n```\n\ncURL \n\n```bash\ncurl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'\n```\n\nYou can test this by entering the URL into your web browser (be sure to replace\n`YOUR_API_KEY` with [your actual API key](#get-a-key)).\nThe response includes the elevation at that point, in meters, along with\nthe resolution value (the maximum distance between data points from which the\nelevation was interpolated, in meters).\n\nView the [developer's guide](/maps/documentation/elevation/overview)\nfor more information about\n[building request URLs and available parameters](/maps/documentation/elevation/overview#ElevationRequests)\nand [understanding the response](/maps/documentation/elevation/overview#ElevationResponses).\n\nBelow is a sample response: \n\nJSON \n\n```json\n{\n \"results\":\n [\n {\n \"elevation\": 1608.637939453125,\n \"location\": { \"lat\": 39.7391536, \"lng\": -104.9847034 },\n \"resolution\": 4.771975994110107,\n },\n ],\n \"status\": \"OK\",\n}\n```\n\nXML \n\n```xml\n\u003cElevationResponse\u003e\n \u003cstatus\u003eOK\u003c/status\u003e\n \u003cresult\u003e\n \u003clocation\u003e\n \u003clat\u003e39.7391536\u003c/lat\u003e\n \u003clng\u003e-104.9847034\u003c/lng\u003e\n \u003c/location\u003e\n \u003celevation\u003e1608.6379395\u003c/elevation\u003e\n \u003cresolution\u003e4.7719760\u003c/resolution\u003e\n \u003c/result\u003e\n\u003c/ElevationResponse\u003e\n```\n\nStart coding with our client libraries\n\nClient libraries make\ndeveloping with the Google Maps web service APIs easier by providing simple,\nnative implementations of common tasks, such as authentication, request\nthrottling and automatic retry. The Elevation API is available\nin the\n[Java Client,\nPython Client, Go Client and Node.js Client for Google Maps Services](/maps/documentation/elevation/client-library).\n\nAuthentication, quotas, pricing, and policies\n\nAuthentication\n\nTo use the Elevation API, you must first enable the API and obtain the proper\nauthentication credentials. For more information, see\n[Get Started with Google Maps Platform](/maps/get-started).\n\nQuotas and pricing\n\nReview the [usage and billing](/maps/documentation/elevation/usage-and-billing)\npage for details on the quotas and pricing set for the Elevation API.\n\nPolicies\n\nUse of the Elevation API must be in accordance with the\n[API policies](/maps/documentation/elevation/policies).\n\nLearn more\n\nThere's more you can do with the Elevation API, like\n[requesting elevation data\nfrom multiple locations](/maps/documentation/elevation/overview#PointElevation). See the [Elevation API Developer's Guide](/maps/documentation/elevation/overview) for more\nexamples and other details.\n\nThe [Elevation API Developer's Guide](/maps/documentation/elevation/overview) is intended for website and\nmobile developers who want to use elevation data within maps provided by one of the\nGoogle Maps Platform APIs. It provides an introduction to using the API and reference\nmaterial on the available parameters."]]
