Roads API는 지정된 도로의 규정 속도 제한을 반환합니다. 세그먼트입니다. 다양한 속도 제한이 있는 도로 구간의 경우 기본값은 구간의 속도 제한이 반환됩니다.
Roads API에서 반환한 속도 제한 데이터의 정확도 보장할 수는 없습니다. 제공된 속도 제한 데이터는 실시간이 아니며 부정확하거나, 불완전하거나, 최신이 아닐 수 있습니다. 범위 세부정보를 확인하세요. 를 참조하세요.
요청
속도 제한 요청은 다음 형식에 따라 HTTPS를 통해 전송되어야 합니다.
https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY
매개변수 사용
필수 매개변수
path
또는placeId
매개변수입니다.path
- 데이터를 나타내는 최대 100개의 위도/경도 쌍 목록이 경로 위도와 경도 값은 쉼표로 구분해야 합니다. 위도/경도 쌍은 파이프 문자 '|'로 구분되어야 합니다.path
매개변수를 제공하면 API가 먼저 차량으로 이동할 가능성이 가장 높은 도로를 나타냅니다 (예:snapToRoads
요청)에서 가져온 다음 확인할 수 있습니다. API가 경로를 맞추지 않도록 하려면 아래에 설명된 대로placeId
매개변수를 전달해야 합니다. 다음 예를 참고하세요. 세 개의 위도/경도 쌍이 있는path
매개변수를 표시합니다.path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796
입니다.placeId
: 하나 이상의 도로 구간을 나타내는 장소 ID입니다. 각 장소 ID는 다른 유형이 아닌 도로 구간을 가리키는지 확인하세요. 알 수 있습니다. 각각에 최대 100개의 장소 ID를 전달할 수 있습니다. 합니다. API는 제공된 장소 ID에 대해 도로 맞추기를 수행하지 않습니다. 응답에는 요청의 각 장소 ID에 대한 속도 제한이 포함됩니다.snapToRoads
또는nearestRoads
요청을 보낼 수 있습니다. 를 사용하여 관련 장소 ID를 찾은 다음speedLimits
요청 다음 예는 장소 ID가 두 개인placeId
매개변수:placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU
key
- 애플리케이션의 API 키입니다. 내 애플리케이션은 Roads API: 각 요청에 API 키를 포함합니다. 키를 가져오는 방법을 알아보세요.
선택적 매개변수
units
: 속도 제한을 킬로미터 또는 마일 단위로 반환할지 여부 시간KPH
또는MPH
로 설정할 수 있습니다. 기본값은KPH
입니다.
대답
speedLimits
응답에 다음 요소가 있을 수 있습니다.
speedLimits
- 도로 메타데이터의 배열입니다. 각 요소는 다음 필드를 포함해야 합니다. <ph type="x-smartling-placeholder">- </ph>
placeId
- 장소의 고유 식별자입니다. 모든 장소 ID가 반환됨 Roads API는 도로 구간에 해당합니다.speedLimit
- 해당 도로 구간의 제한 속도입니다.units
-KPH
또는MPH
를 반환합니다.
snappedPoints
- 스냅된 지점의 배열입니다. 이 배열이 있습니다. 요청에path
매개변수가 포함된 경우에만 각 포인트는 다음 필드를 포함해야 합니다. <ph type="x-smartling-placeholder">- </ph>
location
-latitude
및longitude
값을 포함합니다.originalIndex
- 해당 값을 나타내는 정수입니다. 원래 요청에 포함되지 않습니다. 요청의 각 값은 스냅된 값을 반환합니다. 이러한 값은0
에서 색인이 생성되므로originalIndex
이4
인 점은 5번째path
매개변수로 전달된 위도/경도입니다.placeId
- 장소의 고유 식별자입니다. 모든 장소 ID가 반환됨 Roads API는 도로 구간에 해당합니다.placeId
를 속도 제한 요청에 전달하여 제한 속도를 유지합니다.
warning_message
- 사용자에게 표시되는 경고가 포함된 문자열입니다.
경로를 사용하는 요청 예
이 요청은 바스코 다 가마(Vasco da Gama)를 가로지르는 경로에 지정된 위도/경도 쌍 다리가 있습니다.
요청
https://roads.googleapis.com/v1/speedLimits?path=38.75807927603043,-9.03741754643809|38.6896537,-9.1770515|41.1399289,-8.6094075&key=YOUR_API_KEY
응답
{ speedLimits: [ { placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE", speedLimit: 105, units: "KPH" }, { placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU", speedLimit: 70, units: "KPH" }, { placeId: "ChIJJ4vQRudkJA0RpednU70A-5M", speedLimit: 55, units: "KPH" } ], snappedPoints: [ { location: { latitude: 38.75807927603043, longitude: -9.037417546438084 }, originalIndex: 0, placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE" }, { location: { latitude: 38.689653701836896, longitude: -9.177051486847693 }, originalIndex: 1, placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU" }, { location: { latitude: 41.13993011767777, longitude: -8.609400794783655 }, originalIndex: 2, placeId: "ChIJJ4vQRudkJA0RpednU70A-5M" } ], warningMessage: "Input path is too sparse. You should provide a path where consecutive points are closer to each other. Refer to the 'path' parameter in Google Roads API documentation." }
위 응답에서 포인트 희소성에 대한 경고 메시지가 표시됩니다. 만약
임의의 지점에서 가장 가까운 도로 구간의 속도 제한을 요청하고 있습니다.
다음에서 가져온 장소 ID로 speedLimits
를 호출해야 합니다.
대신 nearestRoads
엔드포인트를 사용할 수 있습니다.
장소 ID를 사용하는 요청 예
위도/경도 쌍을 사용하는 대신
도로 구간 다음을 사용하여 도로 구간에 대한 장소 ID를 얻는 것이 좋습니다.
snapToRoads
또는 nearestRoads
요청 장소 ID를 전달하면 API가
는 각 장소 ID로 표시된 도로 구간의 속도 제한을 반환합니다. 이
API는 제공된 장소 ID에 도로 맞추기를 적용하지 않습니다.
다음 예에서는 일부 도로 구간의 속도 제한을 요청합니다. 다리가 있습니다.
요청
https://roads.googleapis.com/v1/speedLimits?placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU&placeId=ChIJJ4vQRudkJA0RpednU70A-5M&key=YOUR_API_KEY
응답
{ "speedLimits": [ { placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE", speedLimit: 105, units: "KPH" }, { placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU", speedLimit: 70, units: "KPH" }, { placeId: "ChIJJ4vQRudkJA0RpednU70A-5M", speedLimit: 55, units: "KPH" } ] }
사용 권장사항
속도 제한 서비스에 대한 호출량을 최소화하려면 5~15분 간격으로 자산의 위치를 샘플링하여 값은 애셋의 이동 속도에 따라 달라집니다. 저작물이 단일 위치 샘플로도 충분합니다 (모든 샘플 데이터를 다중 호출).
전체 지연 시간을 최소화하려면 모바일 애셋의 위치가 수신될 때마다 API를 호출하는 대신 일부 데이터가 누적되면 속도 제한 서비스를 호출하는 것이 좋습니다.
일부/전부 속도 제한이 누락된 이유는 무엇인가요?
speedLimits
가 누락되는 가장 일반적인 원인은 속도 제한 요청입니다.
도로 구간이 아닌 장소의 경계가 표시됩니다.
위의 예에서는 바스코 다 가마 다리를 사용하여 개념을 설명합니다.
다리가 리오 테호를 가로지르는 도로 E90을 지지합니다. 다리
자체의 장소 ID가 ChIJUzt97ZEwGQ0RM1JzQfqoDtU입니다. 첫 번째 도로 구간
는 E90 도로의 일부이며
ChIJX12duJAwGQ0Ra0d4Oi4jOGE. 예시 요청에서 도로를 교체하면
장소 ID를 브리지의 장소 ID로 교체한 경우 응답에는
speedLimits
배열에 두 개의 속도 제한이 있습니다. 다리의 장소 ID
는 개별 도로 구간을 의미하지 않습니다. 또한
장소 ID가 도로 구간용인 경우 응답에 어떤 것도 포함되지 않습니다.
속도를 제한합니다.
장소 ID를 사용하여 속도 제한을 요청할 때는 각 장소 ID가
은 도로 구간을 의미하며 다른 유형의 장소가 아닙니다. 장소 ID:
개별 도로 구간은 snapToRoads
를 사용하여 가져오는 것이 가장 좋습니다.
또는 nearestRoads
요청 중 하나는 다음 위치에서 여러 장소 ID를 반환할 수 있습니다.
수행하게 됩니다.