- درخواست اچتیتیپی
- متن درخواست
- متن پاسخ
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- مسیر
- RouteLabel
- RouteLeg
- چندخطی
- RouteLegStep
- NavigationInstruction
- مانور
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- دریچه دید
- RouteLocalizedValues
- PolylineDetails
- TunnelInfo
- RoadFeatureState
- PolylinePointIndex
- RestrictionInfo
- FlyoverInfo
- NarrowRoadInfo
- BridgeInfo
- SkywayInfo
- GeocodingResults
- GeocodedWaypoint
با داشتن مجموعهای از نقاطمسیر پایانی و میانی، مسیر اصلی را بههمراه مسیرهای جایگزین اختیاری برمیگرداند.
توجه: این روش مستلزم آن است که ماسک فیلد پاسخ را در ورودی مشخص کنید. میتوانید ماسک فیلد پاسخ را بااستفاده از پارامتر نشانی وب $fields یا fields، یا بااستفاده از سرصفحه HTTP/gRPC X-Goog-FieldMask ارائه دهید (پارامترها و سرصفحههای نشانی وب دردسترس را ببینید). مقدار، فهرستی از مسیرهای فیلد است که با کاما از هم جدا شدهاند. مستندات دقیق درباره نحوه ساختن مسیرهای فیلد را ببینید.
برای مثال، در این روش:
- پوشش فیلد همه فیلدهای دردسترس (برای بازرسی دستی):
X-Goog-FieldMask: * - پوشش فیلد مدت، فاصله، و چندخطی سطح مسیر (نمونه راهاندازی تولید):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google استفاده از پوشش فیلد پاسخ با نویسه عام (*) یا مشخص کردن پوشش فیلد در سطح بالا (routes) را توصیه نمیکند، زیرا:
- انتخاب کردن فقط فیلدهای موردنیازتان به سرور ما کمک میکند چرخههای محاسباتی را ذخیره کند و به ما امکان میدهد نتیجه را با تأخیر کمتری به شما برگردانیم.
- انتخاب کردن فقط فیلدهایی که در کار تولیدتان نیاز دارید عملکرد تأخیر پایداری را تضمین میکند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسباتی بیشتری نیاز داشته باشند. اگر همه فیلدها را انتخاب کنید، یا اگر همه فیلدها را در سطح بالا انتخاب کنید، ممکن است با افت عملکرد مواجه شوید زیرا هر فیلد جدیدی که اضافه میکنیم بهطور خودکار در پاسخ گنجانده میشود.
- انتخاب کردن فقط فیلدهایی که نیاز دارید باعث میشود اندازه پاسخ کوچکتر شود و درنتیجه توان عملیاتی شبکه بالاتر برود.
درخواست HTTP
POST https://routes.googleapis.com/directions/v2:computeRoutes
این نشانی وب از نحو تراتبدیل gRPC استفاده میکند.
متن درخواست
بدنه درخواست حاوی دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{ "origin": { object ( |
| فیلدها | |
|---|---|
origin |
الزامی. نقطهمسیر مبدأ. |
destination |
الزامی. نقطهمسیر مقصد. |
intermediates[] |
اختیاری. مجموعهای از نقطهمسیرها درطول مسیر (بهاستثنای نقاط پایانه)، برای توقف یا عبور. حداکثر ۲۵ نقطهمسیر میانی پشتیبانی میشود. |
travelMode |
اختیاری. حالت حملونقل را مشخص میکند. |
routingPreference |
اختیاری. نحوه محاسبه مسیر را مشخص میکند. سرور تلاش میکند از اولویت مسیریابی انتخابشده برای محاسبه مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تأخیر بسیار طولانی شود، خطا برگردانده میشود. این گزینه را فقط زمانی میتوانید مشخص کنید که |
polylineQuality |
اختیاری. اولویت شما را برای کیفیت چندخطی مشخص میکند. |
polylineEncoding |
اختیاری. کدبندی ترجیحی را برای چندخطی مشخص میکند. |
departureTime |
اختیاری. زمان خروج. اگر این مقدار را تنظیم نکنید، این مقدار بهطور پیشفرض روی زمانی تنظیم میشود که درخواست را ارسال کردهاید. توجه: فقط زمانی میتوانید از RFC 3339 استفاده میکند، که در آن برونداد تولیدشده همیشه Z-نرمالسازی میشود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده میکند. انحرافهای غیراز «Z» نیز پذیرفته میشود. مثالها: |
arrivalTime |
اختیاری. زمان رسیدن. توجه: وقتی درخواستها از RFC 3339 استفاده میکند، که در آن برونداد تولیدشده همیشه Z-نرمالسازی میشود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده میکند. انحرافهای غیراز «Z» نیز پذیرفته میشود. مثالها: |
computeAlternativeRoutes |
اختیاری. مشخص میکند که آیا علاوهبر مسیر، مسیرهای جایگزین هم محاسبه شود یا نه. برای درخواستهایی که نقطهمسیرهای میانی دارند، هیچ مسیر جایگزینی برگردانده نمیشود. |
routeModifiers |
اختیاری. مجموعهای از شرایط که باید برآورده شوند و بر نحوه محاسبه مسیرها تأثیر میگذارند. |
languageCode |
اختیاری. کد زبان BCP-47، مانند «en-US» یا «sr-Latn». برای اطلاعات بیشتر، شناسه محلی Unicode را ببینید. برای مشاهده فهرست زبانهای پشتیبانیشده، به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمیدهید، زبان نمایش از مکان درخواست مسیر استنباط میشود. |
regionCode |
اختیاری. کد منطقه، که بهعنوان مقدار دو نویسهای ccTLD («دامنه سطح بالا») مشخص شده است. برای اطلاعات بیشتر، دامنههای سطح بالای کد کشور را ببینید. |
units |
اختیاری. واحدهای اندازهگیری را برای فیلدهای نمایش مشخص میکند. این فیلدها شامل فیلد |
optimizeWaypointOrder |
اختیاری. اگر روی «درست» تنظیم شود، سرویس تلاش میکند با تغییر ترتیب نقاطمسیر میانی مشخصشده، هزینه کلی مسیر را بهحداقل برساند. اگر هرکدام از نقطهمسیرهای میانی نقطهمسیر |
requestedReferenceRoutes[] |
اختیاری. مشخص میکند که علاوهبر مسیر پیشفرض، چه مسیرهای مرجعی بهعنوان بخشی از درخواست محاسبه شود. مسیر مرجع مسیری است که هدف محاسبه مسیر آن با مسیر پیشفرض متفاوت است. برای مثال، محاسبه مسیر مرجع |
extraComputations[] |
اختیاری. فهرستی از محاسبات اضافی که ممکن است برای تکمیل درخواست استفاده شود. توجه: این محاسبات اضافی ممکن است فیلدهای اضافی در پاسخ برگرداند. این فیلدهای اضافی باید در پوشش فیلد نیز مشخص شوند تا در پاسخ برگردانده شوند. |
trafficModel |
اختیاری. فرضهایی را که باید هنگام محاسبه زمان در ترافیک استفاده شود مشخص میکند. این تنظیم بر مقدار برگرداندهشده در فیلد مدت در |
transitPreferences |
اختیاری. اولویتهایی را مشخص میکند که بر مسیر برگرداندهشده برای مسیرهای |
بدنه پاسخ
v2.computeRoutes پیام پاسخ.
درصورت موفقیتآمیز بودن، بدنه پاسخ حاوی دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{ "routes": [ { object ( |
| فیلدها | |
|---|---|
routes[] |
وقتی |
fallbackInfo |
در برخی موارد که سرور نمیتواند نتایج مسیر را با همه اولویتهای ورودی محاسبه کند، ممکن است به استفاده از روش دیگری برای محاسبه بازگردد. وقتی از حالت بازگشت استفاده میشود، این فیلد حاوی اطلاعات دقیق درباره پاسخ بازگشت است. درغیراینصورت، این فیلد تنظیم نشده است. |
geocodingResults |
حاوی اطلاعات پاسخ زمینکدیابی برای نقطهمسیرهای مشخصشده بهعنوان نشانی است. |
PolylineQuality
مجموعهای از مقادیر که کیفیت چندخطی را مشخص میکند.
| شمارشیها | |
|---|---|
POLYLINE_QUALITY_UNSPECIFIED |
هیچ اولویت کیفیت چندخطیای مشخص نشده است. پیشفرضها به OVERVIEW. |
HIGH_QUALITY |
چندخطی با کیفیت بالا را مشخص میکند - که بااستفاده از نقاط بیشتری نسبتبه OVERVIEW تشکیل شده است، به قیمت افزایش اندازه پاسخ. وقتی به دقت بیشتری نیاز دارید، از این مقدار استفاده کنید. |
OVERVIEW |
یک چندخطی نمای کلی را مشخص میکند - که بااستفاده از تعداد کمی نقطه تشکیل شده است. هنگام نمایش نمای کلی مسیر، از این مقدار استفاده کنید. استفاده از این گزینه در مقایسه با گزینه HIGH_QUALITY تأخیر درخواست کمتری دارد. |
PolylineEncoding
نوع چندخطی ترجیحی را برای برگرداندن مشخص میکند.
| شمارشیها | |
|---|---|
POLYLINE_ENCODING_UNSPECIFIED |
هیچ اولویت نوع چندخطیای مشخص نشده است. پیشفرضها به ENCODED_POLYLINE. |
ENCODED_POLYLINE |
چندخطی کدبندیشده بااستفاده از الگوریتم کدبندی چندخطی را مشخص میکند. |
GEO_JSON_LINESTRING |
چندخطی را بااستفاده از قالب GeoJSON LineString مشخص میکند |
ReferenceRoute
مسیر مرجع پشتیبانیشده در ComputeRoutesRequest.
| شمارشیها | |
|---|---|
REFERENCE_ROUTE_UNSPECIFIED |
استفادهنشده. درخواستهای حاوی این مقدار ناموفق است. |
FUEL_EFFICIENT |
مسیر با بهرهوری سوخت. |
SHORTER_DISTANCE |
مسیر با مسافت سفر کوتاهتر. این قابلیتی آزمایشی است. برای درخواستهای برای درخواستهای این ویژگی با هیچ حالت سفر دیگری، ازطریق نقطهمسیرهای میانی، یا |
ExtraComputation
محاسبات اضافی که باید هنگام تکمیل درخواست انجام شود. ممکن است در آینده مقادیر بیشتری اضافه شود.
| شمارشیها | |
|---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
استفادهنشده. درخواستهای حاوی این مقدار ناموفق خواهد بود. |
TOLLS |
اطلاعات عوارض برای مسیر(ها). |
FUEL_CONSUMPTION |
مصرف سوخت تخمینی برای مسیر(ها). |
TRAFFIC_ON_POLYLINE |
چندخطیهای آگاه از ترافیک برای مسیر(ها). |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstruction بهصورت رشته نوشتاری HTML قالببندیشده ارائه شده است. این محتوا باید همانطور که هست خوانده شود. این محتوا فقط برای نمایش است. آن را بهصورت برنامهنویسی تجزیه نکنید. |
FLYOVER_INFO_ON_POLYLINE |
اطلاعات پرواز برای مسیر(ها). برای برگرداندن این اطلاعات، باید ماسک فیلد routes.polyline_details.flyover_info مشخص شود. این دادهها درحالحاضر فقط برای برخیاز شهرهای هند پر میشود. این ویژگی آزمایشی است و SKU/هزینه ممکن است تغییر کند. |
NARROW_ROAD_INFO_ON_POLYLINE |
اطلاعات جاده باریک برای مسیر(ها). برای برگرداندن این اطلاعات، باید ماسک فیلد routes.polyline_details.narrow_road_info مشخص شود. این دادهها درحالحاضر فقط برای برخیاز شهرهای هند پر میشود. این ویژگی آزمایشی است و SKU/هزینه ممکن است تغییر کند. |
TUNNEL_INFO_ON_POLYLINE |
اطلاعات تونل برای مسیر(ها). برای برگرداندن این اطلاعات، باید ماسک فیلد routes.polyline_details.tunnel_info مشخص شود. |
BRIDGE_INFO_ON_POLYLINE |
اطلاعات پل برای مسیر(ها). برای برگرداندن این اطلاعات، باید ماسک فیلد routes.polyline_details.bridge_info مشخص شود. |
SKYWAY_INFO_ON_POLYLINE |
اطلاعات پل هوایی برای مسیر(ها). برای برگرداندن این اطلاعات، باید ماسک فیلد routes.polyline_details.skyway_info مشخص شود. |
مسیر
حاوی مسیری است که از مجموعهای از بخشهای جادهای متصل تشکیل شده است که نقاطمسیر شروع، پایان، و میانی را به هم وصل میکند.
| نمایش JSON |
|---|
{ "routeLabels": [ enum ( |
| فیلدها | |
|---|---|
routeLabels[] |
برچسبهای |
legs[] |
مجموعهای از پاها (بخشهای مسیر بین نقاط مسیر) که مسیر را تشکیل میدهند. هر مسیر مربوط به سفر بین دو |
distanceMeters |
مسافت سفر در مسیر، به متر. |
duration |
مدت زمان لازم برای پیمایش مسیر. اگر وقتی
در همه موارد دیگر، از سرعت خودروهای سواری استفاده میشود، حتی اگر ابعاد یا وزن خودروهای دیگر در مدتزمان به ثانیه با حداکثر نه رقم اعشار، که به « |
staticDuration |
مدت سفر در مسیر بدون درنظر گرفتن وضعیت ترافیک. مدتزمان به ثانیه با حداکثر نه رقم اعشار، که به « |
polyline |
چندخطی کل مسیر. این چندخطی، چندخطی ترکیبی همه |
description |
شرح مسیر. |
warnings[] |
آرایهای از هشدارها برای نمایش هنگام نشان دادن مسیر. |
viewport |
چارگوش محصورکننده ناحیه نمایش چندخطی. |
travelAdvisory |
اطلاعات بیشتر درباره مسیر. |
optimizedIntermediateWaypointIndex[] |
اگر |
localizedValues |
نمایشهای نوشتاری ویژگیهای |
routeToken |
یک توکن مات که میتواند به کیت توسعه نرمافزار ناوبری ارسال شود تا مسیر را درطول ناوبری بازسازی کند و درصورت تغییر مسیر، به هدف اصلی هنگام ایجاد مسیر احترام بگذارد. این کد را بهعنوان یک حباب مات درنظر بگیرید. مقدار آن را در درخواستها مقایسه نکنید زیرا ممکن است مقدار آن تغییر کند حتی اگر سرویس دقیقاً همان مسیر را برگرداند. توجه: |
polylineDetails |
حاوی اطلاعاتی درباره جزئیات درطول چندخطی است. |
RouteLabel
برچسبهای که برای شناسایی ویژگیهای خاص مسیر برای مقایسه با دیگران مفید هستند.Route
| شمارشیها | |
|---|---|
ROUTE_LABEL_UNSPECIFIED |
پیشفرض - استفاده نشده است. |
DEFAULT_ROUTE |
مسیر «بهترین» پیشفرض برای محاسبه مسیر برگردانده شد. |
DEFAULT_ROUTE_ALTERNATE |
جایگزینی برای مسیر «بهترین» پیشفرض. وقتی مشخص شود، مسیرهایی مثل این برگردانده میشود. |
FUEL_EFFICIENT |
مسیر با بهرهوری سوخت. مسیرهایی که با این مقدار برچسبگذاری شدهاند، برای پارامترهای سازگار با محیطزیست مانند مصرف سوخت بهینهسازی شدهاند. |
SHORTER_DISTANCE |
مسیر با مسافت سفر کوتاهتر. این قابلیتی آزمایشی است. |
RouteLeg
حاوی بخشی بین نقاطمسیر غیرvia است.
| نمایش JSON |
|---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
| فیلدها | |
|---|---|
distanceMeters |
مسافت سفر بخش مسیر، به متر. |
duration |
مدت زمان لازم برای پیمایش بخش. اگر وقتی
در همه موارد دیگر، از سرعت خودروهای سواری استفاده میشود، حتی اگر ابعاد یا وزن خودروهای دیگر در مدتزمان به ثانیه با حداکثر نه رقم اعشار، که به « |
staticDuration |
مدت سفر درطول بخش، بدون درنظر گرفتن شرایط ترافیک محاسبه میشود. مدتزمان به ثانیه با حداکثر نه رقم اعشار، که به « |
polyline |
چندخطی کلی برای این بخش که شامل چندخطی هر |
startLocation |
مکان شروع این بخش. این مکان ممکن است با |
endLocation |
مکان پایان این بخش. این مکان ممکن است با |
steps[] |
آرایهای از مراحل که بخشهای درون این مسیر را نشان میدهد. هر مرحله نشاندهنده یک دستورالعمل ناوبری است. |
travelAdvisory |
حاوی اطلاعات تکمیلی است که کاربر باید از آنها مطلع شود، مثل محدودیتهای احتمالی منطقه ترافیکی در یک بخش مسیر. |
localizedValues |
نمایشهای نوشتاری ویژگیهای |
stepsOverview |
اطلاعات کلی درباره مراحل این |
چندخطی
یک چندخطی کدگذاریشده را کپسوله میکند.
| نمایش JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "encodedPolyline": string, "geoJsonLinestring": { object } // End of mutually exclusive fields. } |
| فیلدها | |
|---|---|
| نوع چندخطی را کپسوله میکند. پیشفرض encoded_polyline است. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد: | |
encodedPolyline |
کدبندی رشته چندخطی بااستفاده از الگوریتم کدبندی چندخطی |
geoJsonLinestring |
چندخطی را بااستفاده از قالب GeoJSON LineString مشخص میکند. |
| پایان فیلدهای متقابلاً انحصاری. | |
RouteLegStep
شامل بخشی از است. هر مرحله مربوط به یک دستورالعمل ناوبری است. بخشهای مسیر از مراحل تشکیل شدهاند.RouteLeg
| نمایش JSON |
|---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
| فیلدها | |
|---|---|
distanceMeters |
مسافت سفر این مرحله، به متر. در برخی شرایط، این فیلد ممکن است مقداری نداشته باشد. |
staticDuration |
مدت سفر در این مرحله بدون درنظر گرفتن شرایط ترافیک. در برخی شرایط، این فیلد ممکن است مقداری نداشته باشد. مدتزمان به ثانیه با حداکثر نه رقم اعشار، که به « |
polyline |
چندخطی مرتبط با این مرحله. |
startLocation |
مکان شروع این مرحله. |
endLocation |
مکان پایان این مرحله. |
navigationInstruction |
دستورالعملهای ناوبری. |
travelAdvisory |
حاوی اطلاعات تکمیلی است که کاربر باید از آنها مطلع شود، مثل محدودیتهای احتمالی منطقه ترافیکی، در مرحله پا. |
localizedValues |
نمایشهای نوشتاری ویژگیهای |
transitDetails |
جزئیات مربوط به این مرحله اگر حالت سفر |
travelMode |
حالت سفر استفادهشده برای این مرحله. |
مانور
مجموعهای از مقادیر که کنش پیمایش را برای انجام در مرحله فعلی مشخص میکند (برای مثال، گردش به چپ، ادغام، یا مستقیم).
| شمارشیها | |
|---|---|
MANEUVER_UNSPECIFIED |
استفادهنشده. |
TURN_SLIGHT_LEFT |
کمی به چپ بچرخید. |
TURN_SHARP_LEFT |
با زاویه تند به چپ بپیچید. |
UTURN_LEFT |
دور کامل به چپ بزنید. |
TURN_LEFT |
به چپ بپیچید. |
TURN_SLIGHT_RIGHT |
کمی به راست بپیچید. |
TURN_SHARP_RIGHT |
با گردش تندی به راست بپیچید. |
UTURN_RIGHT |
دور کامل به راست بزنید. |
TURN_RIGHT |
بهراست بچرخید. |
STRAIGHT |
مستقیم بروید. |
RAMP_LEFT |
وارد کنارگذر سمت چپ شوید. |
RAMP_RIGHT |
وارد کنارگذر سمت راست شوید. |
MERGE |
وارد ترافیک شوید. |
FORK_LEFT |
بهسمت چپ دوراهی بروید. |
FORK_RIGHT |
بهسمت راست بپیچید. |
FERRY |
سوار قایق مسافربری شوید. |
FERRY_TRAIN |
سوار قطاری شوید که به کشتی میرود. |
ROUNDABOUT_LEFT |
در میدان، به چپ بپیچید. |
ROUNDABOUT_RIGHT |
در میدان، به راست بپیچید. |
DEPART |
مانور اولیه. |
NAME_CHANGE |
برای نشان دادن تغییر نام خیابان استفاده میشود. |
DESTINATION |
برای نشان دادن رسیدن به مقصد استفاده میشود. |
RouteLegStepTravelAdvisory
حاوی اطلاعات اضافی است که کاربر باید از آنها مطلع شود، مانند محدودیتهای احتمالی منطقه ترافیکی در یک مرحله از مسیر.
| نمایش JSON |
|---|
{
"speedReadingIntervals": [
{
object ( |
| فیلدها | |
|---|---|
speedReadingIntervals[] |
توجه: این فیلد درحالحاضر درج نمیشود. |
RouteLegStepLocalizedValues
نمایش نوشتاری برخیاز داراییها.
| نمایش JSON |
|---|
{ "distance": { object ( |
| فیلدها | |
|---|---|
distance |
مسافت سفر بهصورت نوشتاری نشان داده میشود. |
staticDuration |
مدتزمان بدون درنظر گرفتن شرایط ترافیک، بهصورت نوشتاری نشان داده میشود. |
RouteLegStepTransitDetails
اطلاعات بیشتر برای RouteLegStep مربوط به مسیرهای TRANSIT.
| نمایش JSON |
|---|
{ "stopDetails": { object ( |
| فیلدها | |
|---|---|
stopDetails |
اطلاعات مربوط به ایستگاههای ورود و خروج برای مرحله. |
localizedValues |
نمایشهای نوشتاری ویژگیهای |
headsign |
جهت حرکت در این خط را همانطور که روی وسیله نقلیه یا در ایستگاه عزیمت علامتگذاری شده است مشخص میکند. جهت اغلب ایستگاه پایانی است. |
headway |
زمان موردانتظار را بهعنوان مدتزمان بین حرکتها از همان ایستگاه در این زمان مشخص میکند. برای مثال، اگر مقدار ثانیه سرفاصله ۶۰۰ باشد، درصورت ازدست دادن اتوبوس، انتظار میرود ۱۰ دقیقه منتظر بمانید. مدتزمان به ثانیه با حداکثر نه رقم اعشار، که به « |
transitLine |
اطلاعات مربوط به خط حملونقل عمومی استفادهشده در این مرحله. |
stopCount |
تعداد توقفها از ایستگاه مبدأ تا ایستگاه مقصد. این تعداد شامل ایستگاه مقصد میشود، اما ایستگاه مبدأ را دربرنمیگیرد. برای مثال، اگر مسیرتان از ایستگاه الف شروع شود، از ایستگاههای ب و پ عبور کند، و به ایستگاه ت برسد، |
tripShortText |
نوشتاری که در زمانبندیها و تابلوهای راهنما نشان داده میشود تا سفر حملونقل عمومی را برای مسافران مشخص کند. نوشتار باید بهطور منحصربهفرد سفر را در روز خدمات مشخص کند. برای مثال، «۵۳۸» |
TransitStopDetails
جزئیات مربوط به ایستگاههای حملونقل عمومی برای RouteLegStep.
| نمایش JSON |
|---|
{ "arrivalStop": { object ( |
| فیلدها | |
|---|---|
arrivalStop |
اطلاعات مربوط به ایستگاه مقصد برای این مرحله. |
arrivalTime |
زمان تخمینی ورود برای این مرحله. از RFC 3339 استفاده میکند، که در آن برونداد تولیدشده همیشه Z-نرمالسازی میشود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده میکند. انحرافهای غیراز «Z» نیز پذیرفته میشود. مثالها: |
departureStop |
اطلاعات مربوط به ایستگاه حرکت برای این مرحله. |
departureTime |
زمان تخمینی حرکت برای این مرحله. از RFC 3339 استفاده میکند، که در آن برونداد تولیدشده همیشه Z-نرمالسازی میشود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده میکند. انحرافهای غیراز «Z» نیز پذیرفته میشود. مثالها: |
TransitStop
اطلاعات مربوط به ایستگاه حملونقل عمومی.
| نمایش JSON |
|---|
{
"name": string,
"location": {
object ( |
| فیلدها | |
|---|---|
name |
نام ایستگاه حملونقل عمومی. |
location |
مکان ایستگاه که با مختصات طول/عرض جغرافیایی بیان شده است. |
TransitDetailsLocalizedValues
توضیحات بومیسازیشده مقادیر برای RouteTransitDetails.
| نمایش JSON |
|---|
{ "arrivalTime": { object ( |
| فیلدها | |
|---|---|
arrivalTime |
زمان در قالب نوشتار قالببندیشده با منطقه زمانی مربوطه. |
departureTime |
زمان در قالب نوشتار قالببندیشده با منطقه زمانی مربوطه. |
LocalizedTime
شرح بومیسازیشده زمان.
| نمایش JSON |
|---|
{
"time": {
object ( |
| فیلدها | |
|---|---|
time |
زمان مشخصشده بهعنوان رشته در منطقه زمانی ارائهشده. |
timeZone |
حاوی منطقه زمانی است. مقدار، نام منطقه زمانی است که در پایگاه داده منطقه زمانی IANA تعریف شده است، مثلاً «America/New_York». |
TransitLine
حاوی اطلاعاتی درباره خط حملونقل عمومی استفادهشده در این مرحله است.
| نمایش JSON |
|---|
{ "agencies": [ { object ( |
| فیلدها | |
|---|---|
agencies[] |
سازمان حملونقل عمومی (یا سازمانهایی) که این خط حملونقل عمومی را اداره میکند. |
name |
نام کامل این خط حملونقل عمومی، برای مثال، «8 Avenue Local». |
uri |
شناسه منبع یکسان برای این خط حملونقل عمومی که توسط سازمان حملونقل عمومی ارائه شده است. |
color |
رنگی که معمولاً در تابلوهای این خط استفاده میشود. بهصورت شانزدهشانزدهی نشان داده میشود. |
iconUri |
URI برای نماد مرتبط با این خط. |
nameShort |
نام کوتاه این خط حملونقل عمومی. این نام معمولاً شماره خط است، مثل «M7» یا «355». |
textColor |
رنگی که معمولاً در نوشتار تابلوهای این خط استفاده میشود. بهصورت شانزدهشانزدهی نشان داده میشود. |
vehicle |
نوع وسیله نقلیهای که در این خط حملونقل عمومی کار میکند. |
TransitAgency
سازمان حملونقل عمومی که خط حملونقل عمومی را اداره میکند.
| نمایش JSON |
|---|
{ "name": string, "phoneNumber": string, "uri": string } |
| فیلدها | |
|---|---|
name |
نام این سازمان حملونقل عمومی. |
phoneNumber |
شماره تلفن سازمان حملونقل عمومی در قالب بینالمللی. |
uri |
شناسه منبع یکسان دفتر حملونقل عمومی. |
TransitVehicle
اطلاعات مربوط به وسیله نقلیه مورداستفاده در مسیرهای حملونقل عمومی.
| نمایش JSON |
|---|
{ "name": { object ( |
| فیلدها | |
|---|---|
name |
نام این خودرو، با حروف بزرگ. |
type |
نوع وسیله نقلیه استفادهشده. |
iconUri |
شناسه منبع یکسان برای نماد مرتبط با این نوع خودرو. |
localIconUri |
شناسه منبع یکسان برای نماد مرتبط با این نوع خودرو، براساس علائم حملونقل محلی. |
TransitVehicleType
نوع وسایل نقلیه برای مسیرهای حملونقل عمومی.
| شمارشیها | |
|---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
استفادهنشده. |
BUS |
اتوبوس. |
CABLE_CAR |
وسیله نقلیهای که با کابل کار میکند، معمولاً روی زمین. تلهکابینها ممکن است از نوع GONDOLA_LIFT باشند. |
COMMUTER_TRAIN |
قطار حومهای. |
FERRY |
کشتی. |
FUNICULAR |
وسیله نقلیهای که با کابل از شیب تندی بالا کشیده میشود. قطار کابلی معمولاً از دو واگن تشکیل شده است که هر واگن بهعنوان وزنه تعادل برای واگن دیگر عمل میکند. |
GONDOLA_LIFT |
تلهکابین هوایی. |
HEAVY_RAIL |
ریلی سنگین. |
HIGH_SPEED_TRAIN |
قطار پرسرعت. |
INTERCITY_BUS |
اتوبوس بینشهری. |
LONG_DISTANCE_TRAIN |
قطار راه دور. |
METRO_RAIL |
قطار شهری. |
MONORAIL |
مونوریل. |
OTHER |
همه خودروهای دیگر. |
RAIL |
راهآهن. |
SHARE_TAXI |
تاکسی اشتراکی نوعی اتوبوس است که میتواند مسافران را در هر نقطهای از مسیرش سوار یا پیاده کند. |
SUBWAY |
قطار شهری زیرزمینی. |
TRAM |
قطار شهری روی زمین. |
TROLLEYBUS |
اتوبوس برقی. |
RouteLegTravelAdvisory
حاوی اطلاعات اضافی است که کاربر باید در مرحله مسیر از آن مطلع شود، مانند محدودیتهای احتمالی منطقه ترافیکی.
| نمایش JSON |
|---|
{ "tollInfo": { object ( |
| فیلدها | |
|---|---|
tollInfo |
حاوی اطلاعاتی درباره عوارض در |
speedReadingIntervals[] |
فواصل خواندن سرعت که نشاندهنده تراکم ترافیک است. این فیلد فقط برای درخواستهایی پر میشود که مقدار مثال: |
RouteLegLocalizedValues
نمایش نوشتاری برخیاز داراییها.
| نمایش JSON |
|---|
{ "distance": { object ( |
| فیلدها | |
|---|---|
distance |
مسافت سفر بهصورت نوشتاری نشان داده میشود. |
duration |
مدت زمان، که بهصورت نوشتاری نشان داده میشود و برای منطقه پُرسمان بومیسازی شده است. شرایط ترافیک را درنظر میگیرد. توجه: اگر اطلاعات ترافیک را درخواست نکرده باشید، این مقدار با staticDuration یکسان است. |
staticDuration |
مدتزمان بدون درنظر گرفتن شرایط ترافیک، بهصورت نوشتاری نشان داده میشود. |
StepsOverview
اطلاعات کلی درباره فهرستی از RouteLegStepها ارائه میدهد.
| نمایش JSON |
|---|
{
"multiModalSegments": [
{
object ( |
| فیلدها | |
|---|---|
multiModalSegments[] |
اطلاعات خلاصهشده درباره بخشهای چندحالتی مختلف |
MultiModalSegment
اطلاعات خلاصهشدهای درباره بخشهای چندحالتی مختلف RouteLeg.steps ارائه میدهد. بخش چندحالتی بهعنوان یک یا چند RouteLegStep مجاور تعریف میشود که RouteTravelMode یکسانی دارند. اگر RouteLeg هیچ بخش چندحالتی در مراحل نداشته باشد، این فیلد درج نمیشود.
| نمایش JSON |
|---|
{ "navigationInstruction": { object ( |
| فیلدها | |
|---|---|
navigationInstruction |
NavigationInstruction برای بخش چندحالتی. |
travelMode |
حالت سفر بخش چندحالتی. |
stepStartIndex |
نمایه |
stepEndIndex |
نمایه |
ناحیه نمایش
نمای طول و عرض جغرافیایی که بهصورت دو نقطه low و high در مقابل هم بهصورت مورب نشان داده میشود. ناحیه نمایش بهعنوان منطقهای بسته درنظر گرفته میشود، یعنی مرزهای آن را شامل میشود. محدوده عرض جغرافیایی باید بین ۹۰- تا ۹۰ درجه و محدوده طول جغرافیایی باید بین ۱۸۰- تا ۱۸۰ درجه باشد. موارد مختلف عبارتاند از:
اگر
low=high، ناحیه نمایش از آن نقطه واحد تشکیل میشود.اگر
low.longitude>high.longitude، محدوده طول جغرافیایی معکوس میشود (ناحیه نمایش از خط طول جغرافیایی ۱۸۰ درجه عبور میکند).اگر
low.longitude= ۱۸۰- درجه وhigh.longitude= ۱۸۰ درجه باشد، نمای هدف شامل همه طولهای جغرافیایی میشود.اگر
low.longitude= ۱۸۰ درجه وhigh.longitude= ۱۸۰- درجه باشد، محدوده طول جغرافیایی خالی است.اگر
low.latitude>high.latitudeباشد، محدوده عرض جغرافیایی خالی است.
هر دو low و high باید پر شوند و کادر نشاندادهشده نمیتواند خالی باشد (همانطور که در تعاریف بالا مشخص شده است). نمای خالی منجر به خطا میشود.
برای مثال، این ناحیه نمایش کاملاً شهر نیویورک را دربرمیگیرد:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
| نمایش JSON |
|---|
{ "low": { object ( |
| فیلدها | |
|---|---|
low |
الزامی. نقطه پایین نمای دید. |
high |
الزامی. نقطه بالای ناحیه نمایش. |
RouteLocalizedValues
نمایش نوشتاری برخیاز داراییها.
| نمایش JSON |
|---|
{ "distance": { object ( |
| فیلدها | |
|---|---|
distance |
مسافت سفر بهصورت نوشتاری نشان داده میشود. |
duration |
مدت زمان، که بهصورت نوشتاری نشان داده میشود و برای منطقه پُرسمان بومیسازی شده است. شرایط ترافیک را درنظر میگیرد. توجه: اگر اطلاعات ترافیک را درخواست نکرده باشید، این مقدار با مقدار |
staticDuration |
مدتزمان بدون درنظر گرفتن شرایط ترافیک، بهصورت نوشتاری نشان داده میشود. |
transitFare |
کرایه حملونقل عمومی بهصورت نوشتاری نشان داده میشود. |
PolylineDetails
جزئیات مربوط به نمایه یا بخش مجاور چندخطی. با داشتن چندخطی با نقاط P_0، P_1، ...، P_N (نمایه صفرپایه)، PolylineDetails یک بازه و فراداده مرتبط را تعریف میکند.
| نمایش JSON |
|---|
{ "tunnelInfo": [ { object ( |
| فیلدها | |
|---|---|
tunnelInfo[] |
جزئیات تونل درطول چندخطی. اگر درخواست اصلاحکننده مسیر |
restrictionInfo[] |
جزئیات محدودیت درطول چندخطی. این فیلد فقط زمانی پر میشود که درخواستی اصلاحکننده مسیر |
flyoverInfo[] |
جزئیات پرواز در امتداد چندخطی. |
narrowRoadInfo[] |
جزئیات جاده باریک درطول چندخطی. |
bridgeInfo[] |
جزئیات پل درطول چندخطی. |
skywayInfo[] |
جزئیات پل هوایی درطول چندخطی. |
TunnelInfo
اطلاعات مربوط به تونلهای موجود در چندخطی را کپسوله میکند.
| نمایش JSON |
|---|
{ "tunnelPresence": enum ( |
| فیلدها | |
|---|---|
tunnelPresence |
نشان میدهد که آیا تونلی برای بخش مشخصی از چندخطی وجود دارد یا نه. |
polylinePointIndex |
مکان اطلاعات مربوط به تونل درطول چندخطی. |
RoadFeatureState
وضعیتهای ویژگیهای جاده را درطول یک چندخطی کپسولهسازی میکند.
| شمارشیها | |
|---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
وضعیت عارضه جاده محاسبه نشد (مقدار پیشفرض). |
EXISTS |
ویژگی جاده وجود دارد. |
DOES_NOT_EXIST |
این جاده وجود ندارد. |
PolylinePointIndex
نمایههای شروع و پایان را برای جزئیات چندخطی کپسولهسازی میکند. برای مواردی که دادهها مربوط به یک نقطه واحد است، startIndex و endIndex برابر خواهند بود.
| نمایش JSON |
|---|
{ "startIndex": integer, "endIndex": integer } |
| فیلدها | |
|---|---|
startIndex |
نمایه شروع این جزئیات در چندخطی. |
endIndex |
نمایه پایانی این جزئیات در چندخطی. |
RestrictionInfo
اطلاعات مربوط به محدودیتهای مختلف درطول چندخطی را کپسوله میکند.
| نمایش JSON |
|---|
{ "restrictionPresence": enum ( |
| فیلدها | |
|---|---|
restrictionPresence |
فقط خروجی. نشان میدهد که آیا محدودیتی برای بخش مشخصی از چندخطی وجود دارد یا نه. |
polylinePointIndex |
مکان اطلاعات مربوط به محدودیت درطول چندخطی. |
| انواع محدودیتهایی را که میتواند بر بخش مشخصی از چندخطی اعمال شود دربرمیگیرد. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد: | |
restrictedHeightMm |
حد ارتفاع، به میلیمتر. این فیلد زمانی پر میشود که ارتفاع محدودشده مانع عبور شود یا منجر به فاصله کم برای وسیله نقلیه مشخصشده شود. |
restrictedWeightKg |
محدودیت وزن، به کیلوگرم. این فیلد زمانی پر میشود که محدودیت وزن مانع عبور شود یا نزدیک به وزن خودرو مشخصشده باشد. |
hazardousGoods |
وقتی حمل کالاهای خطرناک محدود شده باشد، این فیلد روی «درست» تنظیم میشود. |
trucksProhibited |
وقتی کامیونها ممنوع باشند، این فیلد روی «درست» تنظیم میشود. |
| پایان فیلدهای متقابلاً انحصاری. | |
FlyoverInfo
اطلاعات مربوط به پروازهای روی چندخطی را کپسولهسازی میکند.
| نمایش JSON |
|---|
{ "flyoverPresence": enum ( |
| فیلدها | |
|---|---|
flyoverPresence |
فقط خروجی. نشان میدهد که آیا برای بخش مشخصی از چندخطی، پل هوایی وجود دارد یا نه. |
polylinePointIndex |
مکان اطلاعات مربوط به پرواز از بالا درطول چندخطی. |
NarrowRoadInfo
اطلاعات مربوط به جادههای باریک درطول چندخطی را کپسوله میکند.
| نمایش JSON |
|---|
{ "narrowRoadPresence": enum ( |
| فیلدها | |
|---|---|
narrowRoadPresence |
فقط خروجی. نشان میدهد که آیا جاده باریکی برای بخش مشخصی از چندخطی وجود دارد یا نه. |
polylinePointIndex |
مکان اطلاعات مربوط به جاده باریک درطول چندخطی. |
BridgeInfo
اطلاعات مربوط به پلهای موجود در چندخطی را کپسولهسازی میکند.
| نمایش JSON |
|---|
{ "bridgePresence": enum ( |
| فیلدها | |
|---|---|
bridgePresence |
نشان میدهد که آیا پلی برای یک بخش مشخص از چندخطی وجود دارد یا نه. |
polylinePointIndex |
مکان اطلاعات مربوط به پل درطول چندخطی. |
SkywayInfo
اطلاعات مربوط به پلهای هوایی درطول چندخطی را کپسولهسازی میکند.
| نمایش JSON |
|---|
{ "skywayPresence": enum ( |
| فیلدها | |
|---|---|
skywayPresence |
نشان میدهد که آیا برای بخش مشخصی از چندخطی، پل هوایی وجود دارد یا نه. |
polylinePointIndex |
مکان اطلاعات مربوط به پل هوایی درطول چندخطی. |
GeocodingResults
حاوی برای مبدأ، مقصد، و نقاطمسیر میانی است. فقط برای نقاطمسیر نشانی درج میشود.GeocodedWaypoints
| نمایش JSON |
|---|
{ "origin": { object ( |
| فیلدها | |
|---|---|
origin |
نقطهمسیر زمینکدیابیشده مبدأ. |
destination |
نقطهمسیر زمینکدیابیشده مقصد. |
intermediates[] |
فهرستی از نقطهمسیرهای زمینکدیابیشده میانی که هرکدام حاوی فیلد نمایهای است که با موقعیت صفرپایه نقطهمسیر بهترتیبی که در درخواست مشخص شده است مطابقت دارد. |
GeocodedWaypoint
جزئیات مربوط به مکانهایی که بهعنوان نقطهمسیر استفاده شدهاند. فقط برای نقاطمسیر نشانی درج میشود. شامل جزئیاتی درباره نتایج زمینکدیابی برای تعیین اینکه نشانی به چه چیزی زمینکدیابی شده است.
| نمایش JSON |
|---|
{
"geocoderStatus": {
object ( |
| فیلدها | |
|---|---|
geocoderStatus |
کد وضعیت حاصل از عملیات زمینکدیابی را نشان میدهد. |
type[] |
نوع (انواع) نتیجه، بهصورت صفر یا چند برچسب نوع. انواع پشتیبانیشده: انواع نشانی و انواع مؤلفه نشانی. |
partialMatch |
نشان میدهد که زمینکدیاب برای درخواست اصلی مطابقت دقیقی برنگردانده است، هرچند توانسته است با بخشی از نشانی درخواستی مطابقت داشته باشد. شاید بخواهید درخواست اصلی را ازنظر غلط املایی و/یا نشانی ناقص بررسی کنید. |
placeId |
شناسه مکان برای این نتیجه. |
intermediateWaypointRequestIndex |
شاخص نقطهمسیر میانی مربوطه در درخواست. فقط درصورتی درج میشود که نقطهمسیر مربوطه نقطهمسیر میانی باشد. |