경로 위치 지정

경로를 계산하려면 최소한 경로 출발지와 경로 대상의 위치를 지정해야 합니다. 이러한 위치를 경로상의 경유지로 정의합니다.

출발지와 목적지 이외에도 다양한 유형의 경유지와 경로의 경유지 처리 방법을 지정할 수 있습니다. 자세한 내용과 예는 다음 주제를 참조하세요.

경로의 위치 지정

Waypoint (REST) 또는 Waypoint (gRPC) 객체를 만들어 위치를 나타냅니다. 경유지 정의에서 다음과 같은 방법으로 위치를 지정할 수 있습니다.

동일한 방법으로 모든 경유지의 위치를 지정하거나 혼합할 수 있습니다. 예를 들어 출발지 경유지에 위도/경도 좌표를 사용하고 목적지 경유지에는 장소 ID를 사용할 수 있습니다.

효율성과 정확성을 위해 위도/경도 좌표 또는 주소 문자열 대신 장소 ID를 사용하세요. 장소 ID는 고유하게 명시적이며 액세스 포인트 및 트래픽 변수와 같은 경로 지정에 지오코딩 이점을 제공합니다. 위치를 지정하는 다른 방법으로 인해 발생할 수 있는 다음과 같은 상황을 방지하는 데 도움이 됩니다.

  • 위도/경도 좌표를 사용하면 위치가 해당 좌표에 가장 가까운 도로에 맞춰질 수 있습니다. 이 도로는 속성에 대한 접근 지점 또는 목적지로 빠르고 안전하게 연결되는 도로가 아닐 수도 있습니다.
  • 경로를 계산하려면 먼저 Routes API에서 주소 문자열을 지오코딩하여 위도/경도 좌표로 변환해야 합니다. 이 전환은 실적에 영향을 줄 수 있습니다.

위치를 장소 ID로 지정

장소 ID를 사용하여 경유지의 위치를 지정할 수 있습니다. 위도 및 경도 좌표는 도로에 맞추기 때문에 장소 ID가 더 나은 결과를 제공하는 경우도 있습니다.

Geocoding APIPlaces API (Place Autocomplete 포함)에서 장소 ID를 검색합니다. 장소 ID에 대한 자세한 내용은 장소 ID 개요를 참고하세요.

다음 예에서는 placeId 속성을 사용하여 origindestination의 장소 ID를 전달합니다.

{
  "origin":{
    "placeId": "ChIJayOTViHY5okRRoq2kGnGg8o"
  },
  "destination":{
    "placeId": "ChIJTYKK2G3X5okRgP7BZvPQ2FU"
  },
  ...
}

위도와 경도 좌표로 위치 지정

경유지의 위치를 정의하려면 위도/경도 좌표를 사용하여 위치 (REST) 또는 위치(gRPC)를 지정합니다.

예를 들어 latitudelongitude 좌표를 사용하여 경로 origindestination의 경유지를 지정합니다.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
...
}

위치를 주소 문자열로 지정

주소 문자열은 문자열로 표현되는 리터럴 주소입니다 (예: '1600 Amphitheatre Parkway, Mountain View, CA'). 지오코딩은 주소 문자열을 위도와 경도 좌표 (예: 위도 37.423021, 경도 -122.083739)로 변환하는 프로세스입니다.

주소 문자열을 경유지의 위치로 전달하면 Routes API가 내부적으로 문자열을 지오코딩하여 위도 및 경도 좌표로 변환합니다.

예를 들어 경로를 계산하려면 주소 문자열을 사용하여 경로 origindestination의 경유지를 지정합니다.

{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "450 Serra Mall, Stanford, CA 94305, USA"
  },
  ...
}

이 예에서 Routes API는 두 주소를 지오코딩하여 위도와 경도 좌표로 변환합니다.

주소 값이 모호한 경우 Routes API는 유사한 주소와 구별하기 위해 검색을 호출할 수 있습니다. 예를 들어 '1st Street'는 전체 값이거나 '1st Street NE' 또는 '1st SE'의 부분 값일 수 있습니다. 이 결과는 Geocoding API에서 반환하는 결과와 다를 수 있습니다. 장소 ID를 사용하면 발생할 수 있는 잘못된 해석을 방지할 수 있습니다.

