Method: computeRoutes

{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}

enum ( RouteLabel )

برچسب‌هایی برای Route که برای شناسایی ویژگی‌های خاص مسیر برای مقایسه با دیگران مفید هستند.

object ( RouteLeg )

مجموعه ای از پاها (بخش های مسیر بین ایستگاه های بین راه) که مسیر را تشکیل می دهند. هر پا مربوط به سفر بین دو Waypoints غیر از via است. به عنوان مثال، مسیری که هیچ ایستگاه بین راهی ندارد، تنها یک پا دارد. مسیری که شامل یک ایستگاه بین راهی غیر از via است، دو پا دارد. مسیری که شامل یک مسیر via ایستگاه بین راهی است، یک پا دارد. ترتیب پاها با ترتیب ایستگاه های بین راه از origin تا intermediates تا destination مطابقت دارد.

integer

مسافت طی مسیر، بر حسب متر.

string ( Duration format)

مدت زمان لازم برای پیمایش مسیر. اگر routingPreference را روی TRAFFIC_UNAWARE تنظیم کنید، این مقدار همان staticDuration است. اگر routingPreference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کنید، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می شود.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

string ( Duration format)

مدت زمان سفر در مسیر بدون در نظر گرفتن شرایط ترافیکی.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

object ( Polyline )

چند خط کلی مسیر. این چند خط، چند خط ترکیبی همه legs است.

string

شرح مسیر.

string

مجموعه ای از هشدارها برای نشان دادن هنگام نمایش مسیر.

object ( Viewport )

کادر محدودکننده نما در چند خط.

object ( RouteTravelAdvisory )

اطلاعات تکمیلی در مورد مسیر.

integer

اگر optimizeWaypointOrder روی true تنظیم کنید، این فیلد شامل ترتیب بهینه شده نقاط بین راهی است. در غیر این صورت این قسمت خالی است. برای مثال، اگر ورودی Origin را بدهید: LA; ایستگاه های بین راهی: دالاس، بانگور، فینیکس؛ مقصد: نیویورک؛ و ترتیب میانی بهینه شده Phoenix، Dallas، Bangor است، سپس این فیلد حاوی مقادیر [2، 0، 1] است. شاخص با 0 برای اولین نقطه میانی ارائه شده در ورودی شروع می شود.

object ( RouteLocalizedValues )

نمایش متنی ویژگی های Route .

string

یک توکن مسیر ایمن و با کد base64 که می‌تواند به Navigation SDK ارسال شود، که به Navigation SDK اجازه می‌دهد مسیر را در حین پیمایش بازسازی کند و در صورت تغییر مسیر، هنگام ایجاد مسیر با تماس، به هدف اصلی احترام بگذارد. v2.computeRoutes. مشتریان باید با این توکن به عنوان یک لکه غیر شفاف برخورد کنند. برای خواندن یا جهش در نظر گرفته نشده است. توجه: Route.route_token فقط برای درخواست‌هایی در دسترس است که ComputeRoutesRequest.routing_preference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کرده‌اند. Route.route_token برای درخواست هایی که دارای ایستگاه های بین راه هستند پشتیبانی نمی شود.

{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}

integer

مسافت طی مسیر، بر حسب متر.

string ( Duration format)

مدت زمان لازم برای حرکت در پا. اگر route_preference روی TRAFFIC_UNAWARE تنظیم شود، این مقدار همان staticDuration است. اگر route_preference یا TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL باشد، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می شود.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

string ( Duration format)

مدت زمان سفر از طریق پا، بدون در نظر گرفتن شرایط ترافیک محاسبه شده است.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

object ( Polyline )

چند خط کلی برای این پا که شامل چند خط هر step است.

object ( Location )

محل شروع این پا. این مکان ممکن است با origin ارائه شده متفاوت باشد. به عنوان مثال، زمانی که origin ارائه شده نزدیک جاده نباشد، این نقطه ای از جاده است.

object ( Location )

محل انتهایی این پا. این مکان ممکن است با destination ارائه شده متفاوت باشد. به عنوان مثال، زمانی که destination ارائه شده نزدیک جاده ای نباشد، این نقطه ای در جاده است.

object ( RouteLegStep )

مجموعه‌ای از مراحل که بخش‌های درون این پا را نشان می‌دهد. هر مرحله نشان دهنده یک دستورالعمل ناوبری است.

object ( RouteLegTravelAdvisory )

حاوی اطلاعات اضافی است که کاربر باید از آنها مطلع شود، مانند محدودیت های احتمالی منطقه ترافیک، در یک مسیر.

object ( RouteLegLocalizedValues )

نمایش متنی ویژگی های RouteLeg .

object ( StepsOverview )

اطلاعات کلی در مورد مراحل این RouteLeg . این قسمت فقط برای مسیرهای TRANSIT پر شده است.

{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}

string

رمزگذاری رشته چند خط با استفاده از الگوریتم کدگذاری چند خطی

object ( Struct format)

با استفاده از قالب GeoJSON LineString یک چند خط را مشخص می کند.

{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}

integer

