경로를 계산하려면 최소한 경로 출발지와 경로 대상의 위치를 지정해야 합니다. 이러한 위치는 경로상의 경유지로 정의됩니다.
출발지와 목적지 외에도 다양한 유형의 경유지 및 경로의 경유지 처리 방법을 지정할 수 있습니다. 자세한 내용과 예는 다음 주제를 참조하세요.
경로의 위치 지정
Waypoint (REST) 또는 Waypoint (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에서 잘못 지오코딩된 위도/경도 좌표를 사용할 수 있습니다. 예를 들어 '톨레도'를 출발지로, '마드리드'를 운전 경로의 목적지로 지정하여 요청할 수 있습니다.
{
"origin":{
"address": "Toledo"
},
"destination":{
"address": "Madrid"
},
"travelMode": "DRIVE"
}
이 예에서 '톨레도'는 스페인이 아닌 미국 오하이오주의 도시로 해석됩니다. 따라서 요청은 빈 배열을 반환합니다. 즉, 경로가 존재하지 않습니다.
{
[]
}
regionCode 매개변수를 포함하여 특정 지역에 편중된 결과를 반환하도록 API를 구성할 수 있습니다. 이 매개변수는 지역 코드를 ccTLD ('최상위 도메인') 2자리 값으로 지정합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 눈에 띄는 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk'(.co.uk)이지만 ISO 3166-1 코드는 'gb' (기술적으로 '영국 및 북아일랜드' 엔티티)입니다.
regionCode 매개변수를 포함하는 '톨레도'에서 '마드리드'까지의 경로 요청은
'톨레도'가 스페인의 도시로 해석되므로
적절한 결과를 반환합니다.
{
"origin":{
"address": "Toledo"
},
"destination":{
"address": "Madrid"
},
"travelMode": "DRIVE",
"regionCode": "es"
}
이제 응답에 스페인 톨레도에서 스페인 마드리드까지 계산된 경로가 포함됩니다.
{
"routes": [
{
"distanceMeters": 75330,
"duration": "4137s",
...
}
]
}
위치를 Plus Code로 지정
정확한 주소가 없는 경우가 많아 배송을 받기가 어려울 수 있습니다. 또는 주소가 있는 사용자는 뒷문이나 적재 시설과 같이 더 구체적인 위치에서 배송을 받는 것을 선호할 수 있습니다.
플러스 코드는 실제 주소가 없는 사람 또는 장소의 상세 주소와 같습니다. 플러스 코드는 거리 이름과 숫자가 있는 주소 대신 위도/경도 좌표를 기반으로 하며 숫자와 문자로 표시됩니다.
Google에서는 모든 사용자와 모든 사람이 주소의 혜택을 누릴 수 있도록 플러스 코드를 개발했습니다. 플러스 코드는 위도/경도 좌표에서 파생된 인코딩된 위치 참조로, 도의 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를 파악할 수 있습니다.