주소의 지역 설정

불완전한 주소 문자열을 경유지의 위치로 전달하면 API에서 잘못된 지오코딩된 위도/경도 좌표를 사용할 수 있습니다. 예를 들어 'Toledo'를 출발지로, 'Madrid'를 운전 경로의 목적지로 지정하여 요청합니다.

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE"
}

이 예에서 'Toledo'는 스페인이 아닌 미국 오하이오주의 도시로 해석됩니다. 따라서 요청은 빈 배열을 반환하며, 이는 경로가 없음을 의미합니다.

{
  []
}

regionCode 매개변수를 포함하여 특정 지역에 편중된 결과를 반환하도록 API를 구성할 수 있습니다. 이 매개변수는 지역 코드를 2자리 ccTLD ('최상위 도메인') 값으로 지정합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 특별한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk'(.co.uk)인 반면 ISO 3166-1 코드는 'gb' (기술적으로 '영국 및 북아일랜드'의 엔티티)입니다.

'Toledo'에서 'Madrid'까지의 경로 요청(regionCode 매개변수가 포함된 경로 요청에서는 'Toledo'가 스페인의 도시로 해석되기 때문에 적절한 결과를 반환합니다.

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE",
  "regionCode": "es"
}

이제 응답에 스페인 톨레도에서 스페인 마드리드까지 계산된 경로가 포함됩니다.

{
  "routes": [
    {
      "distanceMeters": 75330,
      "duration": "4137s",
      ...
    }
  ]
}

플러스 코드로 위치 지정

대부분의 경우 정확한 주소가 없어서 배송을 받기 어려울 수 있습니다. 또는 주소가 있는 사용자는 뒷문이나 선착장과 같은 더 구체적인 위치에서 배달을 선호할 수도 있습니다.

Plus Code는 실제 주소가 없는 사람 또는 장소의 상세 주소와 같습니다. Plus Code는 거리 이름과 숫자가 포함된 주소 대신 위도/경도 좌표를 기반으로 하며 숫자와 문자로 표시됩니다.

Google은 모든 사람이 주소를 활용할 수 있도록 플러스 코드를 개발했습니다. 플러스 코드는 위도/경도 좌표에서 파생된 인코딩된 위치 참조로서, 1도의 8,000도 1/8,000도 (적도에서 약 14m x 14m) 이하의 영역을 나타냅니다. 상세 주소가 없거나 건물에 번호가 지정되지 않거나 거리 이름이 없는 장소의 상세 주소 대신 Plus Code를 사용할 수 있습니다.

Plus Code는 글로벌 코드 또는 복합 코드로 형식이 지정되어야 합니다.

  • 글로벌 코드는 4자리 지역번호와 6자리 이상의 지역 코드로 구성됩니다.

    예를 들어 주소가 '1600 Amphitheatre Parkway, Mountain View, CA'인 경우 전역 코드는 '849V'이고 로컬 코드는 'CWC8+R9'입니다. 그런 다음 10자리 Plus Code 전체를 사용하여 위치 값을 '849VCWC8+R9'로 지정합니다.

  • 복합 코드는 명시적인 위치와 결합된 6자(영문 기준) 이상의 지역 코드로 구성됩니다.

    예를 들어 주소 '450 Serra Mall, Stanford, CA 94305, USA'의 경우 지역 코드는 'CRHJ+C3'입니다. 복합 주소의 경우 'CRHJ+C3 Stanford, CA 94305, USA' 형식으로 지역 코드와 주소의 시/도, 우편번호 및 국가 부분을 결합합니다.

    예를 들어 Plus Code를 사용하여 경로 origindestination에 경유지를 지정하여 경로를 계산합니다.

    {
      "origin":{
        "address": "849VCWC8+R9"
      },
      "destination":{
        "address": "CRHJ+C3 Stanford, CA 94305, USA"
      },
      "travelMode": "DRIVE"
    }

Plus Code는 Place Autocomplete, Place Details, Directions API, Geocoding API 등 Google Maps Platform API에서 지원됩니다. 예를 들어 Geocoding API를 사용해 위도/경도 좌표로 지정된 위치를 역 지오코딩하여 해당 위치의 Plus Code를 결정할 수 있습니다.