Method: computeRoutes

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

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

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

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

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

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

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

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

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

travelMode

enum ( RouteTravelMode )

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

routingPreference

enum ( RoutingPreference )

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

polylineQuality

enum ( PolylineQuality )

اختیاری. ترجیح شما را برای کیفیت پلی لاین مشخص می کند.

polylineEncoding

enum ( PolylineEncoding )

اختیاری. رمزگذاری ترجیحی برای چند خط را مشخص می کند.

departureTime

string ( Timestamp format)

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

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "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 را مشخص کنید، اما نه هر دو را. سفرهای ترانزیت تا 7 روز در گذشته یا 100 روز در آینده در دسترس هستند.

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "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 تأثیر می گذارد. توجه: زمانی که RouteTravelMode روی TRANSIT تنظیم شده باشد، می توانید یک transitPreferences مشخص کنید.

بدن پاسخگو

v2.compute پیام پاسخ را مسیریابی می کند.

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

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

object ( Route )

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

fallbackInfo

object ( FallbackInfo )

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

geocodingResults

object ( GeocodingResults )

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

کیفیت پلی لاین

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

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

PolylineEncoding

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

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

ReferenceRoute

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

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

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

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

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

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

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

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

Enums
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 تنظیم کنید، این فیلد شامل ترتیب بهینه شده نقاط بین راهی است. در غیر این صورت این قسمت خالی است. برای مثال، اگر ورودی Origin را بدهید: LA; ایستگاه های بین راهی: دالاس، بانگور، فینیکس؛ مقصد: نیویورک؛ و ترتیب میانی بهینه شده Phoenix، Dallas، Bangor است، سپس این فیلد حاوی مقادیر [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 برای درخواست هایی که دارای ایستگاه های بین راه هستند پشتیبانی نمی شود.

polylineDetails

object ( PolylineDetails )

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

RouteLabel

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

Enums
ROUTE_LABEL_UNSPECIFIED پیش فرض - استفاده نشده است.
DEFAULT_ROUTE مسیر پیش‌فرض "بهترین" برای محاسبه مسیر برگردانده شد.
DEFAULT_ROUTE_ALTERNATE جایگزینی برای مسیر پیش‌فرض "بهترین" زمانی که computeAlternativeRoutes مشخص شده باشد، مسیرهایی مانند این برگردانده می شوند.
FUEL_EFFICIENT مسیر مصرف سوخت مسیرهایی که با این مقدار برچسب گذاری شده اند برای پارامترهای Eco مانند مصرف سوخت بهینه شده اند.
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 . این قسمت فقط برای مسیرهای 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.
}
فیلدها
فیلد اتحادیه polyline_type . نوع پلی لاین را کپسوله می کند. پیش‌فرض encoded_polyline است. polyline_type می تواند تنها یکی از موارد زیر باشد:
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 )

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

مانور

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

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

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)

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

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

transitLine

object ( TransitLine )

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

stopCount

integer

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

stopCount

برمی گرداند 3.

tripShortText

string

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

TransitStopDetails

جزئیات در مورد توقف های حمل و نقل برای RouteLegStep .

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

object ( TransitStop )

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

arrivalTime

string ( Timestamp format)

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

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "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 نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "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".

ترانزیت لاین

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

نمایندگی 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

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 VehicleType

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

Enums
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 وجود داشته باشد. اگر این فیلد تنظیم شده باشد اما زیرفیلد برآورد شده قیمت پر نشده باشد، انتظار داریم که جاده شامل عوارض باشد اما قیمت تخمینی را نمی دانیم. اگر این فیلد وجود نداشته باشد، هیچ عوارضی در RouteLeg وجود ندارد.

speedReadingIntervals[]

object ( SpeedReadingInterval )

فواصل تندخوانی با جزئیات تراکم ترافیک. قابل اجرا در موارد ترجیحات مسیریابی TRAFFIC_AWARE و TRAFFIC_AWARE_OPTIMAL . فواصل، کل چند خط 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 )

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

travelMode

enum ( RouteTravelMode )

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

stepStartIndex

integer

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

stepEndIndex

integer

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

درگاه دید

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

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

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

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

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

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

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

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

