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

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

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

درخواست‌ها

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

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

پارامترهای الزامی

  • امتیاز

    نقاطی که باید چسبانده شوند. پارامتر نقاط فهرستی از جفت‌های عرض جغرافیایی/طول جغرافیایی را می‌پذیرد. مقادیر طول و عرض جغرافیایی را با ویرگول از هم جدا کنید. مختصات را با نویسه خط عمودی جدا کنید: «|». برای مثال: 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

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 پاسخی را در قالب نشان‌داده‌شده در نشانی وب درخواست برمی‌گرداند.

{
  "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",
      },
    ],
}

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

NearestRoadsResponse

فیلد الزامی نوع شرح
اختیاری Array<SnappedPoint>

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

برای اطلاعات بیشتر، SnappedPoint را ببینید.

SnappedPoint

فیلد الزامی نوع شرح
الزامی LatitudeLongitudeLiteral برای اطلاعات بیشتر، LatitudeLongitudeLiteral را ببینید.
الزامی رشته

شناسه یکتای مکان. همه شناسه‌های مکان برگشتی از «میانای برنامه‌سازی کاربردی Roads» با بخش‌های جاده مطابقت دارند.

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

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

LatitudeLongitudeLiteral

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

فیلد الزامی نوع شرح
الزامی شماره

عرض جغرافیایی به‌صورت درجه اعشاری
الزامی شماره

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