모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Maps Roads API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Maps Roads API 활성화
  3. 적합한 키 생성
계속

가장 가까운 도로

Google Maps Roads API는 최대 100개의 독립적인 좌표를 취하고 각 지점에 대한 가장 가까운 도로 구간을 반환합니다. 전달된 지점은 연속 경로의 일부일 필요가 없습니다.

순차적 GPS 지점을 사용하여 작업하는 경우 Snap to Roads를 사용합니다.

요청

가장 가까운 도로 요청은 다음 형식에 따라 HTTPS를 통해 전송해야 합니다.

https://roads.googleapis.com/v1/nearestRoads?parameters&key=YOUR_API_KEY

매개변수 사용

필수 매개변수

  • points — 위도/경도 쌍의 목록. 위도 및 경도 값은 쉼표로 구분되어야 합니다. 좌표는 파이프 문자 "|"로 구분되어야 합니다. For example: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
  • key — 애플리케이션의 API 키. 애플리케이션은 요청을 Google Maps Roads API에 전송할 때마다 각 요청에 API 키를 포함하여 스스로를 식별해야 합니다. 키 가져오기 방법에 대해 알아봅니다.

응답

올바른 각 요청에 대해, Google Maps Roads API는 요청 URL에 나타난 형식으로 응답을 반환합니다. 다음 요소가 Snap to Roads 응답에 있을 수도 있습니다.

  • snappedPoints — 스냅된 지점의 배열. 각 지점은 다음과 같은 필드로 구성됩니다.
    • locationlatitudelongitude 값을 포함합니다.
    • originalIndex — 원래 요청의 해당 값을 나타내는 정수. 요청의 각 지점은 응답에서 최대 두 구간에 매핑됩니다.
      • 주변 도로가 없는 경우 구간이 반환되지 않습니다.
      • 가장 가까운 도로가 일방 통행 도로인 경우 한 구간이 반환됩니다.
      • 가장 가까운 도로가 양방 통행 도로인 경우 두 구간이 반환됩니다.
    • placeId — 장소의 고유 식별자. Google Maps Roads API에서 반환되는 모든 장소 ID는 도로 구간에 해당합니다. [장소 ID]는 다른 Google API에 사용할 수 있으며 Google Places APIGoogle Maps JavaScript API를 포함합니다. 예를 들어, 스냅된 지점의 도로 이름을 Google Maps Roads API에서 반환하도록 하려는 경우, placeIdGoogle Places API 또는 Google Maps Geocoding API에 전달할 수 있습니다. Google Maps Roads API에서는 속도 제한 요청에 placeId를 전달하여 해당 도로 구간을 따라 속도 제한을 결정할 수 있습니다.

예시 요청

다음 요청은 지정된 좌표 목록에 기반한 도로 구간 집합을 반합니다.

요청

https://roads.googleapis.com/v1/nearestRoads?points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796&key=YOUR_API_KEY

응답

{
  "snappedPoints": [
    {
      "location": {
        "latitude": 60.170877918672588,
        "longitude": 24.942699821922421
      },
      "originalIndex": 0,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170876898776406,
        "longitude": 24.942699912064771
      },
      "originalIndex": 1,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170874902634374,
        "longitude": 24.942700088491474
      },
      "originalIndex": 2,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    }
  ]
}

다음에 대한 의견 보내기...

Google Maps Roads API
Google Maps Roads API
도움이 필요하시나요? 지원 페이지를 방문하세요.