Routes Preferred API
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Usługa: Routepreferred.googleapis.com
Do wywołania tej usługi zalecamy użycie dostarczonych przez Google bibliotek klienta. Jeśli do wywoływania tej usługi aplikacja musi używać Twoich własnych bibliotek, podczas tworzenia żądań do interfejsu API użyj podanych niżej informacji.
Dokument opisujący
Dokument opisujący to czytelna dla komputera specyfikacja opisująca interfejsy API REST i ich używanie. Służy do tworzenia bibliotek klienta, wtyczek IDE i innych narzędzi, które współdziałają z interfejsami API Google. Jedna usługa może dostarczać wiele dokumentów opisujących. Ta usługa dostarcza następujące dokumenty wykrywania:
Punkt końcowy usługi
Punkt końcowy usługi to podstawowy adres URL, który określa adres sieciowy usługi interfejsu API. Jedna usługa może mieć wiele punktów końcowych. Ta usługa ma następujący punkt końcowy i wszystkie poniższe identyfikatory URI są względne wobec tego punktu końcowego:
https://routespreferred.googleapis.com
Metody |
computeCustomRoutes |
POST /v1alpha:computeCustomRoutes
Biorąc pod uwagę zestaw terminali i punktów pośrednich oraz cel trasy, oblicza najlepszą trasę dla jej celu. |
computeRouteMatrix |
POST /v1alpha:computeRouteMatrix
pobiera listę miejsc wylotu i przylotu, po czym zwraca strumień zawierający informacje o trasie dla każdej kombinacji miejsca wyjazdu i celu podróży. |
computeRoutes |
POST /v1alpha:computeRoutes Zwraca trasę podstawową wraz z opcjonalnymi trasami alternatywnymi na podstawie zestawu terminali i pośrednich punktów na trasie. |
Zasób REST: v1
Metody |
computeCustomRoutes |
POST /v1:computeCustomRoutes
Biorąc pod uwagę zestaw terminali i punktów pośrednich oraz cel trasy, oblicza najlepszą trasę dla jej celu. |
computeRouteMatrix |
POST /v1:computeRouteMatrix
pobiera listę miejsc wylotu i przylotu, po czym zwraca strumień zawierający informacje o trasie dla każdej kombinacji miejsca wyjazdu i celu podróży. |
computeRoutes |
POST /v1:computeRoutes Zwraca trasę podstawową wraz z opcjonalnymi trasami alternatywnymi na podstawie zestawu terminali i pośrednich punktów na trasie. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-26 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. |"]]