Method: computeRoutes

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

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

مثلاً در این روش:

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

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

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

درخواست HTTP

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

این URL از سینتکس Transcoding در 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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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". برای اطلاعات بیشتر، به شناسه محلی یونیکد مراجعه کنید. برای لیست زبان‌های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی‌دهید، زبان نمایش از محل درخواست مسیر استنباط می‌شود.

regionCode

string

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

units

enum ( Units )

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

optimizeWaypointOrder

boolean

اختیاری. اگر روی true تنظیم شود، سرویس تلاش می‌کند با مرتب‌سازی مجدد نقاط مسیر میانی مشخص‌شده، هزینه کلی مسیر را به حداقل برساند. اگر هر یک از نقاط مسیر میانی، یک نقطه مسیر از نوع via باشد، درخواست با شکست مواجه می‌شود. برای یافتن ترتیب جدید از ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index استفاده کنید. اگر ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index در هدر X-Goog-FieldMask درخواست نشده باشد، درخواست با شکست مواجه می‌شود. اگر optimizeWaypointOrder روی false تنظیم شود، 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 )

حاوی اطلاعات پاسخ ژئوکدینگ برای نقاط مسیر مشخص شده به عنوان آدرس است.

کیفیت چندخطی

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

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

رمزگذاری چندخطی

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

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

مسیر مرجع

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

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

مسیری با مسافت سفر کوتاه‌تر. این یک ویژگی آزمایشی است.

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

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

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

محاسبات اضافی

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

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

مسیر

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

نمایش 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 تنظیم کنید، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می‌شود.

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

localizedValues

object ( RouteLocalizedValues )

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

routeToken

string

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

نکته: Route.route_token فقط برای درخواست‌هایی در دسترس است که ComputeRoutesRequest.routing_preference روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کرده‌اند. Route.route_token برای درخواست‌هایی که دارای نقاط مسیر Via هستند پشتیبانی نمی‌شود.

polylineDetails

object ( PolylineDetails )

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

برچسب مسیر

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

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

مسیر

شامل بخشی بین نقاط مسیر غیر 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 . این فیلد فقط برای مسیرهای TRANSIT پر می‌شود.

پلی‌لاین

یک چندخطی کدگذاری شده را کپسوله سازی می کند.

نمایش JSON 
{

  // 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.
}
فیلدها
فیلد Union polyline_type . نوع چندخطی را کپسوله‌سازی می‌کند. مقدار پیش‌فرض آن encoded_polyline است. polyline_type فقط می‌تواند یکی از موارد زیر باشد:
encodedPolyline

string

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

geoJsonLinestring

object ( Struct format)

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

مسیرقدم

شامل بخشی از یک RouteLeg است. یک مرحله (step) مربوط به یک دستورالعمل ناوبری واحد است. شاخه‌های مسیر (routeleg) از مراحل (steps) تشکیل شده‌اند.

نمایش 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 برای نشان دادن تغییر نام خیابان استفاده می‌شود.

مشاوره سفر RouteLegStep

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

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

object ( SpeedReadingInterval )

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

مقادیر محلی‌شده‌ی مسیر (RouteLegStep)

نمایش متنی ویژگی‌های خاص.

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

object ( LocalizedText )

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

staticDuration

object ( LocalizedText )

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

جزئیات مسیر و گام

اطلاعات تکمیلی برای 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

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

جزئیات ایستگاه حمل و نقل

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

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

object ( TransitStop )

اطلاعات مربوط به ایستگاه ورود برای پله.

arrivalTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

ترانزیت‌استاپ

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

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

string

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

location

object ( Location )

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

جزئیات حمل و نقلمقادیر محلی

توضیحات محلی از مقادیر برای RouteTransitDetails .

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

object ( LocalizedTime )

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

departureTime

object ( LocalizedTime )

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

زمان محلی

توصیف محلی از زمان.

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

object ( LocalizedText )

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

timeZone

string

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

خط ترانزیت

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

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

object ( TransitAgency )

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

name

string

نام کامل این خط حمل و نقل عمومی، مثلاً «خطوط محلی خیابان هشتم».

uri

