مسیری با مسافت کوتاه‌تر دریافت کنید، مسیر مسافت کوتاه‌تری دریافت کنید، مسیر مسافت کوتاه‌تری دریافت کنید

Routes API می‌تواند مسیرهای رانندگی بهینه‌سازی شده برای مسافت سفر کوتاه‌تر را زمانی که مسیرهای مسافت کوتاه‌تری را فعال کنید، بازگرداند.

وقتی مسیر مسافت کمتری را درخواست می‌کنید، سرویس موارد زیر را برمی‌گرداند:

  • مسیر پیش فرض، که مسیری است که عمدتاً برای ETA بهینه شده است.
  • یک مسیر کوتاهتر بهینه شده برای به حداقل رساندن مسافت سفر در کل سفر.

چیست و چرا باید از آن استفاده کرد

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

درخواست مسیر مسافت کمتر

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

  • travelMode روی DRIVE ، BICYCLE ، یا TWO_WHEELER تنظیم کنید.
  • requestedReferenceRoutes روی SHORTER_DISTANCE تنظیم کنید.
  • یک ماسک فیلد پاسخ را برای بازگرداندن ویژگی‌های پاسخ مرتبط با یک مسیر کوتاه‌تر تنظیم کنید:
    • routes.routeLabels : هر مسیر را به عنوان DEFAULT_ROUTE ، SHORTER_DISTANCE یا DEFAULT_ROUTE_ALTERNATE شناسایی می کند.
    • routes.routeToken : یک نشانه مسیر که می توانید برای بازیابی یک مسیر سفارشی به Navigation SDK منتقل کنید.
  • هیچ ایستگاه بین راهی Via وارد نکنید .
  • پارامتر optimizeWaypointOrder را درج نکنید .
  • اختیاری : یک ماسک فیلد پاسخ را تنظیم کنید تا ویژگی‌های زیر مرتبط با مسیر پیش‌فرض و مسافت کوتاه‌تر را بازگرداند:
    • routes.distanceMeters : فاصله مسیر را برمی گرداند.
    • routes.duration : مدت زمان مسیر را برمی گرداند.

برای اطلاعات مرجع، ReferenceRoute و RouteLabel را ببینید.

درخواست مثال: مسیر مسافت کوتاهتر

کد زیر درخواستی برای مسیری با مسافت کمتر را نشان می دهد. در این مثال، شما از ماسک فیلد پاسخ برای برگرداندن فیلدهای مرتبط با مسیر پیش‌فرض و مسافت کوتاه‌تر با ماسک‌های فیلد زیر استفاده می‌کنید:

  • routes.distanceMeters
  • routes.duration
curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "requestedReferenceRoutes": ["SHORTER_DISTANCE"],
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

نمونه پاسخ مسیر کوتاه تر 

{
  "routes": [
    {
      "distanceMeters": 138943,
      "duration": "5373s",
      "routeToken": "CrsCCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXcklWWFo2cjhDZmltdk9NUDQ3aU1nUU0QBRpPCk0KGAoNCgIIAREAAAAAAIBmQBF56SYxqDm4QBISCAAQAxAGEBMQEhgCQgQaAggFIhsKF3JJVlhaLWFOQnZpbXZPTVA0N2lNZ1FNcAEoASIVAACBmRY1BjeCiUQewJGTrQ3DuHRp",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 112610,
      "duration": "7165s",
      "routeToken": "CqgCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdySVZYWjZHR0RiTzV2T01QOUpiQXlBTRAFGk8KTQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhIIABADEAYQExASGAJCBBoCCAUiGwoXcklWWFo3S09Cck81dk9NUDlKYkF5QU1wASgCIhUAAIGZFlj_CmMgGE6KGZcsE-tEywM",
      "routeLabels": [
        "SHORTER_DISTANCE"
      ]
    }
  ]
}

درخواست مثال: مسافت کوتاهتر و مسیر کارآمد سوخت

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

