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