Method: computeRoutes

مسیر اصلی را به‌همراه مسیرهای جایگزین اختیاری، با درنظر گرفتن مجموعه‌ای از ایستگاه‌های بین راهی و پایانی، برمی‌گرداند.

توجه: این روش مستلزم آن است که یک پوشش فیلد پاسخ را در ورودی مشخص کنید. می‌توانید پوشش فیلد پاسخ را بااستفاده از پارامتر نشانی وب $fields یا fields، یا بااستفاده از سرایند HTTP/gRPC X-Goog-FieldMask ارائه دهید (پارامترهای نشانی وب و سرایندهای دردسترس را ببینید). مقدار فهرستی از مسیرهای فیلد است که با کاما از هم جدا شده‌اند. مستندات مفصلی درباره نحوه ساختن مسیرهای فیلد را ببینید.

برای مثال، در این روش:

  • پوشش فیلد همه فیلدهای دردسترس (برای بازرسی دستی): X-Goog-FieldMask: *
  • پوشش فیلد مدت، فاصله، و چندخطی سطح «مسیر» (نمونه‌ای از تنظیم تولید): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

‫Google استفاده از پوشش فیلد پاسخ نویسه عام (*) یا مشخص کردن پوشش فیلد در سطح بالا (routes) را توصیه نمی‌کند، زیرا:

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

درخواست HTTP

POST https://routes.googleapis.com/directions/v2:computeRoutes

نشانی وب از نحو ترانویسی gRPC استفاده می‌کند.

متن درخواست

بدنه درخواست حاوی داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
فیلدها
origin

object (Waypoint)

الزامی. نقطه‌مسیر مبدأ.
destination

object (Waypoint)

الزامی. ایستگاه بین راهی مقصد.
intermediates[]

object (Waypoint)

اختیاری. مجموعه‌ای از نقاط بین مسیر (به‌جز نقاط پایانی)، برای توقف در آن‌ها یا عبور از کنار آن‌ها. حداکثر از ۲۵ ایستگاه بین راهی پشتیبانی می‌شود.
travelMode

enum (RouteTravelMode)

اختیاری. حالت حمل‌ونقل را مشخص می‌کند.
routingPreference

enum (RoutingPreference)

اختیاری. نحوه محاسبه مسیر را مشخص می‌کند. کارساز تلاش می‌کند از اولویت مسیریابی انتخاب‌شده برای محاسبه مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تأخیر بسیار طولانی شود، خطا برگردانده می‌شود. این گزینه را فقط زمانی می‌توانید مشخص کنید که travelMode DRIVE یا TWO_WHEELER باشد، درغیراین‌صورت درخواست ناموفق خواهد بود.
polylineQuality

enum (PolylineQuality)

اختیاری. اولویت شما را برای کیفیت چندخطی مشخص می‌کند.
polylineEncoding

enum (PolylineEncoding)

اختیاری. کدبندی ترجیحی را برای چندخطی مشخص می‌کند.
departureTime

string (Timestamp format)

اختیاری. زمان حرکت. اگر این مقدار را تنظیم نکنید، این مقدار به‌طور پیش‌فرض روی زمانی که درخواست را ارسال کرده‌اید تنظیم می‌شود. توجه: فقط زمانی می‌توانید departureTime را در گذشته مشخص کنید که RouteTravelMode روی TRANSIT تنظیم شده باشد. سفرهای حمل‌ونقل عمومی تا ۷ روز گذشته یا ۱۰۰ روز آینده دردسترس است.

از RFC 3339 استفاده می‌کند، که در آن برونداد تولیدشده همیشه Z-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم کسری استفاده می‌کند. انحراف‌های غیر از «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".
arrivalTime

string (Timestamp format)

اختیاری. زمان رسیدن. توجه: وقتی درخواست‌ها RouteTravelMode دیگری به‌جز TRANSIT را مشخص می‌کنند، این فیلد نادیده گرفته می‌شود. می‌توانید departureTime یا arrivalTime را مشخص کنید، اما نمی‌توانید هر دو را مشخص کنید. سفرهای حمل‌ونقل عمومی تا ۷ روز گذشته یا ۱۰۰ روز آینده دردسترس است.

از RFC 3339 استفاده می‌کند، که در آن برونداد تولیدشده همیشه Z-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم کسری استفاده می‌کند. انحراف‌های غیر از «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".
computeAlternativeRoutes

boolean

اختیاری. مشخص می‌کند که آیا مسیرهای جایگزین علاوه‌بر مسیر محاسبه شود یا نه. برای درخواست‌هایی که ایستگاه‌های بین راهی دارند، مسیرهای جایگزین برگردانده نمی‌شود.
routeModifiers

object (RouteModifiers)

اختیاری. مجموعه‌ای از شرایطی که باید برآورده شوند و بر نحوه محاسبه مسیرها تأثیر می‌گذارند.
languageCode

string

اختیاری. کد زبان BCP-47، مانند «en-US» یا «sr-Latn». برای اطلاعات بیشتر، شناسه مکان Unicode را ببینید. برای فهرست زبان‌های پشتیبانی‌شده، پشتیبانی از زبان را ببینید. وقتی این مقدار را ارائه نمی‌دهید، زبان نمایش از مکان درخواست مسیر استنباط می‌شود.
regionCode

string

