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

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 API با بخش‌های جاده مطابقت دارند.

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

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

LatitudeLongitudeLiteral

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

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

عرض جغرافیایی به درجه اعشاری
الزامی شماره

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