نزدیکترین جاده ها

Roads API تا ۱۰۰ مختصات مستقل را دریافت می‌کند و نزدیک‌ترین بخش جاده را برای هر نقطه برمی‌گرداند. نقاط ارسالی نیازی به بخشی از یک مسیر پیوسته ندارند.

اگر با نقاط GPS متوالی کار می‌کنید، از Snap to Roads استفاده کنید.

درخواست‌ها

درخواست به نزدیکترین جاده‌ها باید با استفاده از HTTPS ارسال شود و فرم زیر را دارد:

https://roads.googleapis.com/v1/nearestRoads?parameters&key=YOUR_API_KEY

پارامترهای مورد نیاز

  • امتیازها

    نقاطی که باید برش داده شوند. پارامتر points لیستی از جفت‌های عرض/طول جغرافیایی را می‌پذیرد. مقادیر عرض و طول جغرافیایی را با کاما از هم جدا کنید. مختصات را با کاراکتر پایپ "|" از هم جدا کنید. برای مثال: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796 .

مثال‌ها

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

آدرس اینترنتی 

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

حلقه زدن 

curl -L -X GET 'https://roads.googleapis.com/v1/nearestRoads?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796&key=YOUR_API_KEY'

پاسخ‌ها

برای هر درخواست معتبر، Roads API پاسخی را در قالب مشخص شده در URL درخواست برمی‌گرداند.

{
  "snappedPoints":
    [
      {
        "location":
          { "latitude": 60.170878428876755, "longitude": 24.94269540970182 },
        "originalIndex": 0,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.17087741412199, "longitude": 24.942695474405202 },
        "originalIndex": 1,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.170875416131736, "longitude": 24.942695601802203 },
        "originalIndex": 2,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
    ],
}

پاسخ از طرحواره زیر استفاده می‌کند.

پاسخ به نزدیکترین جاده‌ها

میدان مورد نیاز نوع توضیحات
اختیاری آرایه <SnappedPoint>

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

برای اطلاعات بیشتر به SnappedPoint مراجعه کنید.

اسنپ‌پوینت

میدان مورد نیاز نوع توضیحات
مورد نیاز عرض جغرافیاییطول جغرافیاییلفظی برای اطلاعات بیشتر به LatitudeLongitudeLiteral مراجعه کنید.
مورد نیاز رشته

یک شناسه منحصر به فرد برای یک مکان. تمام شناسه‌های مکانی که توسط Roads API برگردانده می‌شوند، مربوط به بخش‌های جاده هستند.

اختیاری شماره

یک عدد صحیح که مقدار متناظر در درخواست اصلی را نشان می‌دهد. هر مقدار در درخواست باید به یک مقدار snapped در پاسخ نگاشت شود. با این حال، اگر interpolate=true تنظیم کرده باشید یا اگر از nearest Roads استفاده می‌کنید، ممکن است پاسخ شامل مختصات بیشتری نسبت به درخواست باشد. مقادیر interpolated دارای originalIndex نخواهند بود. این مقادیر از 0 اندیس‌گذاری می‌شوند، بنابراین نقطه‌ای با originalIndex برابر با 4 مقدار snapped پنجمین عرض/طول جغرافیایی ارسال شده به پارامتر path خواهد بود. نقاط Nearest Roads ممکن است شامل چندین نقطه برای مختصات واحد با location یا placeId متفاوت باشند.

عرض جغرافیاییطول جغرافیاییلفظی

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

میدان مورد نیاز نوع توضیحات
مورد نیاز شماره

عرض جغرافیایی بر حسب درجه اعشاری

مورد نیاز شماره

طول جغرافیایی بر حسب درجه اعشاری