در طول یک مسیر توقفی تعیین کنید

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

شما می‌توانید به یکی از دو روش زیر، در طول یک مسیر، مثلاً برای سوار یا پیاده کردن مسافر، توقف تعیین کنید:

  • اضافه کردن یک نقطه میانی : این گزینه پیش‌فرض است. یک نقطه میانی بین مبدا و مقصد در آرایه intermediates اضافه کنید. موتور مسیریابی، نقطه میانی را به نزدیکترین جاده قابل پیمایش متصل می‌کند و مسیر را به بخش‌های RouteLeg که توسط آن ایستگاه به هم متصل شده‌اند، تقسیم می‌کند.
  • مشخص کردن یک توقفگاه خودرو : اگر می‌خواهید موتور مسیریابی تجزیه و تحلیل‌های بیشتری انجام دهد تا از بخش‌های جاده‌ای نامناسب برای توقف - مانند بزرگراه‌ها، تونل‌ها یا پل‌های هوایی - جلوگیری کند، در یک نقطه مسیر، vehicleStopover: true را تنظیم کنید.

یک نقطه مسیر میانی اضافه کنید

برای تعیین ایستگاه در طول مسیر، یک نقطه میانی به آرایه intermediates در درخواست خود اضافه کنید.

اضافه کردن یک نقطه میانی اثرات زیر را دارد:

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

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

مثال: یک نقطه مسیر میانی اضافه کنید

مثال زیر نحوه تعیین ایستگاه در طول یک مسیر را با اضافه کردن یک نقطه میانی در درخواست POST computeRoutes نشان می‌دهد:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

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

برای مناسب بودن زمان تحویل و تحویل، یک توقفگاه بین راهی برای وسیله نقلیه مشخص کنید

اگرچه یک نقطه مسیر میانی استاندارد به نزدیکترین جاده متصل می‌شود، اما آن جاده همیشه برای توقف وسیله نقلیه مناسب نیست. وقتی می‌خواهید موتور مسیریابی تجزیه و تحلیل بیشتری برای ارزیابی مناسب بودن جاده برای سوار یا پیاده کردن انجام دهد، گزینه vehicleStopover: true را در نقطه مسیر تنظیم کنید.

وقتی vehicleStopover: true تنظیم می‌کنید، موتور مسیریابی بخش‌های جاده‌ای کاندید را ارزیابی می‌کند و تلاش می‌کند از جاده‌هایی که برای توقف مناسب نیستند، مانند آزادراه‌ها، تونل‌ها و پل‌های هوایی، اجتناب کند.

برای مثال، مکانی را در نظر بگیرید که در آن یک جاده سطحی مستقیماً از روی بزرگراهی درون یک تونل عبور می‌کند: * نقطه مسیر میانی استاندارد : اگر از نظر هندسی به مختصات شما نزدیک‌تر باشد، به بزرگراه یا تونل زیرین متصل می‌شود. * توقفگاه خودرو : تجزیه و تحلیل‌های بیشتری را برای دور زدن بزرگراه و تونل انجام می‌دهد و توقفگاه را به یک جاده سطحی مناسب برای توقف متصل می‌کند.

مثال: مشخص کردن وسیله نقلیه، توقف در یک نقطه مسیر

مثال زیر نحوه تنظیم vehicleStopover: true برای یک نقطه مسیر میانی در یک درخواست POST کامل نشان می‌دهد:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      },
      "vehicleStopover": true
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

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