مسافت طی این مرحله، بر حسب متر است. در برخی شرایط، این فیلد ممکن است ارزشی نداشته باشد.

string ( Duration format)

مدت زمان سفر در این مرحله بدون در نظر گرفتن شرایط ترافیکی. در برخی شرایط، این فیلد ممکن است ارزشی نداشته باشد.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

object ( Polyline )

چند خط مرتبط با این مرحله.

object ( Location )

محل شروع این مرحله.

object ( Location )

محل پایان این مرحله.

object ( NavigationInstruction )

دستورالعمل های ناوبری.

object ( RouteLegStepTravelAdvisory )

حاوی اطلاعات اضافی است که کاربر باید از آنها مطلع شود، مانند محدودیت های احتمالی منطقه ترافیک، در یک گام.

object ( RouteLegStepLocalizedValues )

نمایش متنی خصوصیات RouteLegStep .

object ( RouteLegStepTransitDetails )

جزئیات مربوط به این مرحله اگر حالت سفر TRANSIT باشد.

enum ( RouteTravelMode )

حالت سفر استفاده شده برای این مرحله.

{
  "maneuver": enum (Maneuver),
  "instructions": string
}

enum ( Maneuver )

دستورالعمل‌های پیمایش مرحله فعلی را در بر می‌گیرد (به عنوان مثال، گردش به چپ، ادغام یا مستقیم). این فیلد تعیین می کند که کدام نماد نمایش داده شود.

string

دستورالعمل پیمایش در این مرحله

