기본적으로 Routes API는 경로를 의미하는 기본 경로를 반환합니다. 비용을 절감할 수 있습니다 친환경적이면서도 라우팅을 사용하는 경우에도 응답에 기본 경로가 표시됩니다. 또한 연비 또는 에너지 효율이 가장 우수한 경로가 표시된 친환경 경로 찾기 자동차의 엔진 유형에 따라 다릅니다.
Routes API에서 반환하는 친환경 경로는 전체 경로에서 연료 소비를 줄입니다. API는 차량의 엔진을 사용합니다. 실시간 교통 및 도로 상황과 같은 기타 요인과 친환경 경로를 선택합니다 연비 또는 에너지 효율이 높은 경로일수록 자동차의 연료/에너지 사용량 및 이산화탄소 배출량을 줄이세요
예를 들어 디젤 차량의 상대적 연비 우위는 일반적으로 최고의 성능을 발휘합니다. 하이브리드 및 전기자동차는 가다 서다 반복하는 도심 주행과 언덕 운전의 효율성이 갈수록 향상됨 생성형 AI 애플리케이션을 광범위하게 사용하고 이를 통해 혜택을 받을 수 있는 브레이크.
API가 다음의 예상 연료 소비량을 반환하도록 요청할 수도 있습니다. 확인할 수 있습니다. 예상 연료 소비량을 비교해 보세요. 정확한 차량에 대한 명시적인 연료 사용량 추정치가 아닙니다.
Google 지도에서 연비를 추정하는 방법
Routes API는 미국의 통계를 사용해 연비를 추정합니다. 미국 에너지부 미국 국립 재생에너지 연구소 유럽 환경청의 데이터를 확인할 수 있습니다 이 계산에는 연료 및 에너지 사용량과 CO2 배출량에 영향을 미치는 요인은 다음과 같습니다.
- 내가 있는 지역의 평균 차량 연료 또는 에너지 소비량
- 경로에 있는 언덕의 가파른 정도
- 가다 서기를 반복하는 교통상황 패턴
- 도로 유형(예: 지역 도로 또는 고속도로)
Routes API는 다음과 같은 경우 연비 또는 에너지 효율이 가장 높은 경로를 반환합니다. 기본 경로와 거의 동일한 도착 시간 연료 또는 가스 배출이 에너지 절약량이 너무 적거나 운전 시간이 크게 늘어나기 때문에 경로 간의 상대적 연료 또는 에너지 절감을 표시하여 쉽게 비교해 볼 수 있습니다.
친환경 경로 탐색 기술에 대해 자세히 알아보기(PDF)
기본 요건
친환경 경로를 사용하거나 연료 소비량을 추정하는 방법은 다음과 같습니다.
TRAFFIC_AWARE_OPTIMAL을 경로 환경설정으로 지정해야 합니다. 이 도로망을 보다 철저하게 검색하여 최적의 경로를 찾습니다. 자세한 내용은 품질 및 지연 시간 구성.travelMode를DRIVE로 설정해야 합니다. 다음에 대한 요청 다른 이동수단은 오류를 반환합니다.출발지의 목적지는 지원되는 리전에 있어야 합니다. 그렇지 않으면 API에서 오류를 반환합니다.
경로에는 중간 경유지가 포함될 수 없습니다.
결제
일반적으로 Google Maps Platform에서는 미리보기 사용에 대해 요금을 청구하지 않습니다.
기능을 사용할 수 있습니다. 하지만 친환경 경로 탐색과 예상 연료 소비량 예측은
TRAFFIC_AWARE_OPTIMAL를 라우팅 환경설정으로 지정해야 합니다.
SKU: 경로
고급.
Routes API의 결제 자세히 알아보기
친환경 경로 요청
친환경 경로 계산 요청을 하려면 다음 속성을 설정하세요. 포함:
다음에 정의된 값을 사용하여 차량에
emissionType를 지정합니다. VehicleEmissionType:DIESEL,GASOLINE,ELECTRIC또는HYBRID입니다. 기본값은GASOLINErequestedReferenceRoutes를FUEL_EFFICIENT로 설정합니다.응답 속성을 반환하도록 지정하는 응답 필드 마스크 설정 친환경 경로:
routes.routeLabels:각 경로를DEFAULT_ROUTE로 식별합니다.FUEL_EFFICIENT또는DEFAULT_ROUTE_ALTERNATE입니다.routes.routeToken:: Navigation SDK를 사용하여 커스텀 경로를 만듭니다.
친환경 요청의 예
다음 코드는 친환경 경로 요청을 보여줍니다. 이 예에서
응답 필드 마스크를 사용하여
routes.distanceMeters 및 일광 절약 도로
속성 routes.duration개:
curl -X POST -H 'content-type: application/json' -d '{ "origin": { "location": { "latLng": { "latitude": 41.76904801292959, "longitude": -72.67374935684933 } } }, "destination": { "location": { "latLng": { "latitude": 41.823042361105024, "longitude": -71.40933143059424 } } }, "routeModifiers": { "vehicleInfo": { "emissionType": "GASOLINE" } }, "travelMode":"DRIVE", "routingPreference": "TRAFFIC_AWARE_OPTIMAL", "requestedReferenceRoutes": ["FUEL_EFFICIENT"] }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
친환경 대답의 예
위의 computeRoutes 호출은
기본 경로와 연비 최적 경로입니다. 응답에서 각 항목의 의미는 다음과 같습니다.
기본 경로의 경우
routeLabels배열 속성에DEFAULT_ROUTE입니다.친환경 경로의 경우
routeLabels배열 속성에 다음이 포함됩니다.FUEL_EFFICIENT입니다.요청에서
computeAlternativeRoutes를true로 설정하여 계산하는 경우 대체 경로,routeLabels배열 속성DEFAULT_ROUTE_ALTERNATE포함
{ "routes": [ { "distanceMeters": 138939, "duration": "5412s", "routeToken": "CoYJCpoIC…0n9S1cu", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 116887, "duration": "5631s", "routeToken": "CuEHCu0G…xqm", "routeLabels": [ "FUEL_EFFICIENT" ] } ] }
현재 운전 상황 및 기타 요인으로 인해 기본 경로와
친환경 경로도 동일할 수 있습니다. 이 경우 routeLabels에는
두 라벨 모두 DEFAULT_ROUTE 및 FUEL_EFFICIENT:
{ "routes": [ { "distanceMeters": 45875, "duration": "2655s", "routeToken": "CvcDCos…6I40", "routeLabels": [ "DEFAULT_ROUTE", "FUEL_EFFICIENT" ] } ] }
경로의 연료 사용량 추정
전체의 예상 연료 사용량을 반환하도록 메서드를 요청할 수 있습니다. 마이크로리터 단위입니다. 경로의 예상 연료 사용량을 응답:
extraComputations배열 필드를FUEL_CONSUMPTION로 설정하여 다음을 사용 설정합니다. 연료 사용 계산.다음에 정의된 값을 사용하여 차량에
emissionType를 지정합니다. VehicleEmissionType:DIESEL,GASOLINE,ELECTRIC또는HYBRID입니다. 기본값은GASOLINEemissionType가HYBRID이면 API는 전기와 연료를 변환합니다. 100억 달러 정도를 소비하고 있습니다emissionType가ELECTRIC이면 API는 전기를 변환합니다. 100억 달러 정도를 소비하고 있습니다응답 속성을 반환하도록 지정하는 응답 필드 마스크 설정 연료 사용과 관련됨:
routes.travelAdvisory.fuelConsumptionMicroliters
다음 예는 친환경 경로도 포함합니다.
curl -X POST -H 'content-type: application/json' -d '{ "origin": { "location": { "latLng": { "latitude": 41.76904801292959, "longitude": -72.67374935684933 } } }, "destination": { "location": { "latLng": { "latitude": 41.823042361105024, "longitude": -71.40933143059424 } } }, "routeModifiers": { "vehicleInfo": { "emissionType": "GASOLINE" } }, "travelMode":"DRIVE", "routingPreference": "TRAFFIC_AWARE_OPTIMAL", "extraComputations": ["FUEL_CONSUMPTION"], "requestedReferenceRoutes": ["FUEL_EFFICIENT"] }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken,routes.travelAdvisory.fuelConsumptionMicroliters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
응답에는 기본 경로 모두의 예상 연료 소비량이 포함됩니다. 친환경 경로:
{ "routes": [ { "distanceMeters": 138939, "duration": "5412s", "travelAdvisory": { "fuelConsumptionMicroliters": "11019554" }, "routeToken": "CoYJCpoIC…0n9S1cu", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 116887, "duration": "5631s", "travelAdvisory": { "fuelConsumptionMicroliters": "9572436" }, "routeToken": "CuEHCu0G…xqm", "routeLabels": [ "FUEL_EFFICIENT" ] } ] }
지원되는 리전
Google Maps Platform팀은 전 세계 사용자에게 더 나은 서비스를 제공하기 위해 끊임없이 노력하고 있습니다. 지원 범위를 확대하고 있습니다 다음 목록은 최신 커버리지를 보여줍니다. 자세한 내용을 살펴볼 수 있습니다.
- 알바니아(AL)
- 오스트리아(AT)
- 벨기에(BE)
- 보스니아·헤르체고비나(BA)
- 불가리아(BG)
- 캐나다(CA)
- 크로아티아(HR)
- 키프로스(CY)
- 체코(CZ)
- 덴마크(DK)
- 에스토니아(EE)
- 핀란드(FI)
- 프랑스(FR)
- 독일(DE)
- 그리스(GR)
- 헝가리(HU)
- 아이슬란드(IS)
- 아일랜드(IE)
- 이탈리아(IT)
- 코소보(XK)
- 라트비아(LV)
- 리히텐슈타인(LI)
- 리투아니아(LT)
- 룩셈부르크(LU)
- 몰타(MT)
- 몬테네그로(ME)
- 네덜란드(NL)
- 북마케도니아(MK)
- 노르웨이(NO)
- 폴란드(PL)
- 포르투갈(PT)
- 루마니아(RO)
- 세르비아(RS)
- 슬로바키아(SK)
- 슬로베니아(SI)
- 스페인(ES)
- 스웨덴(SE)
- 스위스(CH)
- 튀르키예(TR)
- 영국(GB)
- 미국(US)