`

 curl -X POST -d '{
"origin": {  "location": {  "latLng": {  "latitude": 41.76904801292959,
"longitude": -72.67374935684933  }  }  },  "destination": {  "location": {
"latLng": {  "latitude": 41.823042361105024,  "longitude": -71.40933143059424  }
 }  },  "travelMode":"DRIVE",  "routingPreference":"TRAFFIC_AWARE_OPTIMAL",
"requestedReferenceRoutes": ["SHORTER_DISTANCE", "FUEL_EFFICIENT"] }' 

-H 'Content-Type: application/json' 

-H 'X-Goog-Api-Key: YOUR_API_KEY' 

-H 'X-Goog-FieldMask:
routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' 

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

پاسخ مثال: مسافت کوتاهتر و مسیر کم مصرف

در این حالت مسافت کمتر و کم مصرف ترین مسیر یکسان است، به طوری که مسیر برگشت داده می شود و routeLabel برای هر دو نوع مسیر درج می شود.

{  "routes": [  {  "distanceMeters": 138943,  "duration": "5375s",
"routeToken":
"Cr8CCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXS1laWFo4T19JcWVCM2ZFUDFMbms4UXcQBRpTClEKGAoNCgIIAREAAAAAAIBmQBFOYhBYGTy4QBIWCAAQAxAGEBMQEhgCQgQaAggFSgIIASIbChdLWVpYWjlpV0g2ZUIzZkVQMUxuazhRd3ABKAEiFQAAgZkW4Df4cspNNJZWlMZuUUxLPQ",
 "routeLabels": [  "DEFAULT_ROUTE"  ]  },  {  "distanceMeters": 112610,
"duration": "7156s",  "routeToken":
"CqwCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdLWVpYWi1UNklfT055OVlQczhhcWlRSRAFGlMKUQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhYIABADEAYQExASGAJCBBoCCAVKAggBIhsKF0tZWlhaNERXSF9PTnk5WVBzOGFxaVFJcAEoAiIVAACBmRaESp2EJS5nmwiEF8KH15_f",
 "routeLabels": [  "FUEL_EFFICIENT",  "SHORTER_DISTANCE"  ]  }  ] }

مناطق پشتیبانی شده

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

صورتحساب

Google Maps Platform برای استفاده از یک ویژگی آزمایشی هزینه اضافی دریافت نمی کند. بر اساس استفاده شما از API بر اساس پارامترهای دیگری که تنظیم کرده اید، هزینه از شما دریافت می شود.

درباره صورتحساب برای Routes API بیشتر بیاموزید .

،

Routes API می‌تواند مسیرهای رانندگی بهینه‌سازی شده برای مسافت سفر کوتاه‌تر را زمانی که مسیرهای مسافت کوتاه‌تری را فعال کنید، بازگرداند.

وقتی مسیر مسافت کمتری را درخواست می‌کنید، سرویس موارد زیر را برمی‌گرداند:

  • مسیر پیش فرض، که مسیری است که عمدتاً برای ETA بهینه شده است.
  • یک مسیر کوتاهتر بهینه شده برای به حداقل رساندن مسافت سفر در کل سفر.

چیست و چرا باید از آن استفاده کرد

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

درخواست مسیر مسافت کمتر

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

  • travelMode روی DRIVE ، BICYCLE ، یا TWO_WHEELER تنظیم کنید.
  • requestedReferenceRoutes روی SHORTER_DISTANCE تنظیم کنید.
  • یک ماسک فیلد پاسخ را برای بازگرداندن ویژگی‌های پاسخ مرتبط با یک مسیر کوتاه‌تر تنظیم کنید:
    • routes.routeLabels : هر مسیر را به عنوان DEFAULT_ROUTE ، SHORTER_DISTANCE یا DEFAULT_ROUTE_ALTERNATE شناسایی می کند.
    • routes.routeToken : یک نشانه مسیر که می توانید برای بازیابی یک مسیر سفارشی به Navigation SDK منتقل کنید.
  • هیچ ایستگاه بین راهی Via وارد نکنید .
  • پارامتر optimizeWaypointOrder را درج نکنید .
  • اختیاری : یک ماسک فیلد پاسخ را تنظیم کنید تا ویژگی‌های زیر مرتبط با مسیر پیش‌فرض و مسافت کوتاه‌تر را بازگرداند:
    • routes.distanceMeters : فاصله مسیر را برمی گرداند.
    • routes.duration : مدت زمان مسیر را برمی گرداند.

برای اطلاعات مرجع، ReferenceRoute و RouteLabel را ببینید.

درخواست مثال: مسیر مسافت کوتاهتر

کد زیر درخواستی برای مسیری با مسافت کمتر را نشان می دهد. در این مثال، شما از ماسک فیلد پاسخ برای برگرداندن فیلدهای مرتبط با مسیر پیش‌فرض و مسافت کوتاه‌تر با ماسک‌های فیلد زیر استفاده می‌کنید:

  • routes.distanceMeters
  • routes.duration
curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "requestedReferenceRoutes": ["SHORTER_DISTANCE"],
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

نمونه پاسخ مسیر کوتاه تر 

{
  "routes": [
    {
      "distanceMeters": 138943,
      "duration": "5373s",
      "routeToken": "CrsCCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXcklWWFo2cjhDZmltdk9NUDQ3aU1nUU0QBRpPCk0KGAoNCgIIAREAAAAAAIBmQBF56SYxqDm4QBISCAAQAxAGEBMQEhgCQgQaAggFIhsKF3JJVlhaLWFOQnZpbXZPTVA0N2lNZ1FNcAEoASIVAACBmRY1BjeCiUQewJGTrQ3DuHRp",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 112610,
      "duration": "7165s",
      "routeToken": "CqgCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdySVZYWjZHR0RiTzV2T01QOUpiQXlBTRAFGk8KTQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhIIABADEAYQExASGAJCBBoCCAUiGwoXcklWWFo3S09Cck81dk9NUDlKYkF5QU1wASgCIhUAAIGZFlj_CmMgGE6KGZcsE-tEywM",
      "routeLabels": [
        "SHORTER_DISTANCE"
      ]
    }
  ]
}

درخواست مثال: مسافت کوتاهتر و مسیر کارآمد سوخت

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

`

 curl -X POST -d '{
