שיפור הניווט לשדות תעופה

מפה של שדה תעופה עם סמנים של טרמינלים

שדות תעופה הם מתחמים גדולים עם כמה טרמינלים, וניווט מדויק הוא קריטי כדי להגיע בזמן לטיסות. בדרך כלל, Google Maps Geocoding API מחזיר קואורדינטה (קו רוחב/קו אורך) שברוב המקרים תהיה מרכז הכובד של מתחם שדה התעופה הגדול. האפליקציה הזו היא כלי אינטראקטיבי שנועד לעזור למשתמשים לאתר מיקומים מדויקים במתחם גדול, כמו טרמינלים ספציפיים או נקודות איסוף והורדה בשדה תעופה, ולראות אותם בצורה ויזואלית.

תמונה

ככה זה עובד:

חיפוש שדה תעופה או מקום: המשתמשים מתחילים בחיפוש של מיקום ראשי (למשל, "נמל התעופה הבינלאומי אינדירה גנדי") באמצעות קלט ההשלמה האוטומטית למקומות של Google, שמוגבל להודו.

גילוי מיקומי משנה: אחרי שבוחרים מיקום ראשי, הסקריפט משתמש ב-Google Places API כדי לאחזר פרטים, כולל "יעדי משנה" שמשויכים לאותו מקום (כמו טרמינל 1, טרמינל 3, שערים ספציפיים וכו', אם הם זמינים בנתונים של Google).

מיפוי חזותי: הסקריפט משתמש ב-Geocoding API כדי למצוא את הקואורדינטות של המיקום הראשי ושל יעדי המשנה שלו.

לאחר מכן, המערכת מציגה את המיקום הראשי ומציבה במפה סמנים נפרדים שאפשר ללחוץ עליהם (עיגולים כחולים) לכל יעד משנה שזוהה.

זיהוי מדויק: לחיצה על סמן של יעד משנה מדגישה אותו (הוא הופך לירוק) ופותחת חלון מידע עם השם שלו ופרטים זמינים אחרים (כמו כתובת או סוג). כך המשתמש יכול לוודא שהוא בחר את הנקודה הספציפית הנכונה. תצוגה מותאמת מיקום: המפה מתאימה את התצוגה שלה באופן אוטומטי (fitBounds) כדי לוודא שכל הסמנים הרלוונטיים (המיקום הראשי ויעדי המשנה) מוצגים בבירור.

ממשקי ה-API של הפלטפורמה של מפות Google באפליקציית הניווט בשדה התעופה

במאמר הזה מוסברים ממשקי ה-API העיקריים של Google Maps Platform והפרמטרים שלהם, שבהם נעשה שימוש באפליקציית ההדגמה "ניווט לשדה התעופה". האפליקציה משתמשת בכמה שירותים כדי להציג מפה, לחפש מקומות, להציג מידע מפורט על מקומות ולספק תובנות מתקדמות על המיקום.

1. אתחול והצגה של מפה

הבסיס של האפליקציה הוא המפה האינטראקטיבית עצמה.

  • ממשק ה-API שבו נעשה שימוש: google.maps.Map (מ-Maps JavaScript API)
  • המטרה: ליצור את המפה האינטראקטיבית ולהציג אותה בדף האינטרנט.
  • פרמטרים מרכזיים:
    • ‫center: מגדיר את המרכז הגיאוגרפי הראשוני של המפה. באפליקציה הזו, הוא מוגדר בהתחלה לקואורדינטות של דלהי ({ lat: 28.461835685621395, lng: 77.05004035761647 }).
    • ‫zoom: מגדיר את רמת הזום הראשונית של המפה. DEFAULT_ZOOM_LEVEL (15) משמשת לצילום תקריב.
    • ‫mapId: מזהה ייחודי של סגנון מפה שהוגדר במסוף Google Cloud.

2. חיפוש מקומות והשלמה אוטומטית

הפונקציונליות של שורת החיפוש מופעלת על ידי Places API.

  • ממשק ה-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);
    });

3. אחזור מידע מפורט על מקומות וטיפול ביעדי משנה