{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object ( SpeedReadingInterval )

توجه: این فیلد در حال حاضر پر نشده است.

{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object ( LocalizedText )

مسافت سفر به صورت متنی نشان داده شده است.

object ( LocalizedText )

مدت زمان بدون در نظر گرفتن شرایط ترافیک، به صورت متن نشان داده شده است.

{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}

object ( TransitStopDetails )

اطلاعات در مورد ورود و خروج توقف برای مرحله.

object ( TransitDetailsLocalizedValues )

نمایش متنی خصوصیات RouteLegStepTransitDetails .

string

جهت حرکت در این خط را همانطور که روی وسیله نقلیه یا در ایستگاه خروج مشخص شده است مشخص می کند. جهت اغلب ایستگاه پایانه است.

string ( Duration format)

زمان مورد انتظار را به عنوان مدت زمان بین خروج از همان توقف در این زمان مشخص می کند. به عنوان مثال، با مقدار 600 ثانیه پیشروی، اگر اتوبوس خود را از دست بدهید، انتظار دارید ده دقیقه صبر کنید.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

object ( TransitLine )

اطلاعات مربوط به خط ترانزیت مورد استفاده در این مرحله.

integer

تعداد توقف ها از مبدأ تا توقف ورود. این شمارش شامل توقف ورود است، اما توقف خروج را شامل نمی شود. به عنوان مثال، اگر مسیر شما از ایستگاه A خارج شود، از ایستگاه های B و C عبور کند و به ایستگاه D برسد، stopCount عدد 3 را برمی گرداند.

string

متنی که در جدول ها و تابلوهای علامت برای شناسایی یک سفر ترانزیت به مسافران ظاهر می شود. متن باید به طور منحصر به فرد یک سفر در یک روز خدمات را مشخص کند. به عنوان مثال، "538" tripShortText قطار Amtrak است که سن خوزه، کالیفرنیا را در ساعت 15:10 روزهای هفته به سمت ساکرامنتو، کالیفرنیا ترک می کند.

{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}

object ( TransitStop )

اطلاعات در مورد توقف رسیدن برای مرحله.

string ( Timestamp format)

زمان تخمینی رسیدن به مرحله.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

object ( TransitStop )

اطلاعات در مورد توقف حرکت برای پله.

string ( Timestamp format)

زمان تخمینی حرکت برای مرحله.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

{
  "name": string,
  "location": {
    object (Location)
  }
}

string

نام ایستگاه حمل و نقل.

object ( Location )

محل توقف با مختصات طول و عرض جغرافیایی بیان می شود.

{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}

object ( LocalizedTime )

زمان در نمایش متن قالب بندی شده با منطقه زمانی مربوطه.

object ( LocalizedTime )

زمان در نمایش متن قالب بندی شده با منطقه زمانی مربوطه.

{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}

object ( LocalizedText )

زمان مشخص شده به عنوان یک رشته در یک منطقه زمانی معین.

string

شامل منطقه زمانی است. مقدار، نام منطقه زمانی است که در پایگاه داده منطقه زمانی IANA تعریف شده است، به عنوان مثال "America/New_York".

{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}

object ( TransitAgency )

آژانس حمل و نقل (یا آژانس هایی) که این خط ترانزیت را اداره می کند.

string

نام کامل این خط ترانزیت، به عنوان مثال، "8 Avenue Local".

string

URI این خط ترانزیت که توسط آژانس حمل و نقل ارائه شده است.

string

رنگی که معمولا در تابلوهای این خط استفاده می شود. در هگزادسیمال نشان داده شده است.

string

URI برای نماد مرتبط با این خط.

string

نام کوتاه این خط ترانزیت. این نام معمولاً یک شماره خط است، مانند "M7" یا "355".

string

رنگی که معمولاً در متن روی تابلوهای این خط استفاده می شود. در هگزادسیمال نشان داده شده است.

object ( TransitVehicle )

نوع وسیله نقلیه ای که در این خط ترانزیتی تردد می کند.

{
  "name": string,
  "phoneNumber": string,
  "uri": string
}

string

نام این آژانس حمل و نقل.

string

شماره تلفن قالب‌بندی شده آژانس حمل و نقل.

string

URI آژانس حمل و نقل.

{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}

object ( LocalizedText )

نام این وسیله نقلیه با حروف بزرگ.

enum ( TransitVehicleType )

نوع وسیله نقلیه مورد استفاده.

string

URI برای نماد مرتبط با این نوع خودرو.

string

URI برای نماد مرتبط با این نوع وسیله نقلیه، بر اساس علائم حمل و نقل محلی.

{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object ( TollInfo )

حاوی اطلاعاتی درباره عوارض در RouteLeg خاص است. این فیلد فقط در صورتی پر می شود که انتظار داشته باشیم عوارضی در RouteLeg وجود داشته باشد. اگر این فیلد تنظیم شده باشد اما زیرفیلد برآورد شده قیمت پر نشده باشد، انتظار داریم که جاده شامل عوارض باشد اما قیمت تخمینی را نمی دانیم. اگر این فیلد وجود نداشته باشد، هیچ عوارضی در RouteLeg وجود ندارد.

object ( SpeedReadingInterval )

فواصل تندخوانی با جزئیات تراکم ترافیک. قابل اجرا در موارد ترجیحات مسیریابی TRAFFIC_AWARE و TRAFFIC_AWARE_OPTIMAL . فواصل، کل چند خط RouteLeg را بدون همپوشانی پوشش می دهند. نقطه شروع یک بازه مشخص با نقطه پایان بازه قبلی یکسان است.

مثال:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object ( LocalizedText )

مسافت سفر به صورت متنی نشان داده شده است.

object ( LocalizedText )

مدت زمان با در نظر گرفتن شرایط ترافیکی به صورت متن نشان داده شده است. توجه: اگر اطلاعات ترافیک را درخواست نکرده باشید، این مقدار همان مقدار staticDuration خواهد بود.

object ( LocalizedText )

مدت زمان بدون در نظر گرفتن شرایط ترافیک، به صورت متن نشان داده شده است.

{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}

object ( MultiModalSegment )

اطلاعات خلاصه شده در مورد بخش های مختلف چند وجهی RouteLeg.steps . اگر RouteLeg شامل بخش‌های چند وجهی در مراحل نباشد، این فیلد پر نمی‌شود.

{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}

object ( NavigationInstruction )

راهنمای ناوبری برای بخش چند وجهی.

enum ( RouteTravelMode )

حالت سفر بخش چند وجهی.

integer

شاخص RouteLegStep مربوطه که شروع یک بخش چند وجهی است.

integer

شاخص RouteLegStep مربوطه که انتهای یک بخش چند وجهی است.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object ( LatLng )

ضروری. نقطه پایین دید.

object ( LatLng )

ضروری. نقطه اوج دید.

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}

object ( LocalizedText )

مسافت سفر به صورت متنی نشان داده شده است.

object ( LocalizedText )

مدت زمان با در نظر گرفتن شرایط ترافیک، به صورت متن نشان داده شده است. توجه: اگر اطلاعات ترافیک را درخواست نکرده باشید، این مقدار همان مقدار staticDuration خواهد بود.

object ( LocalizedText )

مدت زمان بدون در نظر گرفتن شرایط ترافیک، به صورت متن نشان داده شده است.

object ( LocalizedText )

کرایه حمل و نقل به صورت متنی نشان داده شده است.

{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}

object ( GeocodedWaypoint )

نقطه بین مسیرهای جغرافیایی کدگذاری شده مبدا.

object ( GeocodedWaypoint )

نقطه گذر جغرافیایی مقصد.

object ( GeocodedWaypoint )

فهرستی از نقاط بین راهی با کدهای جغرافیایی میانی که هر کدام حاوی یک فیلد شاخص است که به ترتیبی که در درخواست مشخص شده است، با موقعیت صفر نقطه راه مطابقت دارد.

{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}

object ( Status )

کد وضعیت حاصل از عملیات کدگذاری جغرافیایی را نشان می دهد.

string

نوع (های) نتیجه، به صورت تگ های صفر یا بیشتر. انواع پشتیبانی شده: انواع آدرس و انواع اجزای آدرس .

boolean

نشان می دهد که geocoder مطابقت دقیقی با درخواست اصلی برنگردانده است، اگرچه می تواند بخشی از آدرس درخواستی را مطابقت دهد. ممکن است بخواهید درخواست اصلی برای غلط املایی و/یا آدرس ناقص را بررسی کنید.

string

شناسه مکان برای این نتیجه.

integer

شاخص نقطه میانی مربوطه در درخواست. فقط در صورتی پر می شود که نقطه بین راه مربوطه یک ایستگاه بین راهی باشد.