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