모든 준비를 마쳤습니다!

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

Google Maps Roads API 활성화

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

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

속도 제한

참고: 속도 제한 서비스는 자산 추적 라이선스를 가진 Google Maps API 프리미엄 플랜 고객만 사용할 수 있습니다.

Google Maps Roads API는 해당 도로 구간에 대한 속도 제한을 반환합니다. 다양한 속도 제한이 있는 도로 구간의 경우, 구간의 기본 속도 제한이 반환됩니다.

Google Maps Roads API에서 반환되는 속도 제한 데이터의 정확도는 보증되지 않습니다. 제공되는 속도 제한 데이터는 실시간이 아니며, 부정확하고 불완전하고 오래된 예측값일 수 있습니다. 데이터의 부정확도는 Google Map Maker 서비스를 통해 신고하실 수 있습니다.

요청

속도 제한 요청은 다음 형식에 따라 HTTPS를 통해 전송되어야 합니다.

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

매개변수 사용

필수 매개변수

  • 하나의 path 또는 하나 이상의 placeId.
    • path — 스냅하려는 경로. path 매개변수는 위도/경도 쌍의 목록을 허용합니다. 위도 및 경도 값은 쉼표로 구분되어야 합니다. 좌표는 파이프 문자 "|"로 구분되어야 합니다. 예: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
    • placeId — 도로 구간의 장소 ID. 장소 ID는 snapToRoadsnearestRoads 요청에 대한 응답으로 반환됩니다. 각 요청에 최대 100개의placeId를 전달할 수 있습니다.
  • key — 애플리케이션의 API 키. 애플리케이션은 요청을 Google Maps Roads API에 전송할 때마다 각 요청에 API 키를 포함하여 스스로를 식별해야 합니다. 키 가져오기 방법에 대해 알아봅니다.

선택적 매개변수

  • units — 속도 제한을 시간당 킬로미터 또는 마일로 반환할지 여부. KPH 또는 MPH로 설정할 수 있습니다. 기본값은 KPH입니다.

하나의 path 또는 일련의 placeId를 사용하여 속도 제한 데이터를 요청할 수 있지만, 요청의 각 고유 placeId에 대해 하나의 응답만을 수신할 것입니다. 짧은 거리에 여러 개의 지점이 있을 경우, 중복된 placeId가 있을 수도 있습니다.

응답

다음 요소가 speedLimits 응답에 있을 수도 있습니다.

  • speedLimits — 도로 메타데이터의 배열. 각 요소는 다음과 같은 필드로 구성됩니다.
    • placeId — 장소의 고유 식별자. Google Maps Roads API에서 반환되는 모든 placeId는 도로 구간에 해당합니다.
    • speedLimit — 해당 도로 구간의 속도 제한.
    • unitsKPH 또는 MPH를 반환합니다.
  • snappedPoints — 스냅된 지점의 배열. 이 배열은 요청에 path 매개변수가 포함된 경우에만 존재합니다. 각 지점은 다음과 같은 필드로 구성됩니다.
    • locationlatitudelongitude 값을 포함합니다.
    • originalIndex — 원래 요청의 해당 값을 나타내는 정수. 요청의 각 값은 응답의 스냅된 값에 매핑되어야 합니다. 이값은 0부터 인덱싱되므로, originalIndex4인 지점은 path매개변수로 전달된 5번째 위도/경도의 스냅된 값이 됩니다.
    • placeId — 장소의 고유 식별자. Google Maps Roads API에서 반환되는 모든 placeId는 도로 구간에 해당합니다. 속도 제한 요청에서 placeId를 전달하여, 도로 구간을 따라 속도 제한을 결정할 수 있습니다.

예시 요청

다음 요청에서는 호주 캔버라의 짧은 거리 도로에서 속도 제한을 판별합니다.

요청

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJ1Wi6I2pNFmsRQL9GbW7qABM
        &placeId=ChIJ58xCoGlNFmsRUEZUbW7qABM
        &placeId=ChIJ9RhaiGlNFmsR0IxAbW7qABM
        &placeId=ChIJabjuhGlNFmsREIxAbW7qABM
        &placeId=ChIJcSAlFWpNFmsRMHlUbW7qABM
        &placeId=ChIJI2FUTGhNFmsRcHpAbW7qABM
        &placeId=ChIJiy6YT2hNFmsRkHZAbW7qABM
        &placeId=ChIJoR7CemhNFmsRQB9QbW7qABM
        &placeId=ChIJP2m_FWpNFmsRIHlUbW7qABM
        &placeId=ChIJtV7La2pNFmsRAGpHbW7qABM
        &placeId=ChIJW5JAZmpNFmsRegG0-Jc80sM
        &placeId=ChIJW9R7smlNFmsRMH1AbW7qABM
        &placeId=ChIJy8c0r2lNFmsRQEZUbW7qABM
        &key=YOUR_API_KEY

응답

{
  "speedLimits": [
    {
      "placeId": "ChIJ1Wi6I2pNFmsRQL9GbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ58xCoGlNFmsRUEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ9RhaiGlNFmsR0IxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJabjuhGlNFmsREIxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJcSAlFWpNFmsRMHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJI2FUTGhNFmsRcHpAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJiy6YT2hNFmsRkHZAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJoR7CemhNFmsRQB9QbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJP2m_FWpNFmsRIHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJtV7La2pNFmsRAGpHbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW5JAZmpNFmsRegG0-Jc80sM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW9R7smlNFmsRMH1AbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJy8c0r2lNFmsRQEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    }
  ]
}

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

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