اختیاری. کد منطقه، که به‌عنوان مقدار دوحرفی ccTLD («دامنه سطح بالا») مشخص شده است. برای اطلاعات بیشتر، دامنه‌های سطح بالای کد کشور را ببینید.
units

enum (Units)

اختیاری. واحدهای اندازه‌گیری را برای فیلدهای نمایش مشخص می‌کند. این فیلدها شامل فیلد instruction در NavigationInstruction می‌شود. واحدهای اندازه‌گیری استفاده‌شده برای مسیر، بخش، فاصله گام، و مدت زمان تحت تأثیر این مقدار قرار نمی‌گیرند. اگر این مقدار را ارائه ندهید، واحدهای نمایش از مکان اولین مبدأ استنباط می‌شود.
optimizeWaypointOrder

boolean

اختیاری. اگر روی درست تنظیم شود، سرویس تلاش می‌کند با تغییر ترتیب ایستگاه‌های بین راه مشخص‌شده، هزینه کلی مسیر را به حداقل برساند. اگر هریک از ایستگاه‌های بین راهی via ایستگاه بین راهی باشد، درخواست ناموفق خواهد بود. از ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index برای پیدا کردن ترتیب جدید استفاده کنید. اگر ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index در سرایند X-Goog-FieldMask درخواست نشود، درخواست ناموفق خواهد بود. اگر optimizeWaypointOrder روی «نادرست» تنظیم شود، ComputeRoutesResponse.optimized_intermediate_waypoint_index خالی خواهد بود.
requestedReferenceRoutes[]

enum (ReferenceRoute)

اختیاری. مشخص می‌کند که کدام مسیرهای مرجع به‌عنوان بخشی از درخواست علاوه بر مسیر پیش‌فرض محاسبه شوند. مسیر مرجع مسیری است که هدف محاسبه مسیر آن با مسیر پیش‌فرض متفاوت است. برای مثال، FUEL_EFFICIENT محاسبه مسیر مرجع پارامترهای مختلفی را درنظر می‌گیرد که مسیری بهینه با مصرف سوخت کارآمد تولید می‌کند. هنگام استفاده از این ویژگی، به‌دنبال routeLabels در مسیرهای حاصل بگردید.
extraComputations[]

enum (ExtraComputation)

اختیاری. فهرستی از محاسبات اضافی که ممکن است برای تکمیل درخواست استفاده شود. توجه: این محاسبات اضافی ممکن است فیلدهای اضافی را در پاسخ برگرداند. این فیلدهای اضافی باید در پوشش فیلد نیز مشخص شوند تا در پاسخ برگردانده شوند.
trafficModel

enum (TrafficModel)

اختیاری. فرضیه‌هایی را که هنگام محاسبه زمان در ترافیک باید استفاده شود مشخص می‌کند. این تنظیم بر مقداری که در فیلد مدت در Route و RouteLeg برگردانده می‌شود تأثیر می‌گذارد. این فیلد حاوی زمان پیش‌بینی‌شده در ترافیک براساس میانگین‌های تاریخی است. ‫TrafficModel فقط برای درخواست‌هایی دردسترس است که RoutingPreference را روی TRAFFIC_AWARE_OPTIMAL و RouteTravelMode را روی DRIVE تنظیم کرده باشند. اگر ترافیک درخواست شود و TrafficModel مشخص نشده باشد، به‌طور پیش‌فرض BEST_GUESS درنظر گرفته می‌شود.
transitPreferences

object (TransitPreferences)

اختیاری. اولویت‌هایی را مشخص می‌کند که بر مسیر برگشتی برای TRANSIT مسیر تأثیر می‌گذارند. توجه: فقط زمانی می‌توانید transitPreferences را مشخص کنید که RouteTravelMode روی TRANSIT تنظیم شده باشد.

متن پاسخ

‫v2.computeRoutes پیام پاسخ را محاسبه می‌کند.

درصورت موفقیت‌آمیز بودن، بدنه پاسخ حاوی داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
فیلدها
routes[]

object (Route)

وقتی compute_alternatives_routes را مشخص می‌کنید، حاوی آرایه‌ای از مسیرهای محاسبه‌شده (تا سه مسیر) است و وقتی مشخص نمی‌کنید، فقط حاوی یک مسیر است. وقتی این آرایه حاوی چندین ورودی باشد، اولین ورودی توصیه‌شده‌ترین مسیر است. اگر آرایه خالی باشد، یعنی مسیری پیدا نشده است.
fallbackInfo

object (FallbackInfo)

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

object (GeocodingResults)

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

PolylineQuality

مجموعه‌ای از مقادیر که کیفیت چندخطی را مشخص می‌کنند.

شمارشی‌ها
POLYLINE_QUALITY_UNSPECIFIED اولویت کیفیت چندخطی مشخص نشده است. پیش‌فرض OVERVIEW است.
HIGH_QUALITY چندخطی با کیفیت بالا را مشخص می‌کند - که بااستفاده از نقاط بیشتری نسبت‌به OVERVIEW ساخته می‌شود، اما درعوض اندازه پاسخ افزایش می‌یابد. وقتی به دقت بیشتری نیاز دارید از این مقدار استفاده کنید.
OVERVIEW چندخطی نمای کلی را مشخص می‌کند - که بااستفاده از تعداد کمی نقطه ساخته می‌شود. از این مقدار هنگام نمایش نمای کلی مسیر استفاده کنید. استفاده از این گزینه در مقایسه با استفاده از گزینه HIGH_QUALITY تأخیر درخواست کمتری دارد.

PolylineEncoding

نوع چندخطی ترجیحی را که باید برگردانده شود مشخص می‌کند.

شمارشی‌ها
POLYLINE_ENCODING_UNSPECIFIED اولویت نوع چندخطی مشخص نشده است. پیش‌فرض ENCODED_POLYLINE است.
ENCODED_POLYLINE چندخطی را که بااستفاده از الگوریتم کدبندی چندخطی کدبندی شده است مشخص می‌کند.
GEO_JSON_LINESTRING چندخطی را بااستفاده از قالب GeoJSON LineString مشخص می‌کند

ReferenceRoute

مسیر مرجع پشتیبانی‌شده در ComputeRoutesRequest.

شمارشی‌ها
REFERENCE_ROUTE_UNSPECIFIED استفاده‌نشده. درخواست‌های حاوی این مقدار ناموفق است.
FUEL_EFFICIENT مسیر با بهره‌وری سوخت.
SHORTER_DISTANCE

مسیر با فاصله سفر کوتاه‌تر. این قابلیتی آزمایشی است.

برای DRIVE درخواست، این ویژگی مسافت کوتاه‌تر را بر راحتی رانندگی اولویت می‌دهد. برای مثال، ممکن است جاده‌های محلی را به‌جای بزرگراه‌ها ترجیح دهد، از جاده‌های خاکی استفاده کند، از میان پارکینگ‌ها عبور کند، و غیره. این ویژگی هیچ مانوری را که Google Maps می‌داند غیرقانونی است برنمی‌گرداند.

برای درخواست‌های BICYCLE و TWO_WHEELER، این ویژگی مسیرهایی مشابه مسیرهایی که وقتی requestedReferenceRoutes را مشخص نمی‌کنید برمی‌گرداند.

این ویژگی با هیچ‌یک از حالت‌های سفر دیگر، ازطریق ایستگاه‌های بین راهی، یا optimizeWaypointOrder سازگار نیست؛ چنین درخواست‌هایی ناموفق خواهد بود. بااین‌حال، می‌توانید آن را با هر routingPreference استفاده کنید.

ExtraComputation

محاسبات اضافی برای انجام درحین تکمیل درخواست. مقادیر اضافی ممکن است در آینده اضافه شود.

شمارشی‌ها
EXTRA_COMPUTATION_UNSPECIFIED استفاده‌نشده. درخواست‌های حاوی این مقدار ناموفق خواهد بود.
TOLLS اطلاعات عوارض برای مسیر(ها).
FUEL_CONSUMPTION مصرف سوخت تخمینی برای مسیر(ها).
TRAFFIC_ON_POLYLINE چندخطی‌های آگاه از ترافیک برای مسیر(ها).
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstruction به‌عنوان رشته نوشتاری HTML قالب‌بندی‌شده ارائه می‌شود. این محتوا باید همان‌گونه که هست خوانده شود. این محتوا فقط برای نمایش است. آن را به‌صورت برنامه‌ریزی‌شده تجزیه نکنید.
FLYOVER_INFO_ON_POLYLINE اطلاعات پل هوایی برای مسیر(ها). برای برگرداندن این اطلاعات، باید فیلدماسک routes.polyline_details.flyover_info مشخص شود. درحال‌حاضر، این داده‌ها فقط برای برخی‌از شهرهای هند تکمیل می‌شود. این ویژگی آزمایشی است و واحد نگهداری کالا/هزینه ممکن است تغییر کند.
NARROW_ROAD_INFO_ON_POLYLINE اطلاعات جاده باریک برای مسیر(ها). برای برگرداندن این اطلاعات، باید فیلدماسک routes.polyline_details.narrow_road_info مشخص شود. درحال‌حاضر، این داده‌ها فقط برای برخی‌از شهرهای هند تکمیل می‌شود. این ویژگی آزمایشی است و واحد نگهداری کالا/هزینه ممکن است تغییر کند.
TUNNEL_INFO_ON_POLYLINE اطلاعات تونل برای مسیر(ها). برای برگرداندن این اطلاعات، باید فیلدماسک routes.polyline_details.tunnel_info مشخص شود.
BRIDGE_INFO_ON_POLYLINE اطلاعات پل برای مسیر(ها). برای برگرداندن این اطلاعات، باید فیلدماسک routes.polyline_details.bridge_info مشخص شود.
SKYWAY_INFO_ON_POLYLINE اطلاعات پل هوایی برای مسیر(ها). برای برگرداندن این اطلاعات، باید فیلدماسک routes.polyline_details.skyway_info مشخص شود.

مسیر

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

نمایش JSON 
{
  "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,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
فیلدها
routeLabels[]

enum (RouteLabel)

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

object (RouteLeg)

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

integer

مسافت سفر مسیر، به متر.
duration

string (Duration format)

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

مدت زمان به ثانیه با حداکثر نه رقم اعشاری، که با «s» پایان می‌یابد. مثال: "3.5s".
staticDuration

string (Duration format)

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

مدت زمان به ثانیه با حداکثر نه رقم اعشاری، که با «s» پایان می‌یابد. مثال: "3.5s".
polyline

object (Polyline)

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

string

شرح مسیر.
warnings[]

string

آرایه‌ای از هشدارها برای نمایش هنگام نمایش مسیر.
viewport

object (Viewport)

چارگوش محصورکننده ناحیه نمایش چندخطی.
travelAdvisory

object (RouteTravelAdvisory)

اطلاعات تکمیلی درباره مسیر.
optimizedIntermediateWaypointIndex[]

integer

اگر optimizeWaypointOrder را روی درست تنظیم کنید، این فیلد حاوی ترتیب بهینه‌سازی‌شده ایستگاه‌های بین راهی است. درغیراین‌صورت، این فیلد خالی است. برای مثال، اگر ورودی شما «مبدأ: لس‌آنجلس؛ ایستگاه‌های بین راهی: دالاس، بنگور، فینیکس؛ مقصد: نیویورک» باشد و ترتیب بهینه ایستگاه‌های بین راهی فینیکس، دالاس، بنگور باشد، این فیلد حاوی مقادیر [۲، ۰، ۱] خواهد بود. نمایه با ۰ برای اولین ایستگاه بین راهی ارائه‌شده در ورودی شروع می‌شود.
localizedValues

object (RouteLocalizedValues)

نمایش‌های نوشتاری از ویژگی‌های Route.
routeToken

string

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

توجه: Route.route_token فقط برای درخواست‌هایی دردسترس است که ComputeRoutesRequest.routing_preference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کرده‌اند. ‫Route.route_token برای درخواست‌هایی که ایستگاه‌های بین راهی «ازطریق» دارند پشتیبانی نمی‌شود.
polylineDetails

object (PolylineDetails)

حاوی اطلاعاتی درباره جزئیات درطول چندخطی است.

RouteLabel

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

شمارشی‌ها
ROUTE_LABEL_UNSPECIFIED پیش‌فرض - استفاده نمی‌شود.
DEFAULT_ROUTE مسیر «بهترین» پیش‌فرض برای محاسبات مسیر برگردانده شد.
DEFAULT_ROUTE_ALTERNATE جایگزینی برای مسیر «بهترین» پیش‌فرض. وقتی computeAlternativeRoutes مشخص شود، مسیرهایی مثل این برگردانده خواهد شد.
FUEL_EFFICIENT مسیر با بهره‌وری سوخت. مسیرهایی که با این مقدار برچسب‌گذاری شده‌اند به‌عنوان مسیرهای بهینه‌شده برای پارامترهای «اکو» مثل مصرف سوخت تعیین می‌شوند.
SHORTER_DISTANCE مسیر با فاصله سفر کوتاه‌تر. این قابلیتی آزمایشی است.

RouteLeg

شامل بخشی بین via ایستگاه بین راهی است.

نمایش JSON 
{
  "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)
  }
}
فیلدها
distanceMeters

integer

مسافت سفر بخش مسیر، به متر.
duration

string (Duration format)

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

مدت زمان به ثانیه با حداکثر نه رقم اعشاری، که با «s» پایان می‌یابد. مثال: "3.5s".
staticDuration

string (Duration format)

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

مدت زمان به ثانیه با حداکثر نه رقم اعشاری، که با «s» پایان می‌یابد. مثال: "3.5s".
polyline

object (Polyline)

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

object (Location)

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

object (Location)

مکان پایان این بخش. این مکان ممکن است با destination ارائه‌شده متفاوت باشد. برای مثال، وقتی destination ارائه‌شده نزدیک جاده نباشد، این نقطه روی جاده است.
steps[]

object (RouteLegStep)

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

object (RouteLegTravelAdvisory)

حاوی اطلاعات تکمیلی است که کاربر باید درباره آن مطلع شود، مثلاً محدودیت‌های احتمالی منطقه ترافیکی در بخشی از مسیر.
localizedValues

object (RouteLegLocalizedValues)

نمایش‌های نوشتاری از ویژگی‌های RouteLeg.
stepsOverview

object (StepsOverview)

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

چندخطی

چندخطی کدبندی‌شده را دربرمی‌گیرد.

نمایش JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of mutually exclusive fields.
}
فیلدها
نوع چندخطی را دربرمی‌گیرد. به‌طور پیش‌فرض روی encoded_polyline تنظیم می‌شود. فهرست زیر شامل فیلدهای متقابلاً انحصاری است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
encodedPolyline

string

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

object (Struct format)

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

RouteLegStep

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

نمایش JSON 
{
  "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)
}
فیلدها
distanceMeters

integer

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

string (Duration format)

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

مدت زمان به ثانیه با حداکثر نه رقم اعشاری، که با «s» پایان می‌یابد. مثال: "3.5s".
polyline

object (Polyline)

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

object (Location)

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

object (Location)

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

object (NavigationInstruction)

دستورالعمل‌های پیمایش.
travelAdvisory

object (RouteLegStepTravelAdvisory)

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

object (RouteLegStepLocalizedValues)

نمایش‌های نوشتاری از ویژگی‌های RouteLegStep.
transitDetails

object (RouteLegStepTransitDetails)

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

enum (RouteTravelMode)

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

مانور

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

شمارشی‌ها
MANEUVER_UNSPECIFIED استفاده‌نشده.
TURN_SLIGHT_LEFT کمی به چپ بپیچید.
TURN_SHARP_LEFT با گردش تندی به چپ بپیچید.
UTURN_LEFT دوران به چپ بزنید.
TURN_LEFT به‌چپ بپیچید.
TURN_SLIGHT_RIGHT کمی به راست بپیچید.
TURN_SHARP_RIGHT با گردش تندی به راست بپیچید.
UTURN_RIGHT دوران به راست بزنید.
TURN_RIGHT به‌راست بپیچید.
STRAIGHT مستقیم بروید.
RAMP_LEFT وارد کنارگذر سمت چپ شوید.
RAMP_RIGHT وارد کنارگذر راست شوید.
MERGE ادغام در ترافیک.
FORK_LEFT در دوراهی به چپ بپیچید.
FORK_RIGHT در دوراهی به‌راست بپیچید.
FERRY با کشتی مسافربری بروید.
FERRY_TRAIN با قطاری که به کشتی می‌رود سفر کنید.
ROUNDABOUT_LEFT در میدان، به چپ بپیچید.
ROUNDABOUT_RIGHT در میدان، به راست بپیچید.
DEPART مانور اولیه.
NAME_CHANGE برای نشان دادن تغییر نام خیابان استفاده می‌شود.
DESTINATION برای نشان دادن رسیدن به مقصد استفاده می‌شود.

RouteLegStepTravelAdvisory

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

نمایش JSON 
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
فیلدها
speedReadingIntervals[]

object (SpeedReadingInterval)

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

RouteLegStepLocalizedValues

نمایش نوشتاری برخی‌از دارایی‌ها.

نمایش JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
فیلدها
distance

object (LocalizedText)

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

object (LocalizedText)

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

RouteLegStepTransitDetails

اطلاعات تکمیلی برای RouteLegStep مربوط به TRANSIT مسیر.

نمایش JSON 
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
فیلدها
stopDetails

object (TransitStopDetails)

اطلاعات مربوط به ایستگاه‌های ورود و خروج برای این مرحله.
localizedValues

object (TransitDetailsLocalizedValues)

نمایش‌های نوشتاری از ویژگی‌های RouteLegStepTransitDetails.
headsign

string

جهت سفر در این خط را همان‌گونه که روی وسیله نقلیه یا در ایستگاه مبدأ علامت‌گذاری شده است مشخص می‌کند. جهت اغلب ایستگاه پایانی است.
headway

string (Duration format)

زمان موردانتظار را به‌عنوان مدت بین خروج از یک ایستگاه در این زمان مشخص می‌کند. برای مثال، با مقدار ثانیه سرخط ۶۰۰، اگر به اتوبوس نرسیدید، باید ۱۰ دقیقه منتظر بمانید.

مدت زمان به ثانیه با حداکثر نه رقم اعشاری، که با «s» پایان می‌یابد. مثال: "3.5s".
transitLine

object (TransitLine)

اطلاعات مربوط به خط حمل‌ونقل عمومی که در این مرحله استفاده شده است.
stopCount

integer

تعداد توقف‌ها از ایستگاه مبدأ تا ایستگاه مقصد. این تعداد شامل ایستگاه رسیدن می‌شود، اما ایستگاه حرکت را دربرنمی‌گیرد. برای مثال، اگر مسیر شما از «ایستگاه A» شروع شود، از «ایستگاه B» و «ایستگاه C» عبور کند، و به «ایستگاه D» برسد، stopCount مقدار ۳ را برمی‌گرداند.
tripShortText

string

نوشتاری که در زمان‌بندی‌ها و تابلوهای راهنما نشان داده می‌شود تا سفر با حمل‌ونقل عمومی را به مسافران معرفی کند. نوشتار باید سفر را در روز خدمات به‌طور منحصربه‌فردی شناسایی کند. برای مثال، «۵۳۸» tripShortText قطار Amtrak است که در روزهای هفته ساعت ۱۵:۱۰ از سن‌خوزه، کالیفرنیا، به مقصد ساکرامنتو، کالیفرنیا، حرکت می‌کند.

TransitStopDetails

جزئیات مربوط به ایستگاه‌های حمل‌ونقل عمومی برای RouteLegStep.

نمایش JSON 
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
فیلدها
arrivalStop

object (TransitStop)

اطلاعات مربوط به ایستگاه مقصد برای مرحله.
arrivalTime

