การนำทางไปยังสนามบินที่ปรับปรุงให้ดีขึ้น

แผนที่สนามบินแสดงเครื่องหมายเทอร์มินัล

สนามบินเป็นอาคารขนาดใหญ่ที่มีหลายเทอร์มินัล และการนำทางที่แม่นยำเป็นสิ่งสำคัญสำหรับการมาถึงและออกเดินทางที่ตรงเวลา โดยปกติแล้ว Google Maps Geocoding API จะแสดงผลพิกัด (ละติจูด/ลองจิจูด) ซึ่งในกรณีส่วนใหญ่จะเป็นจุดศูนย์กลางของสนามบินขนาดใหญ่ แอปนี้เป็นเครื่องมือแบบอินเทอร์แอกทีฟที่ออกแบบมาเพื่อช่วยให้ผู้ใช้ระบุและแสดงภาพตำแหน่งที่แน่นอนภายในสถานที่ขนาดใหญ่ที่ซับซ้อน เช่น เทอร์มินัลหรือจุดรับ/ส่งที่เฉพาะเจาะจงภายในสนามบิน

รูปภาพ

โดยมีวิธีการดังนี้

การค้นหาสนามบิน/สถานที่: ผู้ใช้เริ่มต้นด้วยการค้นหาสถานที่หลัก (เช่น "สนามบินนานาชาติอินทิรา คานธี") โดยใช้อินพุต Google Places Autocomplete ซึ่งจำกัดไว้เฉพาะในอินเดีย

การค้นหาสถานที่ย่อย: เมื่อเลือกสถานที่หลักแล้ว สคริปต์จะใช้ Google Places API เพื่อดึงรายละเอียด โดยเฉพาะอย่างยิ่ง "จุดหมายย่อย" ที่แสดงไว้ซึ่งเชื่อมโยงกับสถานที่นั้น (เช่น เทอร์มินัล 1, เทอร์มินัล 3, ประตูทางออกที่เฉพาะเจาะจง ฯลฯ หากมีในข้อมูลของ Google)

การแมปภาพ: สคริปต์ใช้ Geocoding API เพื่อค้นหาพิกัดของสถานที่ตั้งหลักและจุดหมายย่อย

จากนั้นจะแสดงสถานที่ตั้งหลักและวางเครื่องหมายที่คลิกได้ (วงกลมสีน้ำเงิน) บนแผนที่สำหรับจุดหมายย่อยแต่ละแห่งที่ระบุ

การระบุที่แม่นยำ: การคลิกเครื่องหมายปลายทางย่อยจะไฮไลต์เครื่องหมายนั้น (เปลี่ยนเป็นสีเขียว) และเปิดหน้าต่างข้อมูลที่แสดงชื่อและรายละเอียดอื่นๆ ที่มี (เช่น ที่อยู่หรือประเภท) ซึ่งช่วยให้ผู้ใช้ยืนยันได้ว่าได้เลือกจุดที่ถูกต้องแล้ว มุมมองภาพรวม: แผนที่จะปรับมุมมอง (fitBounds) โดยอัตโนมัติเพื่อยืนยันว่าเครื่องหมายที่เกี่ยวข้องทั้งหมด (สถานที่หลัก + จุดหมายย่อย) แสดงอย่างชัดเจน

Google Maps Platform API ในแอปการนำทางในสนามบิน

เอกสารนี้อธิบาย 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 (จาก Places Library ของ 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. การเข้ารหัสพิกัดภูมิศาสตร์และการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ: การดึงรายละเอียดสำหรับปลายทางย่อย

แอปพลิเคชันใช้การเข้ารหัสพิกัดภูมิศาสตร์เพื่อวัตถุประสงค์หลัก 2 ประการ ได้แก่ การแปลงรหัสสถานที่ให้เป็นพิกัด และการแปลงพิกัดกลับเป็นรายละเอียดสถานที่ ส่วนนี้จะไฮไลต์วิธีใช้การเข้ารหัสพิกัดภูมิศาสตร์เพื่อรับข้อมูลโดยละเอียดเกี่ยวกับจุดหมายย่อยโดยเฉพาะ

  • 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 (จาก Marker Library ของ 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

ผู้เขียน: