
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.

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ğrudanfetchç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:
{placeId}: Seçilen yerin benzersiz tanımlayıcısı.fields: Alınacak veri alanlarını tam olarak belirtir. Uygulamaid,displayName,subDestinations,typesveformattedAddressizinlerini istiyor. Bu, maliyetleri kontrol etmek ve yalnızca gerekli verileri almak için çok önemlidir.
- Belirli bir konum için
subDestinationsdeğ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/jsonadresine doğrudanfetchç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çinLatLngnesnesi.
- 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) vegoogle.maps.marker.AdvancedMarkerElementilegoogle.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 koddadraggable,falseolarak 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.AdvancedMarkerElementvePinElement: 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ğiLatLngkoordinatları.map: İşaretçinin gösterileceği harita örneği.title: İşaretçinin üzerine gelindiğinde gösterilen metin.icon:google.maps.Markeriçin özel simgelere izin verir (ör. özel renklerlegoogle.maps.SymbolPath.CIRCLE).content:AdvancedMarkerElementiçin bu, önceden stillendirilmiş raptiyeler içinPinElementdahil olmak üzere özel HTML içeriğinin yerleştirilmesine olanak tanır.- Görsel özelleştirme için
PinElementparametreleri: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_computationsadresinden GeoJSONdisplay_polygonolarak 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 birLatLngnoktası ekler ve gerekirse sınırları genişletir.fitBounds(bounds):LatLngBoundsnesnesi 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: