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 مشخص شود. این داده‌ها درحال‌حاضر فقط برای برخی‌از شهرهای هند پر می‌شود. این ویژگی آزمایشی است و SKU/هزینه ممکن است تغییر کند.
NARROW_ROAD_INFO_ON_POLYLINE اطلاعات جاده باریک برای مسیر(ها). برای برگرداندن این اطلاعات، باید ماسک فیلد routes.polyline_details.narrow_road_info مشخص شود. این داده‌ها درحال‌حاضر فقط برای برخی‌از شهرهای هند پر می‌شود. این ویژگی آزمایشی است و SKU/هزینه ممکن است تغییر کند.
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)

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

distanceMeters

integer

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

duration

string (Duration format)

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

وقتی routingPreference روی TRAFFIC_AWARE_OPTIMAL تنظیم شده باشد، مدت‌زمان بااستفاده از سرعت خودروهای سواری یا سرعت کامیون‌ها (مدت‌زمان‌های طولانی‌تر) محاسبه می‌شود. اگر یکی از شرایط زیر درست باشد، از سرعت کامیون استفاده می‌شود:

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

مدت‌زمان به ثانیه با حداکثر نه رقم اعشار، که به «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 را روی درست تنظیم کنید، این فیلد حاوی ترتیب بهینه‌شده نقاط‌مسیر میانی است. درغیراین‌صورت، این فیلد خالی است. برای مثال، اگر ورودی شما «مبدأ: لس‌آنجلس»، «نقاط‌مسیر میانی: دالاس، بنگور، فینیکس»، و «مقصد: نیویورک» باشد و ترتیب بهینه‌شده نقاط‌مسیر میانی «فینیکس، دالاس، بنگور» باشد، این فیلد حاوی مقادیر [‎2, 0, 1] خواهد بود. نمایه با ۰ برای اولین نقطه‌مسیر میانی ارائه‌شده در ورودی شروع می‌شود.

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)

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

وقتی routingPreference روی TRAFFIC_AWARE_OPTIMAL تنظیم شده باشد، مدت‌زمان بااستفاده از سرعت خودروهای سواری یا سرعت کامیون‌ها (مدت‌زمان‌های طولانی‌تر) محاسبه می‌شود. اگر یکی از شرایط زیر درست باشد، از سرعت کامیون استفاده می‌شود:

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

مدت‌زمان به ثانیه با حداکثر نه رقم اعشار، که به «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

تعداد توقف‌ها از ایستگاه مبدأ تا ایستگاه مقصد. این تعداد شامل ایستگاه مقصد می‌شود، اما ایستگاه مبدأ را دربرنمی‌گیرد. برای مثال، اگر مسیرتان از ایستگاه الف شروع شود، از ایستگاه‌های ب و پ عبور کند، و به ایستگاه ت برسد، 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

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

color

string

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

iconUri

string

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

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

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