تتوفر
واجهة برمجة تطبيقات المسارات المفضلة حاليًا لعملاء محددين فقط. يمكنك
التواصل مع فريق المبيعات لمعرفة المزيد من المعلومات.
Routes Preferred API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الخدمة: pathFavorite.googleapis.com
لطلب هذه الخدمة، ننصحك باستخدام مكتبات البرامج التي توفّرها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة لاستدعاء هذه الخدمة، استخدِم المعلومات التالية عند تقديم طلبات البيانات من واجهة برمجة التطبيقات.
مستند Discovery
مستند الاستكشاف هو مواصفة يمكن للآلة قراءتها، لوصف واجهات برمجة تطبيقات REST واستخدامها. يُستخدم لإنشاء مكتبات للعملاء، ومكونات IDE الإضافية، وأدوات أخرى تتفاعل مع Google APIs. قد توفّر خدمة واحدة مستندات استكشاف متعددة. توفّر هذه الخدمة مستندات الاكتشاف التالية:
نقطة نهاية الخدمة
نقطة نهاية الخدمة هي عنوان URL أساسي يحدّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تحتوي خدمة واحدة على عدة نقاط نهاية للخدمة. تشتمل هذه الخدمة على نقطة نهاية الخدمة التالية، وترتبط جميع معرّفات الموارد المنتظمة (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 Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