{ "low": { "Latitude": 40.477398, "Litude": -74.259087 }, "high": { "Latitude": 40.91618, "Latitude": -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 )

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

جزئیات Polyline

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

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

object ( FlyoverInfo )

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

narrowRoadInfo[]

object ( NarrowRoadInfo )

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

FlyoverInfo

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

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

enum ( RoadFeatureState )

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

polylinePointIndex

object ( PolylinePointIndex )

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

RoadFeatureState

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

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

PolylinePointIndex

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

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

integer

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

endIndex

integer

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

NarrowRoadInfo

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

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

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

GeocedWaypoint

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

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

object ( Status )

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

type[]

string

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

partialMatch

boolean

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

placeId

string

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

intermediateWaypointRequestIndex

integer

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

،

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

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

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

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

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

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست شامل داده هایی با ساختار زیر است:

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

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

travelMode

enum ( RouteTravelMode )

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

routingPreference

enum ( RoutingPreference )

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

polylineQuality

enum ( PolylineQuality )

اختیاری. ترجیح شما را برای کیفیت پلی خط مشخص می کند.

polylineEncoding

enum ( PolylineEncoding )

اختیاری. رمزگذاری ترجیحی را برای پلی خط مشخص می کند.

departureTime

string ( Timestamp format)

اختیاری. زمان عزیمت اگر این مقدار را تنظیم نکردید ، این مقدار به زمانی که درخواست را انجام داده اید پیش فرض می شود. توجه: هنگامی که RouteTravelMode روی TRANSIT تنظیم شده است ، می توانید در گذشته یک departureTime مشخص کنید. سفرهای ترانزیت در گذشته یا 100 روز در آینده تا 7 روز در دسترس است.

از RFC 3339 استفاده می کند ، جایی که خروجی تولید شده همیشه z-normalized خواهد بود و از 0 ، 3 ، 6 یا 9 رقم کسری استفاده می کند. جبران های غیر از "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 مشخص کنید ، اما هر دو نیست. سفرهای ترانزیت در گذشته یا 100 روز در آینده تا 7 روز در دسترس است.

از RFC 3339 استفاده می کند ، جایی که خروجی تولید شده همیشه z-normalized خواهد بود و از 0 ، 3 ، 6 یا 9 رقم کسری استفاده می کند. جبران های غیر از "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 استفاده کنید. اگر 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 DRIVE TRAFFIC_AWARE_OPTIMAL و RouteTravelMode تنظیم کرده اند در دسترس است. در صورت درخواست ترافیک به بهترین وجه به BEST_GUESS و TrafficModel مشخص نشده است.

transitPreferences

object ( TransitPreferences )

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

بدن پاسخگو

v2.computeroutes پیام پاسخ.

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

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

object ( Route )

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

fallbackInfo

object ( FallbackInfo )

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

geocodingResults

object ( GeocodingResults )

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

چند خطی

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

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

پرکندرد

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

Enums
POLYLINE_ENCODING_UNSPECIFIED هیچ نوع ترجیح نوع پلی خط مشخص نشده است. پیش فرض به ENCODED_POLYLINE .
ENCODED_POLYLINE با استفاده از الگوریتم رمزگذاری پلی خط ، یک پلی خط رمزگذاری شده را مشخص می کند.
GEO_JSON_LINESTRING با استفاده از قالب Geojson Linestring ، یک پلی خط را مشخص می کند

ارجاع

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

Enums
REFERENCE_ROUTE_UNSPECIFIED استفاده نشده است. درخواست های حاوی این مقدار شکست می خورند.
FUEL_EFFICIENT مسیر کارآمد سوخت.
SHORTER_DISTANCE

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

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

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

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

خارج

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

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

مسیر

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

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

جعبه محدودیت نمای Polyline.

travelAdvisory

object ( RouteTravelAdvisory )

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

optimizedIntermediateWaypointIndex[]

integer

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

localizedValues

object ( RouteLocalizedValues )

بازنمایی متن از خواص Route .

routeToken

string

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

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

polylineDetails

object ( PolylineDetails )

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

روته

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

Enums
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 . این قسمت فقط برای مسیرهای حمل و نقل جمع شده است.

پلی لاین

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

نمایندگی 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 Field polyline_type . نوع پلی خط را محصور می کند. پیش فرض به encoded_polyline. polyline_type فقط می تواند یکی از موارد زیر باشد:
encodedPolyline

string

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

geoJsonLinestring

object ( Struct format)

با استفاده از قالب Geojson Linestring ، یک پلی خط را مشخص می کند.

مسیر

حاوی بخشی از یک 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 )

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

