ناوبری بهبودیافته به فرودگاه‌ها

نقشه فرودگاه که نشانگرهای پایانه را نشان می‌دهد

فرودگاه‌ها مجموعه‌های بزرگ با چندین پایانه هستند و ناوبری دقیق برای رسیدن و حرکت به‌موقع ضروری است. Google Maps Geocoding API معمولاً مختصاتی (عرض جغرافیایی/طول جغرافیایی) را برمی‌گرداند که در بیشتر موارد مرکز ثقل مجتمع فرودگاهی بزرگ است. این برنامه ابزاری تعاملی است که به‌طور خاص برای کمک به کاربران در مشخص کردن و تجسم مکان‌های دقیق در یک مکان پیچیده بزرگ‌تر مانند پایانه‌های خاص یا نقاط سوار/پیاده کردن در فرودگاه طراحی شده است.

تصویر

نحوه دستیابی به این هدف:

جستجوی فرودگاه/محل: کاربران با جستجوی مکان اصلی (مثلاً «فرودگاه بین‌المللی ایندیرا گاندی») بااستفاده از ورودی «تکمیل خودکار مکان‌های Google» که به هند محدود است شروع می‌کنند.

Sub-Location Discovery: Once a primary location is selected, the script uses the Google Places API to fetch details, crucially including any listed "sub-destinations" associated with that place (like Terminal 1, Terminal 3, specific gates, etc., if available in Google's data).

نگاشت بصری: این اسکریپت از Geocoding API برای یافتن مختصات مکان اصلی و مقصدهای فرعی آن استفاده می‌کند.

سپس مکان اصلی را نمایش می‌دهد و نشانگرهای متمایز و قابل‌کلیک (دایره‌های آبی) را روی نقشه برای هر مقصد فرعی شناسایی‌شده قرار می‌دهد.

شناسایی دقیق: کلیک کردن روی نشانگر مقصد فرعی آن را برجسته می‌کند (سبز می‌شود) و InfoWindow را باز می‌کند که نام آن و سایر جزئیات دردسترس (مانند نشانی یا نوع) را نشان می‌دهد و به کاربر امکان می‌دهد تأیید کند که نقطه خاص صحیح را انتخاب کرده است. نمای بافتاری: نقشه به‌طور خودکار نمای خود را تنظیم می‌کند (fitBounds) تا تأیید کند همه نشانگرهای مربوط (مکان اصلی + مقصدهای فرعی) به‌وضوح نمایان هستند.

میاناهای برنامه‌سازی کاربردی «پلاتفرم Google Maps» در برنامه ناوبری فرودگاه

این سند میاناهای برنامه‌سازی کاربردی اصلی «پلاتفرم Google Maps» و پارامترهای آن‌ها را که در برنامه نمایشی ارائه‌شده «پیمایش به فرودگاه» استفاده شده است توضیح می‌دهد. این برنامه از چندین سرویس برای ارائه نمایش نقشه، جستجوی مکان، اطلاعات دقیق مکان، و اطلاعات آماری پیشرفته مکان استفاده می‌کند.

۱. مقداردهی اولیه و نمایش نقشه

پایه این برنامه همان نقشه تعاملی است.

  • میانای برنامه‌سازی کاربردی استفاده‌شده: google.maps.Map (از Maps JavaScript API)
  • هدف: ایجاد و نمایش نقشه تعاملی در صفحه وب.
  • پارامترهای کلیدی:
    • center: مرکز جغرافیایی اولیه نقشه را تعریف می‌کند. در این برنامه، در ابتدا روی مختصات دهلی ({ lat: 28.461835685621395, lng: 77.05004035761647 }) تنظیم شده است.
    • ‫zoom: سطح بزرگ‌نمایی اولیه نقشه را تنظیم می‌کند. DEFAULT_ZOOM_LEVEL (۱۵) برای نمای نزدیک استفاده می‌شود.
    • mapId: شناسه یکتایی برای سبک نقشه پیکربندی‌شده در Google Cloud Console.

۲. جستجوی جاها و تکمیل خودکار

عملکرد نوار جستجو با Places API ارائه می‌شود.

  • میانای برنامه‌سازی کاربردی استفاده‌شده: google.maps.places.Autocomplete (از کتابخانه جاهای Maps JavaScript API)
  • هدف: تکمیل پیش‌بینی‌کننده نوشتار را برای جستجوهای جغرافیایی هنگام تایپ کردن کاربر ارائه می‌دهد و مکان‌های مرتبط مانند فرودگاه‌ها را پیشنهاد می‌کند.
  • پارامترهای کلیدی:
    • input: عنصر ورودی HTML‏ (#search-input) که کاربر پُرسمان خود را در آن تایپ می‌کند.
    • componentRestrictions: نتایج جستجو را به کشور خاصی فیلتر می‌کند. در اینجا، { country: 'in' } نتایج را به هند محدود می‌کند.
    • fields: فیلدهای داده‌ای را که باید برای مکان انتخاب‌شده برگردانده شود مشخص می‌کند. ['place_id'] در ابتدا فقط برای بازیابی شناسه یکتای مکان استفاده می‌شود تا انتقال داده بهینه‌سازی شود.
  • نحوه استفاده از «تکمیل خودکار»
    // Initialize Autocomplete
    const autocomplete = new google.maps.places.Autocomplete(input, {
      componentRestrictions: { country: 'in' },
      fields: ['place_id'],
    });

    // Add listener to the Autocomplete
    autocomplete.addListener('place_changed', async () => {
      const place = autocomplete.getPlace();
      if (!place.place_id) {
        return;
      }
      // Once a place is selected, fetch details
      await getPlaceDetails(place.place_id);
    });

۳. بازیابی اطلاعات دقیق مکان و مدیریت زیرمقصدها

وقتی مکانی از پیشنهادهای تکمیل خودکار انتخاب می‌شود، جزئیات جامع‌تری واکشی می‌شود.

  • میانای برنامه‌سازی کاربردی استفاده‌شده: Places API (ازطریق فراخوانی مستقیم fetch به https://places.googleapis.com/v1/places/{placeId})
  • هدف: بازیابی جزئیات غنی درباره مکانی خاص، ازجمله نام نمایشی، نشانی، انواع، و مهم‌تر از همه، subDestinations آن (برای نمونه، پایانه‌های مجزا یا مناطق مهم در مجموعه‌ای بزرگ‌تر مانند فرودگاه).
  • پارامترهای کلیدی در نشانی وب:
    1. ‫{placeId}: شناسه یکتای مکان انتخاب‌شده.
    2. fields: فیلدهای داده دقیق را برای بازیابی مشخص می‌کند. این برنامه id، displayName، subDestinations، types، و formattedAddress را درخواست می‌کند. این کار برای کنترل هزینه‌ها و دریافت فقط داده‌های ضروری بسیار مهم است.
  • نحوه دریافت subDestinations با داشتن مکان
async function getPlaceDetails(placeId) {
  // Construct the URL for the Places API (v1) details endpoint
  // The 'fields' parameter is crucial for requesting subDestinations
  const url = `https://places.googleapis.com/v1/places/${placeId}?key=YOUR_API_KEY&fields=id,displayName,subDestinations,types,formattedAddress`;

  const response = await fetch(url);
  const data = await response.json();

  // Accessing subDestinations from the Places API response
  if (data.subDestinations && data.subDestinations.length > 0) {
    for (const subDestination of data.subDestinations) {
      // Each subDestination object contains an 'id' and 'displayName'
      console.log(`Sub-destination ID: ${subDestination.id}`);
      console.log(`Sub-destination Name: ${subDestination.displayName?.text}`);
      // This subDestination.id is then used in a geocoding call (as shown in section 4)
    }
  }
}

**Handling `subDestinations`:** When the Places API returns
`subDestinations`, the application initiates a process for each one:
1.  **Geocoding:** It uses the `google.maps.Geocoder` to convert
    each `subDestination.id` into its precise geographical coordinates
    (`lat`, `lng`).
1.  **Marker Placement:** A distinct marker is added to the map for
    each sub-destination. These markers are styled with a blue circle icon
    to differentiate them.
1.  **Map Bounds Adjustment:** The `google.maps.LatLngBounds` object
    is used to dynamically expand the map's view to encompass all retrieved
    sub-destinations, verifying they are all visible within the current map
    frame.
1.  **Interactive Information Window:** A `click` listener is
    attached to each sub-destination marker. When clicked, the marker's
    icon changes to green, and an `InfoWindow` appears, displaying the
    sub-destination's name, address, and types. This provides immediate,
    detailed context to the user.

۴. زمین‌کدیابی و زمین‌کدیابی معکوس: واکشی جزئیات برای زیرمقصدها

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

  • میانای برنامه‌سازی کاربردی استفاده‌شده: google.maps.Geocoder (از Maps JavaScript API) و Geocoding API (ازطریق تماس مستقیم fetch با https://maps.googleapis.com/maps/api/geocode/json)
  • هدف:
    • google.maps.Geocoder: برای تبدیل placeId (دریافت‌شده از «تکمیل خودکار» یا Places API) به مختصات جغرافیایی (lat، lng) و نمای دید استفاده می‌شود تا نقشه بتواند به‌درستی روی مکان انتخاب‌شده و زیرمقصد‌های آن متمرکز و بزرگ‌نمایی شود.
    • Geocoding API (fetch): برای زمین‌کدیابی معکوس (تبدیل عرض و طول جغرافیایی به نشانی قابل‌خواندن برای انسان) و بازیابی داده‌های مکان پیشرفته مانند طرح کلی ساختمان و نقاط پیمایش استفاده می‌شود.
  • پارامترهای کلیدی:
    • ‫google.maps.Geocoder.geocode():
      • placeId: «شناسه مکان» برای زمین‌کدیابی.
      • ‫location: شیء LatLng برای زمین‌کدیابی معکوس.
    • فراخوانی Geocoding API fetch:
      • latlng: مختصات طول و عرض جغرافیایی برای زمین‌کدیابی معکوس.
      • extra_computations=BUILDING_AND_ENTRANCES: این پارامتر مهم داده‌های بیشتری را درخواست می‌کند، به‌ویژه ردپای ساختمان و اطلاعات ورودی، که سپس برای نمایش طرح کلی ساختمان و نقاط ناوبری استفاده می‌شود.

نحوه استفاده از شناسه subDestination برای واکشی جزئیات بیشتر (مثلاً مکان، نشانی قالب‌بندی‌شده، انواع)

function geocodeAndAddMarker(subDestination, bounds) {
  return new Promise((resolve, reject) => {
    const geocoder = new google.maps.Geocoder();
    // Using the subDestination.id to geocode and get location details
    geocoder.geocode({ placeId: subDestination.id }, (results, status) => {
      if (status === "OK" && results[0]) {
        const location = results[0].geometry.location;
        const displayName = subDestination.displayName?.text || "Sub-destination";
        const formattedAddress = results[0].formatted_address; // Further detail from Geocoding
        const types = results[0].types; // Further detail from Geocoding

        const marker = new google.maps.Marker({
          map: map,
          position: location,
          title: displayName,
          icon: {
            path: google.maps.SymbolPath.CIRCLE,
            fillColor: 'blue',
            fillOpacity: 0.6,
            strokeWeight: 0,
            scale: 8
          }
        });

        marker.addListener('click', () => {
          marker.setIcon({
            path: google.maps.SymbolPath.CIRCLE,
            fillColor: 'green',
            fillOpacity: 0.6,
            strokeWeight: 0,
            scale: 8
          });
          const infowindow = new google.maps.InfoWindow({
            content: `<b>${displayName}</b><br><p>Address: ${formattedAddress}</p><p>Types: ${types.join(', ')}</p>`,
          });
          infowindow.open(map, marker);
        });
        bounds.extend(location);
        resolve(true);
      } else {
        reject(new Error(`Geocoding failed for placeId: ${subDestination.id}`));
      }
    });
  });
}

۵. درحال نمایش نشانگرها

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

  • میانای برنامه‌سازی کاربردی استفاده‌شده: google.maps.Marker (از Maps JavaScript API) و google.maps.marker.AdvancedMarkerElement با google.maps.marker.PinElement (از کتابخانه نشانگر Maps JavaScript API)
  • هدف:
    • google.maps.Marker: Used for the initial draggable marker (though draggable is set to false in the provided code, it's part of its capability) and for basic sub-destination markers as described in section 3.
    • AdvancedMarkerElement و PinElement: برای نشانگرهای نقطه پیمایش که ازنظر بصری متمایزتر هستند استفاده می‌شود و امکان سبک سفارشی برای سنجاق نشانگر را فراهم می‌کند.
  • پارامترهای کلیدی:
    • ‫position: مختصات LatLng که نشانگر در آن قرار خواهد گرفت.
    • map: نمونه نقشه که نشانگر روی آن نمایش داده خواهد شد.
    • title: نوشتاری که هنگام نگه داشتن نشانگر نمایش داده می‌شود.
    • icon: نمادهای سفارشی را برای google.maps.Marker (مثلاً google.maps.SymbolPath.CIRCLE با رنگ‌های سفارشی) مجاز می‌کند.
    • content: برای AdvancedMarkerElement، این گزینه امکان جاسازی محتوای HTML سفارشی را فراهم می‌کند، ازجمله PinElement برای سنجاق‌های ازپیش سبک‌بندی‌شده.
    • پارامترهای PinElement: background، borderColor، glyphColor، scale برای سفارشی‌سازی بصری.

‫۶. درحال نمایش رئوس مطالب ساختمان

این برنامه می‌تواند ردپای ساختمان‌ها را به‌صورت دیداری نشان دهد.

  • میانای برنامه‌سازی کاربردی استفاده‌شده: google.maps.Data (از Maps JavaScript API)
  • هدف: برای نمایش داده‌های جغرافیایی، مانند طرح کلی ساختمان (که به‌عنوان GeoJSON display_polygon از Geocoding API extra_computations برگردانده می‌شود).
  • پارامترهای کلیدی:
    • ‫map: نمونه نقشه‌ای که لایه داده روی آن اعمال می‌شود.
    • ‫style: ظاهر بصری عارضه‌های GeoJSON را تعریف می‌کند (برای مثال، strokeColor،‏ fillColor،‏ fillOpacity).
    • addGeoJson(): روش افزودن داده‌های GeoJSON به لایه.

‫۷. مرزهای نقشه و بزرگ‌نمایی

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

  • میانای برنامه‌سازی کاربردی استفاده‌شده: google.maps.LatLngBounds (از Maps JavaScript API)
  • هدف: تنظیم پویای نمای نقشه برای گنجاندن مجموعه‌ای از نقاط جغرافیایی (مثلاً مکان اصلی و همه مقصدهای فرعی آن).
  • روش‌های کلیدی:
    • ‫extend(location): نقطه LatLng را به مرزها اضافه می‌کند، و درصورت لزوم آن‌ها را گسترش می‌دهد.
    • fitBounds(bounds): مرکز نقشه و سطح بزرگ‌نمایی را تنظیم می‌کند تا کل منطقه تعریف‌شده توسط شیء LatLngBounds را نمایش دهد.

با ترکیب این میاناهای برنامه‌سازی کاربردی «پلاتفرم Google Maps»، برنامه تجربه جامع و تعاملی‌ای برای جستجوی مکان‌ها، مشاهده جزئیات آن‌ها، و تجسم اطلاعات جغرافیایی مرتبط مانند زیرمقصدها و طرح‌های کلی ساختمان ارائه می‌دهد.

ملاحظات پیاده‌سازی توجه داشته باشید که این ویژگی در همه مناطق فرودگاه کار نمی‌کند و منوط به دردسترس بودن داده‌های (پایانه فرودگاه) است.

منابع Geocoding API Places API Maps Javascript API

نویسندگان: