
एयरपोर्ट बड़े और कई टर्मिनल वाले कॉम्प्लेक्स होते हैं. इसलिए, समय पर पहुंचने और निकलने के लिए सटीक नेविगेशन ज़रूरी है. Google Maps Geocoding API आम तौर पर, एक निर्देशांक (अक्षांश/देशांतर) दिखाता है. ज़्यादातर मामलों में, यह बड़े एयरपोर्ट कॉम्प्लेक्स का केंद्र होता है. यह ऐप्लिकेशन एक इंटरैक्टिव टूल है. इसे खास तौर पर, उपयोगकर्ताओं को किसी बड़े और जटिल परिसर में जगह की सटीक जानकारी का पता लगाने और उन्हें विज़ुअलाइज़ करने में मदद करने के लिए डिज़ाइन किया गया है. जैसे, किसी हवाई अड्डे के अंदर मौजूद टर्मिनल या पिकअप/ड्रॉप-ऑफ़ पॉइंट.

यह इस तरह से काम करता है:
हवाई अड्डे/जगह की खोज: उपयोगकर्ता, Google Places की ऑटोकंप्लीट सुविधा का इस्तेमाल करके, किसी मुख्य जगह (जैसे, "इंदिरा गांधी अंतरराष्ट्रीय हवाई अड्डा") को खोजते हैं. यह सुविधा सिर्फ़ भारत में उपलब्ध है.
किसी जगह के किसी क्षेत्र का पता लगाना: मुख्य जगह चुनने के बाद, स्क्रिप्ट Google Places API का इस्तेमाल करके जानकारी फ़ेच करती है. इसमें, उस जगह से जुड़े "सब-डेस्टिनेशन" की जानकारी भी शामिल होती है. जैसे, टर्मिनल 1, टर्मिनल 3, खास गेट वगैरह. हालांकि, ऐसा तब होता है, जब Google के डेटा में यह जानकारी उपलब्ध हो.
विज़ुअल मैपिंग: स्क्रिप्ट, Geocoding API का इस्तेमाल करके, मुख्य जगह और उसके सब-डेस्टिनेशन के निर्देशांक ढूंढती है.
इसके बाद, यह मुख्य जगह दिखाता है. साथ ही, मैप पर पहचानी गई हर सब-डेस्टिनेशन के लिए, क्लिक किए जा सकने वाले अलग-अलग मार्कर (नीले रंग के सर्कल) दिखाता है.
सटीक पहचान: सब-डेस्टिनेशन मार्कर पर क्लिक करने से, वह हाइलाइट हो जाता है (हरा हो जाता है) और एक InfoWindow खुलता है. इसमें उसका नाम और अन्य उपलब्ध जानकारी (जैसे, पता या टाइप) दिखती है. इससे उपयोगकर्ता यह पुष्टि कर सकता है कि उसने सही जगह चुनी है.
कॉन्टेक्स्ट के हिसाब से व्यू: मैप अपने-आप अपना व्यू (fitBounds) अडजस्ट करता है, ताकि यह पुष्टि की जा सके कि सभी काम के मार्कर (मुख्य जगह + सब-डेस्टिनेशन) साफ़ तौर पर दिख रहे हैं.
एयरपोर्ट नेविगेशन ऐप्लिकेशन में Google Maps Platform के एपीआई
इस दस्तावेज़ में, Google Maps Platform के मुख्य एपीआई और उनके पैरामीटर के बारे में बताया गया है. इनका इस्तेमाल, "एयरपोर्ट पर नेविगेट करें" डेमो ऐप्लिकेशन में किया गया है. यह ऐप्लिकेशन, मैप दिखाने, जगह खोजने, जगह की ज़्यादा जानकारी देने, और जगह की जानकारी से जुड़ी बेहतर जानकारी देने के लिए कई सेवाओं का इस्तेमाल करता है.
1. मैप को शुरू करना और दिखाना
इस ऐप्लिकेशन का मुख्य हिस्सा, इंटरैक्टिव मैप है.
- इस्तेमाल किया गया एपीआई:
google.maps.Map(Maps JavaScript API से) - मकसद: वेबपेज पर इंटरैक्टिव मैप बनाना और दिखाना.
- मुख्य पैरामीटर:
center: मैप के शुरुआती भौगोलिक केंद्र के बारे में बताता है. इस ऐप्लिकेशन में, शुरुआत में यह दिल्ली के निर्देशांकों ({ lat: 28.461835685621395, lng: 77.05004035761647 }) पर सेट होता है.zoom: इससे मैप के लिए ज़ूम करने का शुरुआती लेवल सेट होता है.DEFAULT_ZOOM_LEVEL(15) का इस्तेमाल, क्लोज़-अप व्यू के लिए किया जाता है.mapId: Google Cloud Console में कॉन्फ़िगर की गई मैप स्टाइल का यूनीक आइडेंटिफ़ायर.
2. Place Search और ऑटोकंप्लीट
खोज बार की सुविधा, Places API की मदद से काम करती है.
- इस्तेमाल किया गया एपीआई:
google.maps.places.Autocomplete(Maps JavaScript API की Places लाइब्रेरी से) - मकसद: उपयोगकर्ता के टाइप करते ही, भौगोलिक खोजों के लिए टेक्स्ट पूरा करने के सुझाव देता है. साथ ही, एयरपोर्ट जैसी काम की जगहों के सुझाव देता है.
- मुख्य पैरामीटर:
input: एचटीएमएल इनपुट एलिमेंट (#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. जगह की ज़्यादा जानकारी पाना और सब-डेस्टिनेशन मैनेज करना
अपने-आप पूरा होने वाले सुझावों में से किसी जगह को चुनने पर, उसके बारे में ज़्यादा जानकारी मिलती है.
- इस्तेमाल किया गया एपीआई: Places API (
https://places.googleapis.com/v1/places/{placeId}को सीधेfetchकॉल करके) - मकसद: किसी जगह के बारे में ज़्यादा जानकारी पाना. जैसे, उसका डिसप्ले नेम, पता, टाइप, और सबसे अहम जानकारी, यानी कि उसका
subDestinations(जैसे, किसी बड़े कॉम्प्लेक्स में मौजूद अलग-अलग टर्मिनल या अहम इलाके, जैसे कि एयरपोर्ट). - यूआरएल में मौजूद मुख्य पैरामीटर:
{placeId}: चुनी गई जगह का यूनीक आइडेंटिफ़ायर.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. जियोकोडिंग और रिवर्स जियोकोडिंग: सब-डेस्टिनेशन की जानकारी फ़ेच करना
ऐप्लिकेशन, जियोकोडिंग का इस्तेमाल दो मुख्य कामों के लिए करता है: जगह के आईडी को निर्देशांकों में बदलना और निर्देशांकों को वापस जगह की जानकारी में बदलना. इस सेक्शन में खास तौर पर बताया गया है कि सब-डेस्टिनेशन के बारे में ज़्यादा जानकारी पाने के लिए, जियोकोडिंग का इस्तेमाल कैसे किया जाता है.
- इस्तेमाल किया गया एपीआई:
google.maps.Geocoder(Maps JavaScript API से) और Geocoding API (https://maps.googleapis.com/maps/api/geocode/jsonको सीधेfetchकॉल करके) - मकसद:
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. मार्कर दिखाना
मार्कर का इस्तेमाल, मैप पर खास जगहों को हाइलाइट करने के लिए किया जाता है.
- इस्तेमाल किया गया एपीआई:
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के लिए, यह कस्टम एचटीएमएल कॉन्टेंट को एम्बेड करने की अनुमति देता है. इसमें पहले से स्टाइल किए गए पिन के लिएPinElementशामिल है.PinElementपैरामीटर: विज़ुअल को पसंद के मुताबिक बनाने के लिएbackground,borderColor,glyphColor,scale.
6. इमारतों की आउटलाइन दिखाना
यह ऐप्लिकेशन, इमारतों के फ़ुटप्रिंट को विज़ुअल तौर पर दिखा सकता है.
- इस्तेमाल किया गया एपीआई:
google.maps.Data(Maps JavaScript API से) - मकसद: भौगोलिक डेटा दिखाना, जैसे कि बिल्डिंग की आउटलाइन. यह डेटा, Geocoding API के
extra_computationsसे GeoJSONdisplay_polygonके तौर पर मिलता है. - मुख्य पैरामीटर:
map: मैप का वह इंस्टेंस जिस पर डेटा लेयर लागू की गई है.style: GeoJSON की सुविधाओं के विज़ुअल अपियरेंस के बारे में बताता है (उदाहरण के लिए,strokeColor,fillColor,fillOpacity).addGeoJson(): लेयर में GeoJSON डेटा जोड़ने का तरीका.
7. इलाके का दायरा और ज़ूम
पुष्टि करें कि मैप व्यू में सभी काम की जगहें शामिल हों.
- इस्तेमाल किया गया एपीआई:
google.maps.LatLngBounds(Maps JavaScript API से) - मकसद: मैप के व्यूपोर्ट को डाइनैमिक तौर पर अडजस्ट करना, ताकि वह भौगोलिक जगहों के कलेक्शन (जैसे, मुख्य जगह और उसके आस-पास की सभी जगहें) के हिसाब से फ़िट हो सके.
- मुख्य तरीके:
extend(location): यह बाउंड मेंLatLngपॉइंट जोड़ता है. साथ ही, ज़रूरत पड़ने पर उन्हें बड़ा करता है.fitBounds(bounds): यह मैप के सेंटर और ज़ूम करने के लेवल को अडजस्ट करता है, ताकिLatLngBoundsऑब्जेक्ट से तय किए गए पूरे इलाके को दिखाया जा सके.
Google Maps Platform के इन एपीआई को जोड़कर, ऐप्लिकेशन जगहें खोजने, उनकी जानकारी देखने, और उनसे जुड़ी भौगोलिक जानकारी को विज़ुअलाइज़ करने के लिए, एक बेहतर और इंटरैक्टिव अनुभव देता है. जैसे, सब-डेस्टिनेशन और बिल्डिंग की आउटलाइन.
लागू करने से जुड़ी ज़रूरी बातें ध्यान दें कि यह सुविधा सभी एयरपोर्ट पर काम नहीं करती. साथ ही, यह (एयरपोर्ट टर्मिनल) डेटा की उपलब्धता पर निर्भर करती है.
संसाधन Geocoding API Places API Maps Javascript API
लेखक: