모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Maps Roads API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Maps Roads API 활성화
  3. 적합한 키 생성
계속

오류 문제 해결

오류의 경우, 표준 형식의 오류 응답 본문이 반환되고 HTTP 상태 코드가 오류 상태로 설정됩니다.

응답에는 단일 error 객체가 있는 객체가 다음 키와 함께 포함됩니다.

  • code: 응답의 HTTP 상태와 동일합니다.
  • message: 오류에 대한 짧은 설명.
  • status: 오류의 특징을 나타내는 상태 코드.

예를 들어, 잘못된 placeId 매개변수를 전송하면 다음과 같은 오류가 반환됩니다.

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

가능한 오류는 다음과 같습니다.

이 아니라 https://roads.googleapis.com/을 사용해야 합니다.
코드 상태 메시지 문제 해결
400 INVALID_ARGUMENT 제공한 키가 잘못되었습니다. API 키가 올바르지 않거나 요청에 포함되지 않았습니다. 전체 키가 포함되었는지 확인하고, 이 키에 대해 API를 활성화했는지 확인하세요.
400 INVALID_ARGUMENT "\"path\" 매개변수에 잘못된 값이 포함되었습니다: ☃" 요청에 잘못된 인수가 포함되었습니다. 이 오류의 가장 가능한 원인은 다음과 같습니다.
  • path 매개변수에 문제가 있습니다.
    최소 한 개 이상의 지점과, 100 개 미만의 지점이 있는지 확인하세요. 각 지점은 쉼표로 구분된 숫자 쌍이어야 합니다. 예: 48.409114,-123.369158. 지점은 파이프 기호 '|'로 구분되어야 합니다.
  • 요청에 잘못된 placeId가 포함되었습니다.
  • 요청에 placeIdpath가 모두 포함되었습니다. 이들 매개변수 중 하나만 각 요청에 지정될 수 있습니다.

더 이상 존재하지 않는 도로나, 도로가 아닌 장소에 대해 placeId가 전달된 경우에는 이 오류가 반환되지 않습니다.

403 PERMISSION_DENIED 등록되지 않은 요청이 차단되었습니다. Google Developers Console을 사용하여 등록하세요. API 키가 올바르지 않거나 요청에 포함되지 않았습니다. 전체 키가 포함되었는지 확인하고, 이 키에 대해 API를 활성화했는지 확인하세요.
404 NOT_FOUND 이 서비스에는 HTTPS가 필요합니다. 요청을 보낼 때 http://roads.googleapis.com/.
429 RESOURCE_EXHAUSTED 프로젝트 QPS 제한에 도달했기 때문에 요청이 차단되었습니다. API Console에서 구성했던 requests사용자당 초당 요청 제한을 초과했습니다. 단일 사용자 또는 소규모 사용자 그룹이 귀하의 일일 할당량을 소진하지 못하게 하는 동시에, 모든 사용자에게 적절한 액세스를 허용하려면 이 제한을 구성해야 합니다.
429 RESOURCE_EXHAUSTED 프로젝트 QPS 제한에 도달했기 때문에 요청이 차단되었습니다. 프로젝트의 일일 할당량을 초과했습니다.

지수 백오프

요청이 실패하면, 지수 백오프를 사용하여 재시도 요청을 수행해야 합니다. 예를 들어, 요청이 한번 실패하면, 1분 후에 재시도하고, 다시 실패하면 2분 후에 재시도하고, 그 다음은 4분 후에 재시도하는 식으로 재시도를 수행합니다. 이렇게 하면, 많은 클라이언트가 매우 빠르게 요청을 재시도할 때, 잘못된 요청이나 대규모 실패로 인해 Google 서버가 느려지는 것을 막을 수 있습니다.

다음에 대한 의견 보내기...

Google Maps Roads API
Google Maps Roads API
도움이 필요하시나요? 지원 페이지를 방문하세요.