אחרי שבוחרים מקום מההצעות של ההשלמה האוטומטית, המערכת מאחזרת פרטים מקיפים יותר.

  • ממשק ה-API שבו נעשה שימוש: Places API (באמצעות קריאה ישירה של fetch אל https://places.googleapis.com/v1/places/{placeId})
  • מטרה: לאחזר פרטים עשירים על מקום ספציפי, כולל השם המוצג, הכתובת, הסוגים שלו, וחשוב מכך, subDestinations שלו (למשל, טרמינלים נפרדים או אזורים חשובים בתוך מתחם גדול יותר כמו שדה תעופה).
  • פרמטרים מרכזיים בכתובת ה-URL:
    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.

4. המרת כתובות לקואורדינטות (geocoding) והמרת קואורדינטות לכתובות (reverse geocoding): אחזור פרטים של יעדי משנה

האפליקציה משתמשת בהמרת כתובות לקואורדינטות לשתי מטרות עיקריות: המרת מזהי מקומות לקואורדינטות והמרת קואורדינטות בחזרה לפרטי מיקום. בקטע הזה מוסבר איך להשתמש בהמרת כתובות לקואורדינטות כדי לקבל מידע מפורט על יעדי משנה.

  • ממשקי ה-API שבהם נעשה שימוש: 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}`));
      }
    });
  });
}

5. הצגת סמנים

סמנים משמשים להדגשת מיקומים ספציפיים במפה.

  • ממשקי ה-API שבהם נעשה שימוש: google.maps.Marker (מ-Maps JavaScript API) ו-google.maps.marker.AdvancedMarkerElement עם google.maps.marker.PinElement (מספריית הסמנים של Maps JavaScript API)
  • המטרה:
    • ‫google.maps.Marker: משמש לסמן הראשוני שניתן לגרירה (למרות ש-draggable מוגדר כ-false בקוד שסופק, זה חלק מהיכולת שלו) ולסמנים בסיסיים של יעדי משנה, כפי שמתואר בסעיף 3.
    • ‫AdvancedMarkerElement ו-PinElement: משמשים לסמנים של נקודות הניווט, שהם בולטים יותר מבחינה חזותית, ומאפשרים עיצוב בסגנון אישי של הסיכה של הסמן.
  • פרמטרים מרכזיים:
    • ‫position: הקואורדינטות של LatLng שבהן הסמן יוצב.
    • ‫map: המופע של המפה שבו יוצג הסמן.
    • ‫title: הטקסט שמוצג כשמעבירים את העכבר מעל הסמן.
    • ‫icon: מאפשר סמלים בהתאמה אישית ל-google.maps.Marker (למשל, google.maps.SymbolPath.CIRCLE עם צבעים בהתאמה אישית).
    • content: ב-AdvancedMarkerElement, המאפיין הזה מאפשר להטמיע תוכן HTML בהתאמה אישית, כולל PinElement לסיכות מעוצבות מראש.
    • פרמטרים של PinElement: ‏background, ‏borderColor, ‏glyphColor, ‏scale להתאמה אישית חזותית.

6. הצגת קווי המתאר של המבנה

האפליקציה יכולה להציג באופן חזותי את השטח של מבנים.

  • ממשק ה-API שבו נעשה שימוש: google.maps.Data (מ-Maps JavaScript API)
  • המטרה: להציג נתונים גיאוגרפיים, כמו קווי מתאר של מבנים (מוחזרים כ-GeoJSON display_polygon מה-extra_computations של Geocoding API).
  • פרמטרים מרכזיים:
    • ‫map: המכונה של המפה ששכבת הנתונים חלה עליה.
    • ‫style: מגדיר את המראה החזותי של תכונות GeoJSON (למשל, strokeColor, fillColor, fillOpacity).
    • ‫addGeoJson(): שיטה להוספת נתוני GeoJSON לשכבה.

7. גבולות המפה ושינוי מרחק התצוגה

מוודאים שתצוגת המפה כוללת את כל המיקומים הרלוונטיים.

  • ממשק ה-API שבו נעשה שימוש: google.maps.LatLngBounds (מ-Maps JavaScript API)
  • המטרה: להתאים באופן דינמי את אזור התצוגה של המפה לאוסף של נקודות גיאוגרפיות (למשל, המקום הראשי וכל יעדי המשנה שלו).
  • שיטות עיקריות:
    • ‫extend(location): הוספת נקודת LatLng לגבולות, והרחבה שלהם במקרה הצורך.
    • ‫fitBounds(bounds): התאמת מרכז המפה ורמת הזום כדי להציג את כל האזור שמוגדר על ידי האובייקט LatLngBounds.

השילוב של ממשקי ה-API האלה של Google Maps Platform מאפשר לאפליקציה לספק חוויה מקיפה ואינטראקטיבית לחיפוש מקומות, להצגת הפרטים שלהם ולהצגת מידע גיאוגרפי קשור, כמו יעדי משנה וקווי מתאר של מבנים.

שיקולים להטמעה חשוב לזכור שהאפשרות הזו לא פועלת בכל אזורי שדות התעופה, והיא תלויה בזמינות הנתונים (של טרמינל שדה התעופה).

מקורות מידע Geocoding API Places API Maps Javascript API

מחברים: