Routes Preferred API
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Сервис: routerpreferred.googleapis.com.
Для вызова этой службы мы рекомендуем использовать клиентские библиотеки Google. Если вашему приложению необходимо использовать собственные библиотеки для вызова этой службы, используйте следующую информацию при отправке запросов API.
Документ открытия
Документ обнаружения — это машиночитаемая спецификация для описания и использования REST API. Он используется для создания клиентских библиотек, плагинов IDE и других инструментов, взаимодействующих с API Google. Одна служба может предоставлять несколько документов обнаружения. Эта служба предоставляет следующие документы обнаружения:
Конечная точка службы
Конечная точка службы — это базовый URL-адрес, указывающий сетевой адрес службы API. Одна служба может иметь несколько конечных точек службы. Эта служба имеет следующую конечную точку службы, и все приведенные ниже URI относятся к этой конечной точке службы:
-
https://routespreferred.googleapis.com
| Методы |
|---|
computeCustomRoutes | POST /v1alpha:computeCustomRoutes
Учитывая набор конечных и промежуточных путевых точек, а также цель маршрута, вычисляет лучший маршрут для цели маршрута. |
computeRouteMatrix | POST /v1alpha:computeRouteMatrix
Принимает список пунктов отправления и назначения и возвращает поток, содержащий информацию о маршруте для каждой комбинации пункта отправления и назначения. |
computeRoutes | POST /v1alpha:computeRoutes
Возвращает основной маршрут вместе с дополнительными альтернативными маршрутами, учитывая набор конечных и промежуточных точек. |
Ресурс REST: v1
| Методы |
|---|
computeCustomRoutes | POST /v1:computeCustomRoutes
Учитывая набор конечных и промежуточных путевых точек, а также цель маршрута, вычисляет лучший маршрут для цели маршрута. |
computeRouteMatrix | POST /v1:computeRouteMatrix
Принимает список пунктов отправления и назначения и возвращает поток, содержащий информацию о маршруте для каждой комбинации пункта отправления и назначения. |
computeRoutes | POST /v1:computeRoutes
Возвращает основной маршрут вместе с дополнительными альтернативными маршрутами, учитывая набор конечных и промежуточных точек. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[null,null,["Последнее обновление: 2025-07-29 UTC."],[[["\u003cp\u003eThe Routes Preferred API service, \u003ccode\u003eroutespreferred.googleapis.com\u003c/code\u003e, helps developers compute optimal routes and route matrices based on given waypoints and objectives.\u003c/p\u003e\n"],["\u003cp\u003eThe service offers two versions: \u003ccode\u003ev1alpha\u003c/code\u003e and \u003ccode\u003ev1\u003c/code\u003e, each supporting methods like \u003ccode\u003ecomputeCustomRoutes\u003c/code\u003e, \u003ccode\u003ecomputeRouteMatrix\u003c/code\u003e, and \u003ccode\u003ecomputeRoutes\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are recommended for interacting with the service, but developers can also use the provided discovery documents and service endpoint for custom integration.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ecomputeCustomRoutes\u003c/code\u003e allows developers to define route objectives and receive tailored route recommendations, while \u003ccode\u003ecomputeRoutes\u003c/code\u003e provides primary and alternate routes for standard navigation.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ecomputeRouteMatrix\u003c/code\u003e facilitates the calculation of route information for multiple origin-destination pairs, enabling efficient analysis of travel times and distances.\u003c/p\u003e\n"]]],["The `routespreferred.googleapis.com` service offers two REST resources, `v1alpha` and `v1`, accessible via the `https://routespreferred.googleapis.com` endpoint. Both versions support three `POST` methods: `computeCustomRoutes` to calculate the best route based on waypoints and objectives, `computeRouteMatrix` to retrieve route information for multiple origin-destination pairs, and `computeRoutes` to return primary and optional alternate routes between waypoints. The service provides discovery documents for each version.\n"],null,["# Routes Preferred API\n\n- [REST Resource: v1alpha](#v1alpha)\n- [REST Resource: v1](#v1)\n\nService: routespreferred.googleapis.com\n---------------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:\n\n- \u003chttps://routespreferred.googleapis.com/$discovery/rest?version=v1\u003e\n- \u003chttps://routespreferred.googleapis.com/$discovery/rest?version=v1alpha\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://routespreferred.googleapis.com`\n\nREST Resource: [v1alpha](/maps/documentation/routes_preferred/reference/rest/v1alpha/TopLevel)\n----------------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [computeCustomRoutes](/maps/documentation/routes_preferred/reference/rest/v1alpha/TopLevel/computeCustomRoutes) | `POST /v1alpha:computeCustomRoutes` Given a set of terminal and intermediate waypoints, and a route objective, computes the best route for the route objective. |\n| [computeRouteMatrix](/maps/documentation/routes_preferred/reference/rest/v1alpha/TopLevel/computeRouteMatrix) | `POST /v1alpha:computeRouteMatrix` Takes in a list of origins and destinations and returns a stream containing route information for each combination of origin and destination. |\n| [computeRoutes](/maps/documentation/routes_preferred/reference/rest/v1alpha/TopLevel/computeRoutes) | `POST /v1alpha:computeRoutes` Returns the primary route along with optional alternate routes, given a set of terminal and intermediate waypoints. |\n\nREST Resource: [v1](/maps/documentation/routes_preferred/reference/rest/v1/TopLevel)\n------------------------------------------------------------------------------------\n\n| Methods ||\n|------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [computeCustomRoutes](/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeCustomRoutes) | `POST /v1:computeCustomRoutes` Given a set of terminal and intermediate waypoints, and a route objective, computes the best route for the route objective. |\n| [computeRouteMatrix](/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRouteMatrix) | `POST /v1:computeRouteMatrix` Takes in a list of origins and destinations and returns a stream containing route information for each combination of origin and destination. |\n| [computeRoutes](/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRoutes) | `POST /v1:computeRoutes` Returns the primary route along with optional alternate routes, given a set of terminal and intermediate waypoints. |"]]