"origin": {  "location": {  "latLng": {  "latitude": 41.76904801292959,
"longitude": -72.67374935684933  }  }  },  "destination": {  "location": {
"latLng": {  "latitude": 41.823042361105024,  "longitude": -71.40933143059424  }
 }  },  "travelMode":"DRIVE",  "routingPreference":"TRAFFIC_AWARE_OPTIMAL",
"requestedReferenceRoutes": ["SHORTER_DISTANCE", "FUEL_EFFICIENT"] }' 

-H 'Content-Type: application/json' 

-H 'X-Goog-Api-Key: YOUR_API_KEY' 

-H 'X-Goog-FieldMask:
routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' 

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

پاسخ مثال: مسافت کوتاهتر و مسیر کم مصرف

در این حالت مسافت کمتر و کم مصرف ترین مسیر یکسان است، به طوری که مسیر برگشت داده می شود و routeLabel برای هر دو نوع مسیر درج می شود.

{  "routes": [  {  "distanceMeters": 138943,  "duration": "5375s",
"routeToken":
"Cr8CCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXS1laWFo4T19JcWVCM2ZFUDFMbms4UXcQBRpTClEKGAoNCgIIAREAAAAAAIBmQBFOYhBYGTy4QBIWCAAQAxAGEBMQEhgCQgQaAggFSgIIASIbChdLWVpYWjlpV0g2ZUIzZkVQMUxuazhRd3ABKAEiFQAAgZkW4Df4cspNNJZWlMZuUUxLPQ",
 "routeLabels": [  "DEFAULT_ROUTE"  ]  },  {  "distanceMeters": 112610,
"duration": "7156s",  "routeToken":
"CqwCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdLWVpYWi1UNklfT055OVlQczhhcWlRSRAFGlMKUQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhYIABADEAYQExASGAJCBBoCCAVKAggBIhsKF0tZWlhaNERXSF9PTnk5WVBzOGFxaVFJcAEoAiIVAACBmRaESp2EJS5nmwiEF8KH15_f",
 "routeLabels": [  "FUEL_EFFICIENT",  "SHORTER_DISTANCE"  ]  }  ] }

مناطق پشتیبانی شده

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

صورتحساب

Google Maps Platform برای استفاده از یک ویژگی آزمایشی هزینه اضافی دریافت نمی کند. بر اساس استفاده شما از API بر اساس پارامترهای دیگری که تنظیم کرده اید، هزینه از شما دریافت می شود.

درباره صورتحساب برای Routes API بیشتر بیاموزید .

،

Routes API می‌تواند مسیرهای رانندگی بهینه‌سازی شده برای مسافت سفر کوتاه‌تر را زمانی که مسیرهای مسافت کوتاه‌تری را فعال کنید، بازگرداند.

وقتی مسیر مسافت کمتری را درخواست می‌کنید، سرویس موارد زیر را برمی‌گرداند:

  • مسیر پیش فرض، که مسیری است که عمدتاً برای ETA بهینه شده است.
  • یک مسیر کوتاهتر بهینه شده برای به حداقل رساندن مسافت سفر در کل سفر.

چیست و چرا باید از آن استفاده کرد

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

درخواست مسیر مسافت کمتر

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

  • travelMode روی DRIVE ، BICYCLE ، یا TWO_WHEELER تنظیم کنید.
  • requestedReferenceRoutes روی SHORTER_DISTANCE تنظیم کنید.
  • یک ماسک فیلد پاسخ را برای بازگرداندن ویژگی‌های پاسخ مرتبط با یک مسیر کوتاه‌تر تنظیم کنید:
    • routes.routeLabels : هر مسیر را به عنوان DEFAULT_ROUTE ، SHORTER_DISTANCE یا DEFAULT_ROUTE_ALTERNATE شناسایی می کند.
    • routes.routeToken : یک نشانه مسیر که می توانید برای بازیابی یک مسیر سفارشی به Navigation SDK منتقل کنید.
  • هیچ ایستگاه بین راهی Via وارد نکنید .
  • پارامتر optimizeWaypointOrder را درج نکنید .
  • اختیاری : یک ماسک فیلد پاسخ را تنظیم کنید تا ویژگی‌های زیر مرتبط با مسیر پیش‌فرض و مسافت کوتاه‌تر را بازگرداند:
    • routes.distanceMeters : فاصله مسیر را برمی گرداند.
    • routes.duration : مدت زمان مسیر را برمی گرداند.

