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
서비스는 제공된 좌표의 고도를 가져옵니다. 또한
고도가 없는 위치의 고도로, 4에서 반환된 평균을 제공
고도 데이터를 제공하는 가장 가까운 위치. 마지막으로 모델의 전반적인
해상도를 반환합니다.
리소스
다음 표에는
Elevation API 및 반환된 데이터
| 데이터 리소스 |
반환된 데이터 |
반환 형식 |
| 위도/경도 좌표
데이터를 하나 이상의 위치 집합이나 경로 상의 계열로 제공할 수 있습니다. 나
인코딩된 좌표를 제공할 수 있습니다. 최대 512개의 좌표를 전달합니다.
|
Elevation API는 미터 단위의 고도를 상대적인
국지 평균 해수면 (LMSL)까지 표시됩니다. 고도는 양수로 반환될 수 있습니다.
또는 음수 값 중에서 선택할 수 있습니다.
- 양수 값은 LMSL 위의 위치를 나타냅니다.
다양한 데이터 레이크와 데이터 레이크를 사용할 수 있습니다.
- 음수 값은 다음을 포함하여 LMSL 미만의 위치를 나타냅니다.
해저 위치를 측정할 수 있습니다.
- 해상도는 데이터 포인트와 대상 사이의 거리를 나타냅니다.
고도(미터)입니다.
|
|
Elevation API 사용 방법
| 1 |
설정하기 |
먼저 설정
Google Cloud 프로젝트
설정을 완료하고
참고하세요. |
| 2 |
고도 요청 사용해 보기 |
API 키가 있으면 Elevation API를
영향을 받습니다. 샘플 요청을 참고하세요.
시작하기 가이드를 참조하세요.
|
| 3 |
더 복잡한 요청 작성 |
프로젝트를 설정한 다음, 위치와 함께 위치 데이터를 제공하는 요청을 시도해 보세요.
있습니다. 경로 지정을 참조하세요.
참조하세요.
|
| 4 |
응답 기본사항 이해하기 |
고도 데이터 응답을 살펴보고 앱에 고도 데이터 사용을 준비하세요. 자세한 내용은
고도 응답
참조하세요.
|
| 5 |
고도 데이터를 앱에 통합하세요. |
고도 데이터를 사용하여 위치 기반 앱(예: 스포츠 앱)을 개선할 수 있습니다.
설문 조사 데이터에 사용할 수 있습니다.
|
사용 가능한 클라이언트 라이브러리
이 API를 다음 언어로 호출
다음 클라이언트 라이브러리 중 하나를 통해 사용할 수 있습니다.
Google 지도용 Java 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트
서비스는 커뮤니티 지원 클라이언트 라이브러리로,
Apache 2.0 라이선스.
GitHub에서 다운로드하세요. GitHub에서 설치 안내와 샘플 코드도 찾을 수 있습니다.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eThe Elevation API provides elevation data for locations on Earth, enabling applications with elevation-sensitive features.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve elevation for single points or calculate elevation differences along paths, useful for activities like hiking or biking.\u003c/p\u003e\n"],["\u003cp\u003eThe API accepts latitude/longitude coordinates and returns elevation data in meters relative to local mean sea level, with resolution information.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access the Elevation API through various client libraries (Java, Python, Go, Node.js) and integrate it into their applications.\u003c/p\u003e\n"],["\u003cp\u003eTo get started, set up a Google Cloud project, try sample requests, and explore the documentation for detailed usage instructions.\u003c/p\u003e\n"]]],[],null,["The Elevation API is a service that returns elevation data for\na location on the earth, or sampled elevation data along paths.\n\nWhy use the Elevation API\n\nWith the Elevation API, you can develop applications to support your\ncustomers with elevation-sensitive activities, positioning applications, or low-surveying\napplications that include elevations and elevation changes along routes. For example,\nyou can provide elevation gain and loss data to enhance a sports application for activities such\nas hiking, biking, or scuba diving.\n\nWhat you can do with the Elevation API\n\nWith the Elevation API, you can include elevation data in your\napplications or on a map. For example:\n\n- Get the **elevation** for a particular place.\n- Calculate the **differences** in elevation along a route or between two points.\n\nHow the Elevation API works The Elevation API accepts a request as an encoded URL with latitude/longitude coordinates provided as either discrete locations, or as a series of locations along a path. This request, for example, queries elevation for the center of Denver, Colorado, specifying a return in JSON format. \n\n```scdoc\n https://maps.googleapis.com/maps/api/elevation/json\n ?locations=39.7391536%2C-104.9847034\n &key=YOUR_API_KEY\n```\n\nThe service derives the elevation for the provided coordinates. It also interpolates\nelevation for a location without elevation, providing an average returned from the four\nnearest locations that do provide elevation data. Finally, it determines the overall\nresolution for the location.\n\nResources\n\nThe following table summarizes the resources available through the\nElevation API along with the data it returns.\n\n| Data resources | Data returned | Return format |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| **Latitude/longitude coordinates** You can provide data as a set of one or more locations, or as a series along a path. You can also provide encoded coordinates. Pass up to 512 coordinates. | The Elevation API provides **elevation in meters** relative to the **local mean sea level** (LMSL). Elevation can be returned as positive or negative values as indicated below: - **Positive values** indicate locations above LMSL, including surface locations or the bottom of high-altitude lakes. - **Negative values** indicate locations that are below LMSL, including locations on the surface or the ocean floor. - **Resolution** indicates the distance between the data point and the elevation, in meters. | - JSON - XML |\n\nHow to use the Elevation API\n\n|---|---------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/elevation/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try an elevation request** | Once you have an API key, you can start testing out the Elevation API directly from your browser. See [Sample requests](/maps/documentation/elevation/start#sample-request) in the *Getting started* guide for details. |\n| 3 | **Compose a more complex request** | Once you are set up with a project, try a request that supplies a location data along a path. See [Specifying paths](/maps/documentation/elevation/requests-elevation#Paths) for details. |\n| 4 | **Understand response basics** | Explore the elevation data responses to prepare to use elevation data for your app. See [Elevation responses](/maps/documentation/elevation/requests-elevation#ElevationResponses) for details. |\n| 5 | **Incorporate elevation data into your own app!** | You can use elevation data to enhance location-based apps, such as apps for sports activities or for survey data. |\n\nAvailable client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n\n- **Start using the Elevation API** : Go to [Set up your\n Google Cloud project](/maps/documentation/elevation/cloud-setup).\n- **Try getting path-based elevation data** : Go to [Specifying paths](/maps/documentation/elevation/requests-elevation#Paths)\n- **Follow best practices** : Go to [Web Service\n Best Practices](/maps/documentation/elevation/web-service-best-practices)."]]
