Havaalanlarına daha iyi navigasyon

Terminal işaretçilerini gösteren havaalanı haritası

Havaalanları, birden fazla terminali olan büyük tesislerdir. Zamanında varış ve kalkış için hassas navigasyon çok önemlidir. Google Haritalar Geocoding API genellikle bir koordinat (enlem/boylam) döndürür. Bu koordinat, çoğu durumda büyük havaalanı kompleksinin merkezidir. Bu uygulama, kullanıcıların havaalanındaki belirli terminaller veya yolcu alma/bırakma noktaları gibi daha büyük ve karmaşık bir mekandaki tam konumları belirleyip görselleştirmelerine yardımcı olmak için özel olarak tasarlanmış etkileşimli bir araçtır.

resim

Bunu nasıl yaptığını aşağıda görebilirsiniz:

Havaalanı/Mekan Arama: Kullanıcılar, Google Places Otomatik Tamamlama girişini kullanarak ana bir konum (ör. "Indira Gandhi Uluslararası Havaalanı") arayarak başlar. Bu giriş Hindistan ile sınırlıdır.

Alt Konum Keşfi: Birincil konum seçildikten sonra komut dosyası, Google Places API'yi kullanarak ayrıntıları getirir. Bu ayrıntılar arasında, söz konusu yerle ilişkili listelenen tüm "alt hedefler" (Google'ın verilerinde mevcutsa Terminal 1, Terminal 3, belirli kapılar vb.) yer alır.

Görsel eşleme: Komut dosyası, ana konumun ve alt hedeflerinin koordinatlarını bulmak için Geocoding API'yi kullanır.

Ardından ana konumu gösterir ve tanımlanan her alt hedef için haritaya farklı, tıklanabilir işaretçiler (mavi daireler) yerleştirir.

Tam Tanımlama: Bir alt varış noktası işaretçisi tıklandığında vurgulanır (yeşile döner) ve adını ve diğer mevcut ayrıntıları (adres veya tür gibi) gösteren bir InfoWindow açılır. Bu sayede kullanıcı, doğru noktayı seçtiğini onaylayabilir. Bağlam Görünümü: Harita, tüm alakalı işaretçilerin (ana konum + alt varış noktaları) net bir şekilde görünür olduğunu doğrulamak için görünümünü (fitBounds) otomatik olarak ayarlar.

Havaalanı Navigasyon Uygulamasında Google Haritalar Platformu API'leri

Bu dokümanda, "Havaalanına Git" demo uygulamasında kullanılan temel Google Haritalar Platformu API'leri ve parametreleri açıklanmaktadır. Uygulama; harita görüntüleme, yer arama, ayrıntılı yer bilgileri ve gelişmiş konum analizleri sağlamak için çeşitli hizmetlerden yararlanır.

1. Haritayı Başlatma ve Görüntüleme

