Получить маршрут на более короткое расстояние, Получить маршрут на более короткое расстояние, Получить маршрут на более короткое расстояние

Этот продукт или функция являются экспериментальными (до GA). Продукты и функции Pre-GA могут иметь ограниченную поддержку, а изменения в продуктах и ​​функциях Pre-GA могут быть несовместимы с другими версиями Pre-GA. На предложения Pre-GA распространяются Особые условия обслуживания платформы Google Maps . Дополнительную информацию см. в описании этапов запуска .

API маршрутов может возвращать маршруты движения, оптимизированные для более коротких расстояний, если вы включаете маршруты на более короткие расстояния.

Когда вы запрашиваете маршрут на более короткое расстояние, сервис возвращает следующее:

• Маршрут по умолчанию, оптимизированный в первую очередь для расчетного прибытия.
• Более короткий маршрут, оптимизированный для минимизации расстояния на протяжении всей поездки.

Примечание. Маршрут на более короткое расстояние, возвращаемый API маршрутов, оптимизирован для более короткого расстояния, пройденного за поездку.

Что это такое и зачем его использовать

Маршрут на более короткое расстояние ставит расстояние выше комфорта или скорости вождения. Например, он может предпочитать местные дороги автомагистралям, выбирать грунтовые дороги или проезжать через парковки. Он не возвращает никаких маневров, которые Google Maps считает незаконными.

Запросить более короткий маршрут

Ваш запрос должен соответствовать следующим критериям:

• Установите для travelMode DRIVE , BICYCLE или TWO_WHEELER .
• Установите для параметра requestedReferenceRoutes значение SHORTER_DISTANCE .
• Установите маску поля ответа, чтобы вернуть свойства ответа, связанные с маршрутом на более короткое расстояние:
  • routes.routeLabels : Идентифицирует каждый маршрут как DEFAULT_ROUTE , SHORTER_DISTANCE или DEFAULT_ROUTE_ALTERNATE .
  • routes.routeToken : токен маршрута, который можно передать в навигационный SDK для получения пользовательского маршрута.
• Не включайте промежуточные путевые точки Via .
• Не включайте optimizeWaypointOrder .
• Необязательно : установите маску поля ответа, чтобы вернуть следующие свойства, связанные как с маршрутом по умолчанию, так и с маршрутом на более короткое расстояние:
  • routes.distanceMeters : Возвращает расстояние маршрута.
  • routes.duration : Возвращает продолжительность маршрута.

Примечание. Любой запрос, не соответствующий этим критериям, возвращает ошибку.

Справочную информацию см. в разделах ReferenceRoute и RouteLabel .

Пример запроса: Маршрут на более короткое расстояние

Следующий код показывает запрос на маршрут на более короткое расстояние. В этом примере вы используете маску поля ответа для возврата полей, связанных как с маршрутом по умолчанию, так и с маршрутом на более короткое расстояние, со следующими масками полей:

• 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
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "requestedReferenceRoutes": ["SHORTER_DISTANCE"],
}' \
-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'

Пример ответа на более короткий маршрут

{
  "routes": [
    {
      "distanceMeters": 138943,
      "duration": "5373s",
      "routeToken": "CrsCCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXcklWWFo2cjhDZmltdk9NUDQ3aU1nUU0QBRpPCk0KGAoNCgIIAREAAAAAAIBmQBF56SYxqDm4QBISCAAQAxAGEBMQEhgCQgQaAggFIhsKF3JJVlhaLWFOQnZpbXZPTVA0N2lNZ1FNcAEoASIVAACBmRY1BjeCiUQewJGTrQ3DuHRp",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 112610,
      "duration": "7165s",
      "routeToken": "CqgCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdySVZYWjZHR0RiTzV2T01QOUpiQXlBTRAFGk8KTQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhIIABADEAYQExASGAJCBBoCCAUiGwoXcklWWFo3S09Cck81dk9NUDlKYkF5QU1wASgCIhUAAIGZFlj_CmMgGE6KGZcsE-tEywM",
      "routeLabels": [
        "SHORTER_DISTANCE"
      ]
    }
  ]
}

Пример запроса: Более короткое расстояние и экономичный маршрут.

Следующий код показывает запрос как на более короткий маршрут, так и на экономичный маршрут.

`

 curl -X POST -d '{
"origin": {  "location": {  "latLng": {  "latitude": 41.76904801292959,
"longitude": -72.67374935684933  }  }  },  "destination": {  "location": {
"latLng": {  "latitude": 41.823042361105024,  "longitude": -71.40933143059424  }
 }  },  "travelMode":"DRIVE",  "routingPreference":"TRAFFIC_AWARE_OPTIMAL",
"requestedReferenceRoutes": ["SHORTER_DISTANCE", "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'

Пример ответа: более короткое расстояние и экономичный маршрут.

В этом случае более короткое расстояние и маршрут с наиболее экономичным расходом топлива совпадают, поэтому возвращается маршрут и для обоих типов маршрутов включается routeLabel .

{  "routes": [  {  "distanceMeters": 138943,  "duration": "5375s",
"routeToken":
"Cr8CCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXS1laWFo4T19JcWVCM2ZFUDFMbms4UXcQBRpTClEKGAoNCgIIAREAAAAAAIBmQBFOYhBYGTy4QBIWCAAQAxAGEBMQEhgCQgQaAggFSgIIASIbChdLWVpYWjlpV0g2ZUIzZkVQMUxuazhRd3ABKAEiFQAAgZkW4Df4cspNNJZWlMZuUUxLPQ",
 "routeLabels": [  "DEFAULT_ROUTE"  ]  },  {  "distanceMeters": 112610,
"duration": "7156s",  "routeToken":
"CqwCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdLWVpYWi1UNklfT055OVlQczhhcWlRSRAFGlMKUQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhYIABADEAYQExASGAJCBBoCCAVKAggBIhsKF0tZWlhaNERXSF9PTnk5WVBzOGFxaVFJcAEoAiIVAACBmRaESp2EJS5nmwiEF8KH15_f",
 "routeLabels": [  "FUEL_EFFICIENT",  "SHORTER_DISTANCE"  ]  }  ] }

Поддерживаемые регионы

Маршруты на более короткие расстояния поддерживаются во всех регионах.

Биллинг

Платформа Google Maps не взимает дополнительную плату за использование экспериментальной функции. С вас будет взиматься плата в зависимости от использования вами API на основе других установленных вами параметров.

Узнайте больше о выставлении счетов за API маршрутов.