string

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

color

string

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

iconUri

string

آدرس اینترنتی (URI) مربوط به آیکون مرتبط با این خط.

nameShort

string

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

textColor

string

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

vehicle

object ( TransitVehicle )

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

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

یک آژانس حمل و نقل که یک خط حمل و نقل را اداره می‌کند.

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

string

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

phoneNumber

string

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

uri

string

آدرس اینترنتی (URI) آژانس حمل و نقل عمومی.

وسیله نقلیه ترانزیتی

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

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

object ( LocalizedText )

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

type

enum ( TransitVehicleType )

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

iconUri

string

آدرس اینترنتی (URI) برای یک آیکون مرتبط با این نوع وسیله نقلیه.

localIconUri

string

آدرس اینترنتی (URI) مربوط به آیکون مرتبط با این نوع وسیله نقلیه، بر اساس تابلوهای حمل و نقل محلی.

نوع وسیله نقلیه ترانزیت

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

انوم‌ها
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 اتوبوس برقی.

مشاوره سفر RouteLeg

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

نمایش 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 )

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

مراحلبررسی اجمالی

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

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

object ( MultiModalSegment )

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

چندبخشی

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

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

object ( NavigationInstruction )

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

travelMode

enum ( RouteTravelMode )

شیوه سفر در بخش چندوجهی.

stepStartIndex

integer

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

stepEndIndex

integer

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

ویوپورت

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

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

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

  • اگر low.longitude = -180 درجه و high.longitude = 180 درجه باشد، صفحه نمایش شامل تمام طول‌های جغرافیایی می‌شود.

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

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

هر دو low و high باید پر شوند و کادر نمایش داده شده نمی‌تواند خالی باشد (همانطور که در تعاریف بالا مشخص شده است). یک viewport خالی منجر به خطا خواهد شد.

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

{ "کم": { "عرض جغرافیایی": ۴۰.۴۷۷۳۹۸، "طول جغرافیایی": -۷۴.۲۵۹۰۸۷ }، "زیاد": { "عرض جغرافیایی": ۴۰.۹۱۶۱۸، "طول جغرافیایی": -۷۳.۷۰۰۱۸ } }

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

object ( LatLng )

الزامی. نقطه پایین دید.

high

object ( LatLng )

الزامی. نقطه اوج منظره.

مقادیر محلی مسیر

نمایش متنی ویژگی‌های خاص.

نمایش 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 )

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

جزئیات چندخطی

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

نمایش JSON 
{
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ]
}
فیلدها
flyoverInfo[]

object ( FlyoverInfo )

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

narrowRoadInfo[]

object ( NarrowRoadInfo )

جزئیات جاده باریک در امتداد پلی‌لاین.

اطلاعات پرواز

اطلاعات مربوط به پل‌های هوایی در امتداد پلی‌لاین را کپسوله‌سازی می‌کند.

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

enum ( RoadFeatureState )

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

polylinePointIndex

object ( PolylinePointIndex )

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

وضعیت جاده

حالت‌های ویژگی‌های جاده را در امتداد یک چندخطی محصور می‌کند.

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

PolylinePointIndex

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

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

integer

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

endIndex

integer

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

اطلاعات جاده باریک

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

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

enum ( RoadFeatureState )

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

polylinePointIndex

object ( PolylinePointIndex )

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

نتایج کدگذاری جغرافیایی

شامل GeocodedWaypoints برای نقاط مسیر مبدا، مقصد و میانی است. فقط برای نقاط مسیر آدرس‌دار پر می‌شود.

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

object ( GeocodedWaypoint )

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

destination

object ( GeocodedWaypoint )

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

intermediates[]

object ( GeocodedWaypoint )

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

نقطه مسیر جغرافیایی

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

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

object ( Status )

کد وضعیت حاصل از عملیات ژئوکدینگ را نشان می‌دهد.

type[]

string

نوع(های) نتیجه، به شکل صفر یا چند برچسب نوع. انواع پشتیبانی شده: انواع آدرس و انواع مؤلفه آدرس .

partialMatch

boolean

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

placeId

string

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

intermediateWaypointRequestIndex

integer

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