Uygulamanın temelini etkileşimli harita oluşturur.

  • Kullanılan API: google.maps.Map (Maps JavaScript API'den)
  • Amaç: Web sayfasında etkileşimli haritayı oluşturmak ve görüntülemek.
  • Önemli parametreler:
    • center: Haritanın ilk coğrafi merkezini tanımlar. Bu uygulamada başlangıçta Delhi'nin koordinatları ({ lat: 28.461835685621395, lng: 77.05004035761647 }) olarak ayarlanmıştır.
    • zoom: Haritanın ilk yakınlaştırma seviyesini ayarlar. DEFAULT_ZOOM_LEVEL (15) yakın çekim için kullanılır.
    • mapId: Google Cloud Console'da yapılandırılan bir harita stilinin benzersiz tanımlayıcısı.

2. Yer Arama ve Otomatik Tamamlama

Arama çubuğu işlevi, Places API tarafından desteklenir.

  • Kullanılan API: google.maps.places.Autocomplete (Maps JavaScript API'nin Places Library'sinden)
  • Amaç: Kullanıcı yazarken coğrafi aramalar için tahmine dayalı metin tamamlama özelliği sunarak havaalanları gibi alakalı yerleri önerir.
  • Önemli parametreler:
    • input: Kullanıcının sorgusunu yazdığı HTML giriş öğesi (#search-input).
    • componentRestrictions: Arama sonuçlarını belirli bir ülkeye göre filtreler. Burada { country: 'in' }, sonuçları Hindistan ile sınırlandırır.
    • fields: Seçilen yer için döndürülecek veri alanlarını belirtir. ['place_id'], başlangıçta yalnızca yerin benzersiz tanımlayıcısını almak için kullanılır ve veri aktarımını optimize eder.
  • Otomatik tamamlama nasıl kullanılır?
    // 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. Ayrıntılı yer bilgilerini alma ve alt hedefleri işleme

Otomatik tamamlama önerilerinden bir yer seçildiğinde daha kapsamlı ayrıntılar getirilir.

  • Kullanılan API: Places API (https://places.googleapis.com/v1/places/{placeId} adresine doğrudan fetch çağrısı aracılığıyla)
  • Amaç: Belirli bir yerle ilgili ayrıntılı bilgileri (ör.görünen adı, adresi, türleri ve en önemlisi subDestinations) almak (ör. havaalanı gibi daha büyük bir kompleks içindeki ayrı terminaller veya önemli alanlar).
  • URL'deki anahtar parametreler:
    1. {placeId}: Seçilen yerin benzersiz tanımlayıcısı.
    2. fields: Alınacak veri alanlarını tam olarak belirtir. Uygulama id, displayName, subDestinations, types ve formattedAddress izinlerini istiyor. Bu, maliyetleri kontrol etmek ve yalnızca gerekli verileri almak için çok önemlidir.
  • Belirli bir konum için subDestinations değerini alma
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. Coğrafi Kodlama ve Tersine Coğrafi Kodlama: Alt Hedeflerle İlgili Ayrıntıları Alma

Uygulama, coğrafi kodlamayı iki ana amaç için kullanır: yer kimliklerini koordinatlara dönüştürme ve koordinatları tekrar konum ayrıntılarına dönüştürme. Bu bölümde, alt varış noktaları hakkında ayrıntılı bilgi edinmek için coğrafi kodlamanın nasıl kullanıldığı özellikle vurgulanmaktadır.

  • Kullanılan API: google.maps.Geocoder (Maps JavaScript API'den) ve Geocoding API (https://maps.googleapis.com/maps/api/geocode/json adresine doğrudan fetch çağrısı aracılığıyla)
  • Amaç:
    • google.maps.Geocoder: placeId (Otomatik Tamamlama veya Places API'den alınır) değerini coğrafi koordinatlara (lat, lng) ve görüntü alanına dönüştürmek için kullanılır. Bu sayede harita, seçilen yer ve alt hedefleri üzerinde doğru şekilde ortalanıp yakınlaştırılabilir.
    • Geocoding API (fetch): Tersine coğrafi kodlama (enlem ve boylamı kullanıcıların okuyabileceği bir adrese dönüştürme) ve bina ana hatları ile navigasyon noktaları gibi gelişmiş konum verilerini almak için kullanılır.
  • Önemli parametreler:
    • google.maps.Geocoder.geocode():
      • placeId: Coğrafi kodlanacak yer kimliği.
      • location: Tersine coğrafi kodlama için LatLng nesnesi.
    • Geocoding API fetch çağrısı:
      • latlng: Tersine coğrafi kodlama için enlem ve boylam koordinatları.
      • extra_computations=BUILDING_AND_ENTRANCES: Bu kritik parametre, ek veriler (özellikle bina taban alanları ve giriş bilgileri) ister. Bu veriler daha sonra bina ana hatlarını ve navigasyon noktalarını göstermek için kullanılır.

Daha fazla ayrıntı (ör. konum, biçimlendirilmiş adres, türler) almak için subDestination kimliğini kullanma

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. İşaretçileri görüntüleme

İşaretçiler, haritadaki belirli konumları vurgulamak için kullanılır.

  • Kullanılan API: google.maps.Marker (Maps JavaScript API'den) ve google.maps.marker.AdvancedMarkerElement ile google.maps.marker.PinElement (Maps JavaScript API'nin Marker Kitaplığı'ndan)
  • Amaç:
    • google.maps.Marker: İlk sürüklenebilir işaretçi için (sağlanan kodda draggable, false olarak ayarlanmış olsa da bu, özelliğin bir parçasıdır) ve 3. bölümde açıklandığı gibi temel alt hedef işaretçileri için kullanılır.
    • AdvancedMarkerElement ve PinElement: Görsel olarak daha belirgin navigasyon noktası işaretçileri için kullanılır ve işaretçinin raptiyesinin özel olarak stillendirilmesine olanak tanır.
  • Önemli parametreler:
    • position: İşaretçinin yerleştirileceği LatLng koordinatları.
    • map: İşaretçinin gösterileceği harita örneği.
    • title: İşaretçinin üzerine gelindiğinde gösterilen metin.
    • icon: google.maps.Marker için özel simgelere izin verir (ör. özel renklerle google.maps.SymbolPath.CIRCLE).
    • content: AdvancedMarkerElement için bu, önceden stillendirilmiş raptiyeler için PinElement dahil olmak üzere özel HTML içeriğinin yerleştirilmesine olanak tanır.
    • Görsel özelleştirme için PinElement parametreleri: background, borderColor, glyphColor, scale.

6. Bina ana hatlarını görüntüleme

Uygulama, binaların kapladığı alanı görsel olarak gösterebilir.

  • Kullanılan API: google.maps.Data (Maps JavaScript API'den)
  • Amaç: Bina ana hatları gibi coğrafi verileri görüntülemek (Geocoding API'nin extra_computations adresinden GeoJSON display_polygon olarak döndürülür).
  • Önemli parametreler:
    • map: Veri katmanının uygulandığı harita örneği.
    • style: GeoJSON özelliklerinin görsel görünümünü tanımlar (ör. strokeColor, fillColor, fillOpacity).
    • addGeoJson(): GeoJSON verilerini katmana ekleme yöntemi.

7. Harita Sınırları ve Yakınlaştırma

Harita görünümünün tüm alakalı konumları kapsadığını doğrulama

  • Kullanılan API: google.maps.LatLngBounds (Maps JavaScript API'den)
  • Amaç: Haritanın görüntü alanını, bir dizi coğrafi noktaya (ör. ana yer ve tüm alt varış noktaları) sığacak şekilde dinamik olarak ayarlamak.
  • Temel Yöntemler:
    • extend(location): Sınırlara bir LatLng noktası ekler ve gerekirse sınırları genişletir.
    • fitBounds(bounds): LatLngBounds nesnesi tarafından tanımlanan tüm alanı görüntülemek için haritanın merkezini ve yakınlaştırma seviyesini ayarlar.

Uygulama, bu Google Haritalar Platformu API'lerini birleştirerek yer arama, yer ayrıntılarını görüntüleme ve alt varış noktaları ile bina ana hatları gibi ilgili coğrafi bilgileri görselleştirme konusunda kapsamlı ve etkileşimli bir deneyim sunar.

Uygulamayla İlgili Dikkat Edilmesi Gerekenler Bu özelliğin tüm havaalanı alanlarında çalışmadığını ve (havaalanı terminali) veri kullanılabilirliğine tabi olduğunu unutmayın.

Kaynaklar Geocoding API Places API Maps JavaScript API

Yazarlar: