등시선을 생성하려면 API에 출발지, 이동 수단(예: 운전, 자전거, 도보), 시간 제한을 제공합니다. 경로 환경설정 및 결과 폴리곤의 시각적 모양을 조정할 수도 있습니다.
시간 범위
서비스에 제공하는 기본 제약조건은 travel_duration입니다. 이는 계산의 시간 범위를 정의합니다.
- 최대 시간: API는
DRIVE모드의 경우 최대 이동 시간 3,600초(1시간),WALK및BICYCLE모드의 경우 7,200초 (2시간)를 지원합니다. - 성능: 계산 시간은 요청된 시간과 선택한 이동 수단에 따라 조정됩니다. 1시간 운전 등시선은 1시간 도보 등시선보다 훨씬 넓은 지리적 영역과 도로망을 포함하므로 운전 요청의 지연 시간이 더 깁니다.
- 형식 지정: API는
google.protobuf.Duration을 사용하므로 시간은 정수가 아닌 's'로 끝나는 문자열(예:"3600s")로 형식을 지정해야 합니다.
출발지점 및 도로 스냅
다음 두 가지 방법으로 등시선의 시작점을 지정할 수 있습니다.
- 좌표: 위도 및 경도 쌍 (
location). - 장소 ID: Google 지도에 있는 특정 장소의 고유 식별자(
place). 장소 ID를 제공하면 서비스는 해당 장소의 중심점을 출발지점으로 사용합니다. API는places/ChIJ...와 같은 리소스 이름 형식을 예상합니다. 장소 ID에 대한 자세한 내용은 장소 ID를 참고하세요.
입력 방법과 관계없이 API는 지점이 도로에 있지 않은 경우(예: 공원 또는 건물 내부) 정확한 물리적 지점에서 이동 시간을 계산하지 않습니다. 이러한 상황을 처리하기 위해 서비스는 도로 스냅을 사용합니다. 도로 스냅에는 다음과 같은 기능이 있습니다.
- 스마트 스냅: 서비스는 출발지점을 가장 가까운 통과 가능한 도로 구간에 스냅하려고 시도합니다.
- 모드 인식: 스냅 로직은
travel_mode를 고려합니다.DRIVE를 요청하면 API는 보행자 전용 경로를 무시하고 가장 가까운 운전 가능한 도로를 찾습니다.WALK를 요청하면 API는 도보 경로와 인도의 우선순위를 지정합니다. - 실패 사례: API가 출발지점에서
약 100미터 이내에 적합한 도로 구간을 찾을 수 없는 경우 API는
404 NOT_FOUND오류를 반환합니다. 이는 일반적으로 지점이 도로망에서 너무 멀리 떨어져 있거나 지도 데이터가 요청된 이동 수단을 지원하지 않는 지역에 있음을 나타냅니다.
이동 방향 (인바운드 대 아웃바운드)
travelDirection 매개변수를 사용하여 인바운드 및 아웃바운드 도달 가능성을 모두 계산할 수 있습니다.
FROM(아웃바운드): 지정된 시간 제한 내에 출발지점에서 도달할 수 있는 영역을 계산합니다. 배송 지역 또는 서비스 범위와 같은 사용 사례에 적합합니다.TO(인바운드): 지정된 시간 제한 내에 출발지점으로 이동할 수 있는 영역을 계산합니다. 직원이 중앙 사무실에 통근할 수 있는 위치와 같은 집수 지역을 결정하는 데 적합합니다.
교통 인식
routing_preference 매개변수를 사용하여 교통 데이터가 생성된 폴리곤에 미치는 영향을 제어합니다.
TRAFFIC_UNAWARE(기본값): 속도 제한 및 도로 계층 구조를 사용하여 등시선 다각형을 생성합니다. 이렇게 하면 시간대에 따라 변동하지 않는 결정론적 도형이 생성됩니다. 이 매개변수는 일반 분석 또는 기준 시나리오 계획에 적합합니다.TRAFFIC_AWARE: 요청 시 실시간 또는 예측 교통 상황을 사용하여 등시선을 계산하므로 정체 시 도달 가능한 영역이 축소되고 비첨두 시간대에 확장됩니다. 참고: 교통 인식 경로 지정은travelMode가DRIVE로 설정된 경우에만 지원됩니다.
스무딩 및 충실도
polygon_fidelity 및 enable_smoothing 매개변수를 사용하여 출력 폴리곤의 모양과 정밀도를 맞춤설정할 수 있습니다. 이러한 옵션은 독립적이지만 함께 작동하여 최종 도형을 결정합니다.
polygon_fidelity: 도달 가능한 영역을 계산하는 데 사용되는 기본 그리드 셀의 크기를 제어합니다.LOW: 더 큰 그리드 셀을 사용합니다. 간격 없이 넓은 영역을 포함하는 데 가장 적합하며 일반화된 도형이 생성됩니다.MEDIUM: 균형 잡힌 정밀도입니다.HIGH: 더 작은 그리드 셀을 사용합니다. 도로망에 더 잘 맞지만 도로망이 희소한 경우 빈 영역이나 구멍이 생길 수 있습니다.POLYGON_FIDELITY_UNSPECIFIED: 지정하지 않으면 서비스는 요청된 이동 시간에 따라 충실도를 동적으로 선택합니다.
높음, 중간, 낮음 폴리곤 충실도
enable_smoothing: 충실도로 정의된 그리드 셀의 날카로운 모서리를 둥글게 처리할지 여부를 제어합니다.false(원시): 기본값입니다. 정확한 기하학적 계산을 반환합니다. 모서리가 들쭉날쭉하거나 계단식으로 표시됩니다. 엄격한 점-폴리곤 테스트와 같은 분석 정확도에 가장 적합합니다. 스무딩된 것보다 지연 시간이 짧습니다.true(스무딩됨): 후처리 알고리즘을 적용하여 모서리를 둥글게 처리합니다. 지도에 시각적으로 표시하는 데 가장 적합합니다.
스무딩이 적용된 등시선과 스무딩이 적용되지 않은 등시선