트래픽 평활화 및 충실도
polygon_fidelity 및 enable_smoothing 매개변수를 사용하여 출력 다각형의 모양과 정밀도를 맞춤설정할 수 있습니다. 이러한 옵션은 서로 독립적이지만 함께 작동하여 최종 모양을 결정합니다.
polygon_fidelity: 해상도 도달 가능한 영역을 계산하는 데 사용되는 기본 그리드 셀 (S2 셀)의 크기를 제어합니다.LOW: 더 큰 그리드 셀을 사용합니다. 간격 없이 넓은 영역을 포괄하는 데 가장 적합하며 일반화된 모양을 만듭니다.MEDIUM: 균형 잡힌 정밀도HIGH: 더 작은 그리드 셀을 사용합니다. 도로망에 더 잘 맞지만 도로망이 희소한 빈 영역 또는 '구멍'이 생길 수 있습니다.- 기본값: 지정하지 않으면 서비스에서 요청된 이동 시간에 따라 충실도를 동적으로 선택합니다.
enable_smoothing: 미적 감각 충실도로 정의된 그리드 셀의 날카로운 모서리를 둥글게 처리할지 여부를 제어합니다.false(원시): 정확한 기하학적 계산을 반환합니다. 모서리가 들쭉날쭉하거나 계단식으로 표시되어 그리드 셀을 반영합니다. 엄격한 점-다각형 테스트와 같은 분석 정확도에 가장 적합합니다.true(트래픽 평활화): 후처리 알고리즘을 적용하여 모서리를 둥글게 처리합니다. 지도에 시각적으로 표시하는 데 가장 적합합니다.
상호작용 방식: 충실도는 트래픽 평활화 알고리즘이 작동하는 기준 세부정보를 설정합니다.
- 높은 충실도 + 트래픽 평활화: 도로 끝을 밀접하게 따르는 세부적이고 유기적인 모양을 생성합니다.
- 낮은 충실도 + 트래픽 평활화: 넓고 일반화된 '블롭' 모양을 생성합니다.
페이로드 크기 및 렌더링
큰 등시선은 수천 개의 좌표를 포함할 수 있으며 페이로드는 300~500KB일 수 있습니다.
- 대역폭: 최대 기간 요청의 경우 JSON 응답 크기가 중요합니다.
- 렌더링: 매우 세부적인 다각형을 렌더링하면 성능에 영향을 미칩니다.
enable_smoothing매개변수 또는 클라이언트 측 단순화 라이브러리를 사용하여 표시할 꼭짓점 수를 줄이는 것이 좋습니다.
오류 처리
5xx 서버 오류에 지수 백오프를 사용하여 재시도 로직을 구현합니다.
그러나 매개변수를 변경하지 않고 4xx 클라이언트 오류를 다시 시도하지 마세요.
INVALID_ARGUMENT (400): 기간이 양수이고 선택한 모드의 한도( ) 내에 있는지 확인합니다. DRIVE( ) 및 TWO_WHEELER의 경우 최대 3,600초, 기타 모드의 경우 7,200초입니다.NOT_FOUND (404): 원점이 도로에 스냅되지 않았습니다. 좌표를 알려진 거리로 더 가깝게 이동하거나 리전이 지원되는지 확인해 보세요.