string (Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن برونداد تولیدشده همیشه Z-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم کسری استفاده می‌کند. انحراف‌های غیر از «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".
departureStop

object (TransitStop)

اطلاعات درباره ایستگاه حرکت برای مرحله.
departureTime

string (Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن برونداد تولیدشده همیشه Z-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم کسری استفاده می‌کند. انحراف‌های غیر از «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".

TransitStop

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

نمایش JSON 
{
  "name": string,
  "location": {
    object (Location)
  }
}
فیلدها
name

string

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

object (Location)

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

TransitDetailsLocalizedValues

شرح‌های بومی‌سازی‌شده مقادیر برای RouteTransitDetails.

نمایش JSON 
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
فیلدها
arrivalTime

object (LocalizedTime)

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

object (LocalizedTime)

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

LocalizedTime

شرح بومی‌سازی‌شده زمان.

نمایش JSON 
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
فیلدها
time

object (LocalizedText)

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

string

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

TransitLine

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

نمایش JSON 
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
فیلدها
agencies[]

object (TransitAgency)

دفتر (یا دفاتر) حمل‌ونقل عمومی که این خط حمل‌ونقل عمومی را اداره می‌کند.
name

string

نام کامل این خط حمل‌ونقل عمومی، برای مثال، «8 Avenue Local».
uri

string

‫URI این خط حمل‌ونقل عمومی که توسط دفتر حمل‌ونقل عمومی ارائه شده است.
color

string

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

string

نشانی وب نماد مرتبط با این خط.
nameShort

string

نام کوتاه این خط حمل‌ونقل عمومی. این نام معمولاً شماره خط است، مثلاً «M7» یا «355».
textColor

string

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

object (TransitVehicle)

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

TransitAgency

دفتر حمل‌ونقل عمومی که خط حمل‌ونقل عمومی را اداره می‌کند.

نمایش JSON 
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
فیلدها
name

string

نام این دفتر حمل‌ونقل عمومی.
phoneNumber

string

شماره تلفن قالب‌بندی‌شده مختص زبان محلی کارگزاری حمل‌ونقل عمومی.
uri

string

نشانی وب دفتر حمل‌ونقل عمومی.

TransitVehicle

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

نمایش JSON 
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
فیلدها
name

object (LocalizedText)

نام این خودرو، با حروف بزرگ.
type

enum (TransitVehicleType)

نوع وسیله نقلیه استفاده‌شده.
iconUri

string

نشانی وب نماد مربوط به این نوع خودرو.
localIconUri

string

نشانی وب نماد منسوب به این نوع خودرو، براساس علائم راهنمایی و رانندگی حمل‌ونقل محلی.

TransitVehicleType

نوع وسایل نقلیه برای مسیرهای حمل‌ونقل عمومی.

شمارشی‌ها
TRANSIT_VEHICLE_TYPE_UNSPECIFIED استفاده‌نشده.
BUS اتوبوس.
CABLE_CAR وسیله نقلیه‌ای که با کابل کار می‌کند، معمولاً روی زمین. تله‌کابین‌های هوایی ممکن است از نوع GONDOLA_LIFT باشند.
COMMUTER_TRAIN قطار حومه‌ای.
FERRY کشتی.
FUNICULAR وسیله نقلیه‌ای که با کابل از شیب تند بالا کشیده می‌شود. یک قطار کابلی معمولاً از دو واگن تشکیل شده است که هر واگن به‌عنوان یک وزنه تعادل برای واگن دیگر عمل می‌کند.
GONDOLA_LIFT تله‌کابین هوایی.
HEAVY_RAIL ریل سنگین.
HIGH_SPEED_TRAIN قطار پرسرعت.
INTERCITY_BUS اتوبوس بین‌شهری.
LONG_DISTANCE_TRAIN قطار راه دور.
METRO_RAIL حمل‌ونقل با قطار شهری.
MONORAIL مونوریل.
OTHER همه وسایل نقلیه دیگر.
RAIL راه‌آهن.
SHARE_TAXI تاکسی اشتراکی نوعی اتوبوس است که می‌تواند مسافران را در هر جایی از مسیرش پیاده و سوار کند.
SUBWAY قطار شهری زیرزمینی.
TRAM قطار شهری روی زمین.
TROLLEYBUS اتوبوس برقی.

RouteLegTravelAdvisory

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

نمایش JSON 
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
فیلدها
tollInfo

object (TollInfo)

حاوی اطلاعاتی درباره عوارض در RouteLeg خاص است. این فیلد فقط درصورتی تکمیل می‌شود که انتظار داشته باشیم در RouteLeg عوارضی وجود داشته باشد و TOLLS در ComputeRoutesRequest.extra_computations درخواست گنجانده شده باشد. اگر این فیلد تنظیم شده باشد اما فیلد فرعی estimatedPrice تکمیل نشده باشد، انتظار داریم که این جاده عوارض داشته باشد اما قیمت تخمینی آن را نمی‌دانیم. اگر tollInfo وجود نداشته باشد، در RouteLeg عوارضی وجود ندارد.
speedReadingIntervals[]

object (SpeedReadingInterval)

فاصله‌های خواندن سریع که نشان‌دهنده تراکم ترافیک است. این فیلد فقط برای درخواست‌هایی تکمیل می‌شود که درخواست دارای مقدار TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference باشد و TRAFFIC_ON_POLYLINE در ComputeRoutesRequest.extra_computations گنجانده شده باشد. فاصله‌ها کل چندخطی RouteLeg را بدون هم‌پوشانی پوشش می‌دهد. نقطه شروع یک بازه مشخص با نقطه پایان بازه قبلی یکسان است.

مثال:

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

RouteLegLocalizedValues

نمایش نوشتاری برخی‌از دارایی‌ها.

نمایش JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
فیلدها
distance

object (LocalizedText)

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

object (LocalizedText)

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

object (LocalizedText)

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

StepsOverview

اطلاعات کلی درباره فهرست RouteLegStep ارائه می‌دهد.

نمایش JSON 
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
فیلدها
multiModalSegments[]

object (MultiModalSegment)

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

MultiModalSegment

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

نمایش JSON 
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
فیلدها
navigationInstruction

object (NavigationInstruction)

NavigationInstruction برای بخش چندحالته.
travelMode

enum (RouteTravelMode)

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

integer

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

integer

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

ناحیه نمایش

یک درگاه دید طول و عرض جغرافیایی که به‌صورت دو نقطه low و high در مقابل هم نشان داده می‌شود. ناحیه نمایش به‌عنوان یک منطقه بسته درنظر گرفته می‌شود، یعنی مرزهای آن را دربرمی‌گیرد. محدوده عرض جغرافیایی باید بین ۹۰- تا ۹۰ درجه شامل، و محدوده طول جغرافیایی باید بین ۱۸۰- تا ۱۸۰ درجه شامل باشد. موارد مختلف شامل:

  • اگر low = high، ناحیه نمایش از آن نقطه واحد تشکیل می‌شود.

  • اگر low.longitude > high.longitude، محدوده طول جغرافیایی معکوس می‌شود (ناحیه نمایش از خط طول جغرافیایی ۱۸۰ درجه عبور می‌کند).

  • اگر low.longitude = -۱۸۰ درجه و high.longitude = ۱۸۰ درجه باشد، درگاه دید همه طول‌های جغرافیایی را دربرمی‌گیرد.

  • اگر low.longitude = ۱۸۰ درجه و high.longitude = -۱۸۰ درجه، محدوده طول جغرافیایی خالی است.

  • اگر low.latitude > high.latitude، محدوده عرض جغرافیایی خالی است.

هم low و هم high باید تکمیل شوند و چارگوش نشان‌داده‌شده نمی‌تواند خالی باشد (طبق تعاریف بالا). درصورت خالی بودن درگاه نمایش، خطا رخ خواهد داد.

برای مثال، این درگاه دید کاملاً شهر نیویورک را دربرمی‌گیرد:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

نمایش JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
فیلدها
low

object (LatLng)

الزامی. نقطه پایین ناحیه نمایش.
high

object (LatLng)

الزامی. نقطه بالای ناحیه نمایش.

RouteLocalizedValues

نمایش نوشتاری برخی‌از دارایی‌ها.

نمایش JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
فیلدها
distance

object (LocalizedText)

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

object (LocalizedText)

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

object (LocalizedText)

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

object (LocalizedText)

نرخ حمل‌ونقل عمومی به‌صورت نوشتاری نشان داده می‌شود.

PolylineDetails

جزئیات مربوط به شاخص یا بخش پیوسته چندخطی. با درنظر گرفتن چندخطی با نقاط P_0،‏ P_1،‏ ...،‏ P_N (شاخص مبنا صفر)، PolylineDetails بازه و فراداده مرتبط را تعریف می‌کند.

نمایش JSON 
{
  "tunnelInfo": [
    {
      object (TunnelInfo)
    }
  ],
  "restrictionInfo": [
    {
      object (RestrictionInfo)
    }
  ],
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ],
  "bridgeInfo": [
    {
      object (BridgeInfo)
    }
  ],
  "skywayInfo": [
    {
      object (SkywayInfo)
    }
  ]
}
فیلدها
tunnelInfo[]

object (TunnelInfo)

جزئیات تونل درطول چندخطی. اگر درخواست اصلاح‌کننده مسیر avoidTunnels را مشخص کند و مسیر حاصل نتواند از آن اجتناب کند، یا اگر TUNNEL_INFO_ON_POLYLINE در extraComputations مشخص شده باشد و مسیر شامل تونل باشد، این فیلد تکمیل می‌شود.
restrictionInfo[]

object (RestrictionInfo)

جزئیات محدودیت درطول چندخطی. این فیلد فقط درصورتی تکمیل می‌شود که درخواستی اصلاح‌کننده مسیر vehicleInfo را مشخص کند و مسیر حاصل حاوی محدودیت قابل‌اعمال باشد. درغیراین‌صورت، از این فیلد استفاده نمی‌شود.
flyoverInfo[]

object (FlyoverInfo)

جزئیات پرواز نمای نزدیک درطول چندخطی.
narrowRoadInfo[]

object (NarrowRoadInfo)

جزئیات جاده باریک درطول چندخطی.
bridgeInfo[]

object (BridgeInfo)

جزئیات پل درطول چندخطی.
skywayInfo[]

object (SkywayInfo)

جزئیات پل هوایی درطول چندخطی.

TunnelInfo

اطلاعات مربوط به تونل‌ها را درطول چندخطی خلاصه می‌کند.

نمایش JSON 
{
  "tunnelPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
فیلدها
tunnelPresence

enum (RoadFeatureState)

نشان می‌دهد که آیا برای بخش معینی از چندخطی تونل وجود دارد یا نه.
polylinePointIndex

object (PolylinePointIndex)

مکان اطلاعات مربوط به تونل در امتداد چندخطی.

RoadFeatureState

وضعیت‌های عوارض جاده‌ای را در امتداد یک بخش از چندخطی دربرمی‌گیرد.

شمارشی‌ها
ROAD_FEATURE_STATE_UNSPECIFIED وضعیت عارضه جاده محاسبه نشد (مقدار پیش‌فرض).
EXISTS عنصر جاده وجود دارد.
DOES_NOT_EXIST ویژگی جاده وجود ندارد.

PolylinePointIndex

شاخص‌های شروع و پایان را برای جزئیات چندخطی دربرمی‌گیرد. برای مواردی که داده‌ها مربوط به یک نقطه واحد است، startIndex و endIndex برابر خواهند بود.

نمایش JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
فیلدها
startIndex

integer

نمایه شروع این جزئیات در چندخطی.
endIndex

integer

نمایه پایانی این جزئیات در چندخطی.

RestrictionInfo

اطلاعات مربوط به محدودیت‌های مختلف درطول چندخطی را دربرمی‌گیرد.

نمایش JSON 
{
  "restrictionPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "restrictedHeightMm": string,
  "restrictedWeightKg": string,
  "hazardousGoods": boolean,
  "trucksProhibited": boolean
  // End of mutually exclusive fields.
}
فیلدها
restrictionPresence

enum (RoadFeatureState)

فقط برونداد. نشان می‌دهد که آیا برای بخش معینی از چندخطی محدودیت وجود دارد یا خیر.
polylinePointIndex

object (PolylinePointIndex)

مکان اطلاعات مربوط به محدودیت درطول چندخطی.
انواع محدودیت‌هایی را که می‌توانند برای یک بخش معین از چندخطی اعمال شوند دربرمی‌گیرد. فهرست زیر شامل فیلدهای متقابلاً انحصاری است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
restrictedHeightMm

string (int64 format)

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

string (int64 format)

محدودیت وزن، به کیلوگرم. وقتی محدودیت وزن مانع عبور می‌شود یا به وزن خودرو مشخص‌شده نزدیک است، این فیلد تکمیل می‌شود.
hazardousGoods

boolean

وقتی حمل کالاهای خطرناک محدود می‌شود، این فیلد روی درست تنظیم می‌شود.
trucksProhibited

boolean

وقتی کامیون‌ها ممنوع باشند، این فیلد روی درست تنظیم می‌شود.
پایان فیلدهای متقابلاً انحصاری.

FlyoverInfo

اطلاعات مربوط به پروازهای عبوری درطول چندخطی را دربرمی‌گیرد.

نمایش JSON 
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
فیلدها
flyoverPresence

enum (RoadFeatureState)

فقط برونداد. نشان می‌دهد که آیا برای بخش معینی از چندخط پرواز نمایشی وجود دارد یا نه.
polylinePointIndex

object (PolylinePointIndex)

مکان اطلاعات مربوط به پرواز بر فراز در امتداد چندخطی.

NarrowRoadInfo

اطلاعات مربوط به جاده‌های باریک درطول چندخطی را دربرمی‌گیرد.

نمایش JSON 
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
فیلدها
narrowRoadPresence

enum (RoadFeatureState)

فقط برونداد. نشان می‌دهد که آیا جاده باریکی برای بخش معینی از چندخط وجود دارد یا خیر.
polylinePointIndex

object (PolylinePointIndex)

مکان اطلاعات مربوط به جاده باریک درطول چندخطی.

BridgeInfo

اطلاعات مربوط به پل‌های طول چندخطی را دربرمی‌گیرد.

نمایش JSON 
{
  "bridgePresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
فیلدها
bridgePresence

enum (RoadFeatureState)

نشان می‌دهد که آیا پلی برای بخش معینی از چندخط وجود دارد یا نه.
polylinePointIndex

object (PolylinePointIndex)

مکان اطلاعات مربوط به پل درطول چندخطی.

SkywayInfo

اطلاعات مربوط به پل‌های هوایی درطول چندخطی را دربرمی‌گیرد.

نمایش JSON 
{
  "skywayPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
فیلدها
skywayPresence

enum (RoadFeatureState)

نشان می‌دهد که آیا برای بخش معینی از چندخطی، پل هوایی وجود دارد یا خیر.
polylinePointIndex

object (PolylinePointIndex)

مکان اطلاعات مربوط به پل هوایی درطول چندخطی.

GeocodingResults

حاوی GeocodedWaypoints برای مبدأ، مقصد، و ایستگاه‌های بین راهی است. فقط برای ایستگاه‌های بین راهی نشانی درج می‌شود.

نمایش JSON 
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
فیلدها
origin

object (GeocodedWaypoint)

ایستگاه بین راهی زمین‌کدیابی‌شده مبدأ.
destination

object (GeocodedWaypoint)

ایستگاه بین راهی زمین‌کدیابی‌شده مقصد.
intermediates[]

object (GeocodedWaypoint)

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

GeocodedWaypoint

جزئیات مربوط به مکان‌هایی که به‌عنوان ایستگاه بین راهی استفاده شده‌اند. فقط برای ایستگاه‌های بین راهی نشانی درج می‌شود. شامل جزئیاتی درباره نتایج زمین‌کدی برای تعیین اینکه نشانی به چه چیزی زمین‌کد شده است.

نمایش JSON 
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
فیلدها
geocoderStatus

object (Status)

کد وضعیت حاصل از عملیات زمین‌کدیابی را نشان می‌دهد.
type[]

string

نوع(های) نتیجه، در قالب صفر یا چند برچسب نوع. انواع پشتیبانی‌شده: انواع نشانی و انواع عنصر نشانی.
partialMatch

boolean

نشان می‌دهد که کدبند جغرافیایی برای درخواست اصلی مطابقت دقیقی برنگردانده است، هرچند توانسته است بخشی از نشانی درخواستی را مطابقت دهد. بهتر است درخواست اصلی را ازنظر غلط املایی و/یا نشانی ناقص بررسی کنید.
placeId

string

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

integer

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