مانور

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

Enums
MANEUVER_UNSPECIFIED استفاده نشده است.
TURN_SLIGHT_LEFT کمی به سمت چپ بپیچید.
TURN_SHARP_LEFT به شدت به سمت چپ بپیچید.
UTURN_LEFT یک چرخش U سمت چپ درست کنید.
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 برای نشان دادن تغییر نام خیابان استفاده می شود.

مسیریابی

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

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

object ( SpeedReadingInterval )

توجه: این قسمت در حال حاضر پر جمعیت نیست.

RoutelegsteplocalizedValues

بازنمایی متن از خصوصیات خاص.

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

object ( LocalizedText )

فاصله سفر به شکل متن نشان داده شده است.

staticDuration

object ( LocalizedText )

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

stelegsteptransitdetails

اطلاعات اضافی برای 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)

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

مدت زمان در ثانیه با حداکثر نه رقم کسری ، که با " s " پایان می یابد. مثال: "3.5s" .

transitLine

object ( TransitLine )

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

stopCount

integer

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

stopCount

بازگشت 3.

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 خواهد بود و از 0 ، 3 ، 6 یا 9 رقم کسری استفاده می کند. جبران های غیر از "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 خواهد بود و از 0 ، 3 ، 6 یا 9 رقم کسری استفاده می کند. جبران های غیر از "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 )

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

TransitDetailSlocalizedValues

توضیحات بومی شده از مقادیر برای 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

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

uri

string

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

color

string

رنگی که معمولاً در این علائم در علائم استفاده می شود. در hexadecimal نماینده است.

iconUri

string

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

nameShort

string

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

textColor

string

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

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 برای نماد مرتبط با این نوع وسیله نقلیه ، بر اساس علائم حمل و نقل محلی.

نوع حمل و نقل

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

Enums
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 Taxi Share نوعی اتوبوس است که توانایی رها کردن و انتخاب مسافر در هر نقطه از مسیر خود را دارد.
SUBWAY راه آهن سبک زیرزمینی.
TRAM بالاتر از راه آهن سبک زمین.
TROLLEYBUS چرخ دستی.

مربوط به مسیر

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

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

object ( TollInfo )

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

speedReadingIntervals[]

object ( SpeedReadingInterval )

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

مثال:

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

روتگلوکالیزه مقالاتی

بازنمایی متن از خصوصیات خاص.

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

NavigationInstruction برای بخش چند مدلی.

travelMode

enum ( RouteTravelMode )

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

stepStartIndex

integer

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

stepEndIndex

integer

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

درگاه دید

نمای عرضه طول و عرض جغرافیایی ، که به عنوان دو مورب مخالف نقاط low و high نشان داده شده است. منظره یک منطقه بسته در نظر گرفته می شود ، یعنی مرز آن را شامل می شود. مرزهای عرض جغرافیایی باید بین -90 تا 90 درجه فراگیر باشد و مرزهای طول جغرافیایی باید بین -180 تا 180 درجه فراگیر باشد. موارد مختلف شامل:

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

  • اگر low.longitude > high.longitude ، دامنه طول جغرافیایی معکوس است (نمای Viewport از خط طول جغرافیایی 180 درجه عبور می کند).

  • اگر low.longitude = -180 درجه و high.longitude = 180 درجه باشد ، Viewport شامل تمام طول ها است.

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

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

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

به عنوان مثال ، این منظره به طور کامل شهر نیویورک را محصور می کند:

{"کم": {"عرض جغرافیایی": 40.477398 ، "طول جغرافیایی": -74.259087} ، "بالا": {"عرض جغرافیایی": 40.91618 ، "طول": -73.70018}}}

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

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

ترشی

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

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

PolylinePointIndex

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

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

integer

شاخص شروع این جزئیات در Polyline.

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 )

نقطه راه GeoCoded Origin.

destination

object ( GeocodedWaypoint )

مقصد Geocoded Waypoint.

intermediates[]

object ( GeocodedWaypoint )

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

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

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

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

object ( Status )

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

type[]

string

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

partialMatch

boolean

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

placeId

string

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

intermediateWaypointRequestIndex

integer

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