Routes Preferred API در حال حاضر فقط برای مشتریان منتخب در دسترس است. برای کسب اطلاعات بیشتر
با واحد فروش تماس بگیرید.
ComputeCustomRoutesRequest
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
پیام درخواست ComputeCustomRoutes.
| نمایندگی JSON |
|---|
{
"origin": {
object (Waypoint)
},
"destination": {
object (Waypoint)
},
"intermediates": [
{
object (Waypoint)
}
],
"travelMode": enum (RouteTravelMode),
"routingPreference": enum (RoutingPreference),
"polylineQuality": enum (PolylineQuality),
"polylineEncoding": enum (PolylineEncoding),
"departureTime": string,
"routeModifiers": {
object (RouteModifiers)
},
"routeObjective": {
object (RouteObjective)
},
"languageCode": string,
"units": enum (Units)
} |
| فیلدها |
|---|
origin | object ( Waypoint ) مورد نیاز. نقطه راه مبدأ |
destination | object ( Waypoint ) مورد نیاز. ایستگاه بین راهی مقصد |
intermediates[] | object ( Waypoint ) اختیاری. مجموعه ای از ایستگاه های بین راهی در طول مسیر (به استثنای نقاط پایانه)، برای توقف یا عبور. حداکثر 25 ایستگاه بین راهی پشتیبانی می شود. |
travel Mode | enum ( RouteTravelMode ) اختیاری. نحوه حمل و نقل را مشخص می کند. فقط DRIVE و "TWO_WHEELER" پشتیبانی می شوند. |
routing Preference | enum ( RoutingPreference ) اختیاری. نحوه محاسبه مسیر را مشخص می کند. سرور سعی می کند از اولویت مسیریابی انتخاب شده برای محاسبه مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تاخیر طولانی مدت شود، یک خطا برگردانده می شود. شما می توانید این گزینه را فقط زمانی مشخص کنید که travelMode DRIVE یا TWO_WHEELER باشد، در غیر این صورت درخواست با شکست مواجه می شود. |
polyline Quality | enum ( PolylineQuality ) اختیاری. ترجیح شما را برای کیفیت پلی لاین مشخص می کند. |
polyline Encoding | enum ( PolylineEncoding ) اختیاری. رمزگذاری ترجیحی برای چند خط را مشخص می کند. |
departure Time | string ( Timestamp format) اختیاری. زمان حرکت اگر این مقدار را تنظیم نکنید، این مقدار به طور پیشفرض روی زمانی است که درخواست را انجام دادهاید. اگر این مقدار را روی زمانی تنظیم کنید که قبلاً رخ داده است، درخواست با شکست مواجه می شود. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" . |
route Modifiers | object ( RouteModifiers ) اختیاری. مجموعه ای از شرایط برای برآورده شدن که بر نحوه محاسبه مسیرها تأثیر می گذارد. |
route Objective | object ( RouteObjective ) مورد نیاز. یک هدف مسیر برای بهینه سازی. |
language Code | string اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به شناسه محلی یونیکد مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل درخواست مسیر استنباط می شود. |
units | enum ( Units ) اختیاری. واحدهای اندازه گیری فیلدهای نمایش را مشخص می کند. این شامل فیلد instruction در NavigationInstruction است. واحدهای اندازه گیری مورد استفاده برای مسیر، پا، فاصله گام، و مدت زمان تحت تأثیر این مقدار قرار نمی گیرند. اگر این مقدار را ارائه نکنید، واحدهای نمایش از محل درخواست استنتاج می شوند. |
RouteObjective
هدفی را برای بهینه سازی توسط ComputeCustomRoutes در خود گنجانده است.
| نمایندگی JSON |
|---|
{
// Union field objective can be only one of the following:
"rateCard": {
object (RateCard)
}
// End of list of possible types for union field objective.
} |
| فیلدها |
|---|
objective میدانی اتحادیه هدف مسیر objective فقط می تواند یکی از موارد زیر باشد: |
rate Card | object ( RateCard ) هدف RateCard |
کارت امتیاز
هدف مسیر RateCard را در بر می گیرد.
| نمایندگی JSON |
|---|
{
"costPerMinute": {
object (MonetaryCost)
},
"costPerKm": {
object (MonetaryCost)
},
"includeTolls": boolean
} |
| فیلدها |
|---|
cost Per Minute | object ( MonetaryCost ) اختیاری. هزینه هر دقیقه |
cost Per Km | object ( MonetaryCost ) اختیاری. هزینه هر کیلومتر |
include Tolls | boolean اختیاری. اینکه آیا هزینه عوارض در هزینه کلی لحاظ شود. |
هزینه پولی
هزینه استفاده شده در کارت نرخ را در بر می گیرد.
| نمایندگی JSON |
|---|
{
"value": number
} |
| فیلدها |
|---|
value | number مورد نیاز. ارزش هزینه به ارز محلی استنتاج شده از درخواست. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],["The core content outlines the `ComputeCustomRoutes` request, detailing how to define a route and its optimization parameters. Key actions include specifying the `origin`, `destination`, and optional `intermediates` via waypoints. Users can select `travelMode`, `routingPreference`, `polylineQuality`, and `polylineEncoding`. `departureTime` can be set. The `routeObjective`, which can use a `RateCard`, including `costPerMinute`, `costPerKm`, and if to include tolls, defines optimization goals. `MonetaryCost` is used to define cost for rate cards. `languageCode` and `units` are also supported.\n"]]