스무딩 및 충실도
polygon_fidelity 및 enable_smoothing 매개변수를 사용하여 출력 다각형의 모양과 정밀도를 맞춤설정할 수 있습니다. 이러한 옵션은 독립적이지만 함께 작동하여 최종 모양을 결정합니다.
polygonFidelity(polygon_fidelity): 해상도입니다. 도달 가능한 영역을 계산하는 데 사용되는 기본 공간 그리드 셀의 크기를 제어합니다.LOW: 가장 큰 그리드 셀 (수백 미터 너비)을 사용합니다. 간격 없이 넓은 영역을 커버하고 꼭짓점 수를 최소화하는 데 가장 적합하며, 이로 인해 좁은 도로를 따라 도달 가능한 영역을 과대평가할 수 있는 일반화된 형태가 생성됩니다.MEDIUM: 정밀도와 페이로드 크기의 균형을 맞춥니다.HIGH: 가장 작은 그리드 셀 (가로 약 100~150미터)을 사용합니다. 도로망에 더 잘 맞고 꼭짓점이 더 많지만 도로망이 희소한 내부 구멍이 생길 수 있습니다.- 기본값 (
POLYGON_FIDELITY_UNSPECIFIED): 지정하지 않으면 서비스에서 이동 수단과 소요 시간에 따라 해상도를 자동으로 선택합니다. 소요 시간이 짧은 경우와WALK의 경우 더 세밀한 셀을 사용하고 소요 시간이 긴 경우 더 성긴 셀을 사용합니다. 여러 기간 또는 이동 모드에서 등시선을 비교하려면 동일한 해상도를 사용하도록polygonFidelity를 명시적으로 설정하세요.
셀 크기는 근사치입니다. 매우 큰 등시선은 응답 크기를 관리 가능한 수준으로 유지하기 위해 더 일반화될 수 있습니다.
enableSmoothing(enable_smoothing): 미학. 충실도로 정의된 그리드 셀의 계단식 가장자리를 반올림할지 여부를 제어합니다.false(원시): 그리드 정렬 경계를 반환합니다. 가장자리가 격자 셀을 반영하여 들쭉날쭉하거나 계단식으로 표시됩니다. 엄격한 다각형 내 점 테스트와 같은 분석 정확성에 가장 적합합니다.true(부드럽게): 각 고리의 면적을 대략적으로 유지하면서 모서리를 둥글게 처리합니다. 지도에 시각적으로 표시하는 데 가장 적합합니다. 경계가 더 이상 그리드 셀을 따르지 않으므로 엄격한 다각형 내 점 테스트에는 사용하지 마세요.
상호작용 방식: 충실도는 평활화 알고리즘이 작동하는 기준 세부정보를 설정합니다.
- 고품질 + 평활화: 도로 끝을 밀접하게 따르는 상세하고 유기적인 모양을 생성합니다.
- 낮은 충실도 + 평활화: 넓고 일반화된 '블롭' 모양을 생성합니다.
페이로드 크기 및 렌더링
큰 등시선 (특히 HIGH 충실도의 장기 요청)에는 수만 개의 좌표가 포함될 수 있으며 압축되지 않은 JSON 응답은 수백 킬로바이트 이상일 수 있습니다.
- 대역폭: JSON 응답 크기는 높은 충실도의 최대 기간 요청에 중요합니다.
- 렌더링: 매우 세부적인 다각형을 렌더링하면 클라이언트 성능에 영향을 미칩니다. 꼭짓점 수와 페이로드 크기를 줄이려면
polygonFidelity: MEDIUM또는LOW를 선택하거나, 렌더링 전에 클라이언트에서 Douglas-Peucker와 같은 선 단순화 알고리즘을 사용하여 도형을 단순화하세요.
지연 시간 및 클라이언트 제한 시간
응답 지연 시간은 이동하는 도로망의 크기에 따라 증가합니다. 짧은 시간과 WALK 및 BICYCLE 모드가 가장 빠르며, 긴 DRIVE 및 TWO_WHEELER 요청 (특히 TRAFFIC_AWARE 사용)이 가장 오래 걸립니다.
- 권장 클라이언트 제한 시간: 짧은 클라이언트 제한 시간으로 인해 긴 요청이 조기에 중단되지 않도록 HTTP 또는 gRPC 클라이언트 기한을 30초 이상으로 구성합니다.
오류 처리
429
RESOURCE_EXHAUSTED 비율 제한 응답 및 5xx 서버 오류에 대해 지수 백오프 및 지터를 사용하여 재시도 로직을 구현합니다. 요청을 변경하지 않고 400, 403 또는 404 클라이언트 오류를 다시 시도하지 마세요.
INVALID_ARGUMENT (400):travelDuration가1s와3600s(DRIVE/TWO_WHEELER) 또는7200s(WALK/BICYCLE) 사이에 있는지,location가 생략되지 않고(0, 0)가 아닌지 (또는place가 유효한 장소 ID인지),TRAFFIC_AWARE가DRIVE또는TWO_WHEELER에만 사용되는지 확인합니다.latitude또는longitude를 생략하면0.0로 처리되므로 둘 중 하나만 생략하면 일반적으로400오류가 발생하지 않습니다 (다른 값도0.0인 경우 제외). 등시선이 잘못된 위치에 표시되면 두 값을 모두 다시 확인하세요.PERMISSION_DENIED (403): API 키 또는 OAuth 토큰이 포함되어 있고 Google Cloud 프로젝트에서 Isochrones API 및 결제가 사용 설정되어 있는지 확인합니다.NOT_FOUND (404):place를 위치로 확인할 수 없거나 출발지를 이동 수단에서 사용할 수 있는 인근 도로(약 200m 이내,WALK및BICYCLE의 경우 더 짧음)에 맞출 수 없습니다.RESOURCE_EXHAUSTED (429): 프로젝트가 분당 요청 할당량 (기본값 300QPM)을 초과했습니다. 지수 백오프로 다시 시도합니다.