스무딩 및 충실도
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 모드의 경우 최대 3,600초, 기타 모드의 경우 최대 7,200초입니다.NOT_FOUND (404): 출발지 포인트가 도로에 스냅되지 않았습니다. 좌표를 알려진 거리로 더 가까이 이동하거나 지역이 지원되는지 확인하세요.