نقاط ناوبری

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

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

  • location شامل مقدار طول و عرض جغرافیایی نقطه ناوبری است. این مکان همیشه بسیار نزدیک به شبکه جاده خواهد بود و نشان دهنده یک توقف یا نقطه شروع ایده آل برای پیمایش به و از یک مکان است. این نقطه عمداً کمی از خط مرکزی جاده منحرف شده است تا به وضوح کنار جاده که مکان در آن قرار دارد مشخص شود.
  • restricted_travel_modes فهرستی از حالت‌های سفر است که نقطه ناوبری از آن‌ها قابل دسترسی نیست:
    • "DRIVE" حالت سفر مربوط به مسیرهای رانندگی است.
    • "WALK" حالت سفر مربوط به مسیرهای پیاده روی است.
  • road_name شامل نام جاده ای است که نقطه ناوبری از آن جابجا شده است.

نقاط ناوبری برای اکثر مکان‌هایی که مکان دقیقی دارند، مانند آدرس خیابان‌ها، ساختمان‌ها و مؤسسات بازگردانده می‌شوند. مکان‌هایی که نمایانگر مناطق بزرگ هستند، مانند شهرها و مناطق، که یک مکان دقیق می‌تواند مبهم باشد، ممکن است هیچ نقطه ناوبری را برنگردانند.

اطلاعیه مهاجرت

از 17 آوریل، اکنون باید NAVIGATION_POINTS پارامتر محاسبات اضافی را در درخواست دریافت نقاط پیمایش ارائه کنید. مشتریان می توانند این را با تأیید اینکه فیلد road_name در برخی از نقاط ناوبری برگردانده شده است و اینکه فیلد location در هر نقطه ناوبری دارای چهار زیرفیلد زیر است ( lat , lng , latitude , longitude ) آزمایش می کنند.

علاوه بر این، شما باید به جای فیلدهای location.lat و location.longitude به فیلدهای location.latitude و location.lng مهاجرت کنید. در نسخه آینده، درخواست‌هایی که حاوی پارامتر محاسبات اضافی NAVIGATION_POINTS نیستند، هیچ نقطه ناوبری را در پاسخ شامل نمی‌شوند و فیلدهای location.latitude و location.longitude دیگر برگردانده نمی‌شوند.

درخواست جزئیات

شما می توانید نقاط ناوبری را در انواع درخواست های زیر بدست آورید:

برای هر یک از این درخواست‌ها، این پارامتر را ارائه می‌کنید: extra_computations=NAVIGATION_POINTS .

درخواست نمونه

جستار زیر برای بدست آوردن نقاط ناوبری برای رستورانی در Mountain View، کالیفرنیا، ایالات متحده، از geocoding مکان استفاده می کند:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY

پاسخ نمونه

پاسخ از پرس و جو بالا آرایه ای از نقاط ناوبری را نشان می دهد:

{
  "navigation_points": [
    {
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Castro Street"
    },
    {
      "location": {
        "lat": 37.394273,
        "lng": -122.0793078,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Wild Cherry Lane"
    },
    {
      "location": {
        "lat": 37.3941202,
        "lng": -122.0789189,
      },
      "restricted_travel_modes": ["DRIVE"]
    }
  ]
}

بازخورد

این یک ویژگی آزمایشی است. از بازخورد در geocoding-feedback-channel@google.com سپاسگزاریم.