경로를 계산하려면 최소한 경로 출발지와 경로 목적지의 위치를 지정해야 합니다. 경로에서 이러한 위치를 경유지로 정의합니다.
출발지와 목적지 외에도 다양한 유형의 경유지와 경로의 경유지를 처리하는 방법을 지정할 수 있습니다. 자세한 내용과 예시는 다음 주제를 참조하세요.
경로의 위치 지정
경유지 (REST) 또는 경유지 (gRPC) 객체를 만들어 위치를 나타냅니다. 경유지 정의에서 다음 방법 중 하나로 위치를 지정할 수 있습니다.
동일한 방법으로 모든 경유지의 위치를 요청에 지정할 수도 있고, 위치를 혼합할 수도 있습니다. 예를 들어 출발지 경유지에는 위도/경도 좌표를 사용하고 목적지 경유지에는 장소 ID를 사용할 수 있습니다.
효율성과 정확성을 위해 위도/경도 좌표 또는 주소 문자열 대신 장소 ID를 사용하세요. 장소 ID는 고유하게 명시적이며 액세스 포인트 및 교통량 변수와 같은 경로용 지오코딩 이점을 제공합니다. 이를 통해 위치를 지정하는 다른 방법으로 인해 발생할 수 있는 다음과 같은 상황을 방지할 수 있습니다.
- 위도/경도 좌표를 사용하면 위치가 이러한 좌표에 가장 가까운 도로에 맞춰질 수 있습니다. 이는 부동산의 접근점 또는 목적지로 빠르고 안전하게 연결되는 도로가 아닐 수도 있습니다.
- 경로를 계산하려면 먼저 Routes API에서 주소 문자열을 지오코딩하여 위도/경도 좌표로 변환해야 합니다. 이 전환은 실적에 영향을 줄 수 있습니다.
장소 ID로 위치 지정
장소 ID를 사용하여 경유지의 위치를 지정할 수 있습니다. 위도 및 경도 좌표는 도로에 맞추기 때문에 장소 ID가 더 나은 결과를 제공하는 경우도 있습니다.
Geocoding API 및 Places API (Place Autocomplete 포함)에서 장소 ID를 가져옵니다. 장소 ID에 대한 자세한 내용은 장소 ID 개요를 참고하세요.
다음 예에서는 placeId 속성을 사용하여 origin 및 destination의 장소 ID를 전달합니다.
{
"origin":{
"placeId": "ChIJayOTViHY5okRRoq2kGnGg8o"
},
"destination":{
"placeId": "ChIJTYKK2G3X5okRgP7BZvPQ2FU"
},
...
}
위도와 경도 좌표로 위치를 지정하세요.
경유지의 위치를 정의하려면 위도/경도 좌표를 사용하여 위치 (REST) 또는 위치(gRPC)를 지정하세요.
예를 들어 latitude 및 longitude 좌표를 사용하여 경로 origin 및 destination에 경유지를 지정합니다.
{
"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가 내부적으로 문자열을 지오코딩하여 위도와 경도 좌표로 변환합니다.
예를 들어 경로를 계산하려면 주소 문자열을 사용하여 경로 origin 및 destination의 경유지를 지정합니다.
{
"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 St SE'의 부분 값일 수 있습니다. 이 결과는 Geocoding API에서 반환된 것과 다를 수 있습니다. 장소 ID를 사용하면 잘못된 해석을 방지할 수 있습니다.
주소의 지역 설정
불완전한 주소 문자열을 경유지 위치로 전달하면 API에서 잘못된 지오코딩된 위도/경도 좌표를 사용할 수 있습니다. 예를 들어 'Toledo'를 출발지로, 'Madrid'를 운전 경로의 목적지로 지정하여 요청합니다.
{
"origin":{
"address": "Toledo"
},
"destination":{
"address": "Madrid"
},
"travelMode": "DRIVE"
}
이 예에서 'Toledo'는 스페인이 아닌 미국 오하이오주의 도시로 해석됩니다. 따라서 요청은 빈 배열을 반환합니다. 즉, 경로가 없다는 의미입니다.
{
[]
}
regionCode 매개변수를 포함하여 특정 지역에 편중된 결과를 반환하도록 API를 구성할 수 있습니다. 이 매개변수는 지역 코드를 ccTLD ('최상위 도메인') 2자리 값으로 지정합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 특별한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk'(.co.uk)인 반면 ISO 3166-1 코드는 'gb' (기술적으로 '영국 및 북아일랜드'의 엔티티)입니다.
regionCode 매개변수를 포함하는 'Toledo'에서 'Madrid'까지의 경로 요청은 'Toledo'가 스페인의 도시로 해석되기 때문에 적절한 결과를 반환합니다.
{
"origin":{
"address": "Toledo"
},
"destination":{
"address": "Madrid"
},
"travelMode": "DRIVE",
"regionCode": "es"
}
이제 응답에는 스페인 톨레도에서 스페인 마드리드까지 계산된 경로가 포함됩니다.
{
"routes": [
{
"distanceMeters": 75330,
"duration": "4137s",
...
}
]
}
플러스 코드로 위치 지정
정확한 주소를 가지고 있지 않은 사용자가 많아 배송을 받기가 어려울 수 있습니다. 또는 주소가 있는 사람은 뒷문이나 선착장과 같은 더 구체적인 위치에서 배송을 받는 것을 선호할 수도 있습니다.
Plus Code는 실제 주소가 없는 사람 또는 장소의 상세 주소와 같습니다. Plus Code는 거리 이름과 숫자가 있는 주소 대신 위도/경도 좌표를 기반으로 하며 숫자와 문자로 표시됩니다.
Google은 모든 사용자와 모든 구성원에게 주소를 사용할 수 있는 혜택을 제공하기 위해 플러스 코드를 개발했습니다. Plus Code는 위도/경도 좌표에서 파생된 인코딩된 위치 참조로서, 1도의 8,000도 x 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를 사용하여 경로
origin및destination에 경유지를 지정하여 경로를 계산합니다.{ "origin":{ "address": "849VCWC8+R9" }, "destination":{ "address": "CRHJ+C3 Stanford, CA 94305, USA" }, "travelMode": "DRIVE" }
Plus Code는 Place Autocomplete, 장소 세부정보, Directions API, Geocoding API 등 Google Maps Platform API에서 지원됩니다. 예를 들어 Geocoding API를 사용해 위도/경도 좌표로 지정된 위치를 역 지오코딩하여 위치의 Plus Code를 결정할 수 있습니다.