برای اطلاعات مرجع، ReferenceRoute و RouteLabel را ببینید.

درخواست مثال: مسیر مسافت کوتاهتر

کد زیر درخواستی برای مسیری با مسافت کمتر را نشان می دهد. در این مثال، شما از ماسک فیلد پاسخ برای برگرداندن فیلدهای مرتبط با مسیر پیش‌فرض و مسافت کوتاه‌تر با ماسک‌های فیلد زیر استفاده می‌کنید:

  • routes.distanceMeters
  • routes.duration
curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "requestedReferenceRoutes": ["SHORTER_DISTANCE"],
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

نمونه پاسخ مسیر کوتاه تر 

{
  "routes": [
    {
      "distanceMeters": 138943,
      "duration": "5373s",
      "routeToken": "CrsCCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXcklWWFo2cjhDZmltdk9NUDQ3aU1nUU0QBRpPCk0KGAoNCgIIAREAAAAAAIBmQBF56SYxqDm4QBISCAAQAxAGEBMQEhgCQgQaAggFIhsKF3JJVlhaLWFOQnZpbXZPTVA0N2lNZ1FNcAEoASIVAACBmRY1BjeCiUQewJGTrQ3DuHRp",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 112610,
      "duration": "7165s",
      "routeToken": "CqgCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdySVZYWjZHR0RiTzV2T01QOUpiQXlBTRAFGk8KTQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhIIABADEAYQExASGAJCBBoCCAUiGwoXcklWWFo3S09Cck81dk9NUDlKYkF5QU1wASgCIhUAAIGZFlj_CmMgGE6KGZcsE-tEywM",
      "routeLabels": [
        "SHORTER_DISTANCE"
      ]
    }
  ]
}

درخواست مثال: مسافت کوتاهتر و مسیر کارآمد سوخت

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

`

 curl -X POST -d '{
"origin": {  "location": {  "latLng": {  "latitude": 41.76904801292959,
"longitude": -72.67374935684933  }  }  },  "destination": {  "location": {
"latLng": {  "latitude": 41.823042361105024,  "longitude": -71.40933143059424  }
 }  },  "travelMode":"DRIVE",  "routingPreference":"TRAFFIC_AWARE_OPTIMAL",
"requestedReferenceRoutes": ["SHORTER_DISTANCE", "FUEL_EFFICIENT"] }' 

-H 'Content-Type: application/json' 

-H 'X-Goog-Api-Key: YOUR_API_KEY' 

-H 'X-Goog-FieldMask:
routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' 

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

پاسخ مثال: مسافت کوتاهتر و مسیر کم مصرف

در این حالت مسافت کمتر و کم مصرف ترین مسیر یکسان است، به طوری که مسیر برگشت داده می شود و routeLabel برای هر دو نوع مسیر درج می شود.

{  "routes": [  {  "distanceMeters": 138943,  "duration": "5375s",
"routeToken":
"Cr8CCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXS1laWFo4T19JcWVCM2ZFUDFMbms4UXcQBRpTClEKGAoNCgIIAREAAAAAAIBmQBFOYhBYGTy4QBIWCAAQAxAGEBMQEhgCQgQaAggFSgIIASIbChdLWVpYWjlpV0g2ZUIzZkVQMUxuazhRd3ABKAEiFQAAgZkW4Df4cspNNJZWlMZuUUxLPQ",
 "routeLabels": [  "DEFAULT_ROUTE"  ]  },  {  "distanceMeters": 112610,
"duration": "7156s",  "routeToken":
"CqwCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdLWVpYWi1UNklfT055OVlQczhhcWlRSRAFGlMKUQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhYIABADEAYQExASGAJCBBoCCAVKAggBIhsKF0tZWlhaNERXSF9PTnk5WVBzOGFxaVFJcAEoAiIVAACBmRaESp2EJS5nmwiEF8KH15_f",
 "routeLabels": [  "FUEL_EFFICIENT",  "SHORTER_DISTANCE"  ]  }  ] }

مناطق پشتیبانی شده

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

صورتحساب

Google Maps Platform برای استفاده از یک ویژگی آزمایشی هزینه اضافی دریافت نمی کند. بر اساس استفاده شما از API بر اساس پارامترهای دیگری که تنظیم کرده اید، هزینه از شما دریافت می شود.

درباره صورتحساب برای Routes API بیشتر بیاموزید .