
فرودگاهها مجموعههای بزرگ با چندین پایانه هستند و ناوبری دقیق برای رسیدن و حرکت بهموقع ضروری است. Google Maps Geocoding API معمولاً مختصاتی (عرض جغرافیایی/طول جغرافیایی) را برمیگرداند که در بیشتر موارد مرکز ثقل مجتمع فرودگاهی بزرگ است. این برنامه ابزاری تعاملی است که بهطور خاص برای کمک به کاربران در مشخص کردن و تجسم مکانهای دقیق در یک مکان پیچیده بزرگتر مانند پایانههای خاص یا نقاط سوار/پیاده کردن در فرودگاه طراحی شده است.

نحوه دستیابی به این هدف:
جستجوی فرودگاه/محل: کاربران با جستجوی مکان اصلی (مثلاً «فرودگاه بینالمللی ایندیرا گاندی») بااستفاده از ورودی «تکمیل خودکار مکانهای Google» که به هند محدود است شروع میکنند.
Sub-Location Discovery: Once a primary location is selected, the script uses the Google Places API to fetch details, crucially including any listed "sub-destinations" associated with that place (like Terminal 1, Terminal 3, specific gates, etc., if available in Google's data).
نگاشت بصری: این اسکریپت از Geocoding API برای یافتن مختصات مکان اصلی و مقصدهای فرعی آن استفاده میکند.
سپس مکان اصلی را نمایش میدهد و نشانگرهای متمایز و قابلکلیک (دایرههای آبی) را روی نقشه برای هر مقصد فرعی شناساییشده قرار میدهد.
شناسایی دقیق: کلیک کردن روی نشانگر مقصد فرعی آن را برجسته میکند (سبز میشود) و InfoWindow را باز میکند که نام آن و سایر جزئیات دردسترس (مانند نشانی یا نوع) را نشان میدهد و به کاربر امکان میدهد تأیید کند که نقطه خاص صحیح را انتخاب کرده است.
نمای بافتاری: نقشه بهطور خودکار نمای خود را تنظیم میکند (fitBounds) تا
تأیید کند همه نشانگرهای مربوط (مکان اصلی + مقصدهای فرعی) بهوضوح
نمایان هستند.
میاناهای برنامهسازی کاربردی «پلاتفرم Google Maps» در برنامه ناوبری فرودگاه
این سند میاناهای برنامهسازی کاربردی اصلی «پلاتفرم Google Maps» و پارامترهای آنها را که در برنامه نمایشی ارائهشده «پیمایش به فرودگاه» استفاده شده است توضیح میدهد. این برنامه از چندین سرویس برای ارائه نمایش نقشه، جستجوی مکان، اطلاعات دقیق مکان، و اطلاعات آماری پیشرفته مکان استفاده میکند.
۱. مقداردهی اولیه و نمایش نقشه
پایه این برنامه همان نقشه تعاملی است.
- میانای برنامهسازی کاربردی استفادهشده:
google.maps.Map(از Maps JavaScript API) - هدف: ایجاد و نمایش نقشه تعاملی در صفحه وب.
- پارامترهای کلیدی:
center: مرکز جغرافیایی اولیه نقشه را تعریف میکند. در این برنامه، در ابتدا روی مختصات دهلی ({ lat: 28.461835685621395, lng: 77.05004035761647 }) تنظیم شده است.-
zoom: سطح بزرگنمایی اولیه نقشه را تنظیم میکند.DEFAULT_ZOOM_LEVEL(۱۵) برای نمای نزدیک استفاده میشود. mapId: شناسه یکتایی برای سبک نقشه پیکربندیشده در Google Cloud Console.
۲. جستجوی جاها و تکمیل خودکار
عملکرد نوار جستجو با Places 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);
});
۳. بازیابی اطلاعات دقیق مکان و مدیریت زیرمقصدها
وقتی مکانی از پیشنهادهای تکمیل خودکار انتخاب میشود، جزئیات جامعتری واکشی میشود.
- میانای برنامهسازی کاربردی استفادهشده: Places API (ازطریق فراخوانی مستقیم
fetchبهhttps://places.googleapis.com/v1/places/{placeId}) - هدف: بازیابی جزئیات غنی درباره مکانی خاص، ازجمله
نام نمایشی، نشانی، انواع، و مهمتر از همه،
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.
۴. زمینکدیابی و زمینکدیابی معکوس: واکشی جزئیات برای زیرمقصدها
این برنامه از زمینکدیابی برای دو هدف اصلی استفاده میکند: تبدیل شناسههای مکان به مختصات و تبدیل مختصات به جزئیات مکان. این بخش بهطور خاص نشان میدهد که چگونه از زمینکدیابی برای دریافت اطلاعات دقیق درباره زیرمقصدها استفاده میشود.
- میانای برنامهسازی کاربردی استفادهشده:
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}`));
}
});
});
}
۵. درحال نمایش نشانگرها
از نشانگرها برای برجسته کردن مکانهای خاص روی نقشه استفاده میشود.
- میانای برنامهسازی کاربردی استفادهشده:
google.maps.Marker(از Maps JavaScript API) وgoogle.maps.marker.AdvancedMarkerElementباgoogle.maps.marker.PinElement(از کتابخانه نشانگر Maps JavaScript API) - هدف:
google.maps.Marker: Used for the initial draggable marker (thoughdraggableis set tofalsein the provided code, it's part of its capability) and for basic sub-destination markers as described in section 3.AdvancedMarkerElementوPinElement: برای نشانگرهای نقطه پیمایش که ازنظر بصری متمایزتر هستند استفاده میشود و امکان سبک سفارشی برای سنجاق نشانگر را فراهم میکند.
- پارامترهای کلیدی:
-
position: مختصاتLatLngکه نشانگر در آن قرار خواهد گرفت. map: نمونه نقشه که نشانگر روی آن نمایش داده خواهد شد.title: نوشتاری که هنگام نگه داشتن نشانگر نمایش داده میشود.icon: نمادهای سفارشی را برایgoogle.maps.Marker(مثلاًgoogle.maps.SymbolPath.CIRCLEبا رنگهای سفارشی) مجاز میکند.content: برایAdvancedMarkerElement، این گزینه امکان جاسازی محتوای HTML سفارشی را فراهم میکند، ازجملهPinElementبرای سنجاقهای ازپیش سبکبندیشده.- پارامترهای
PinElement:background،borderColor،glyphColor،scaleبرای سفارشیسازی بصری.
-
۶. درحال نمایش رئوس مطالب ساختمان
این برنامه میتواند ردپای ساختمانها را بهصورت دیداری نشان دهد.
- میانای برنامهسازی کاربردی استفادهشده:
google.maps.Data(از Maps JavaScript API) - هدف: برای نمایش دادههای جغرافیایی، مانند طرح کلی ساختمان
(که بهعنوان GeoJSON
display_polygonاز Geocoding APIextra_computationsبرگردانده میشود). - پارامترهای کلیدی:
-
map: نمونه نقشهای که لایه داده روی آن اعمال میشود. -
style: ظاهر بصری عارضههای GeoJSON را تعریف میکند (برای مثال،strokeColor،fillColor،fillOpacity). addGeoJson(): روش افزودن دادههای GeoJSON به لایه.
-
۷. مرزهای نقشه و بزرگنمایی
درحال درستیسنجی اینکه نمای نقشه همه مکانهای مربوط را دربرمیگیرد.
- میانای برنامهسازی کاربردی استفادهشده:
google.maps.LatLngBounds(از Maps JavaScript API) - هدف: تنظیم پویای نمای نقشه برای گنجاندن مجموعهای از نقاط جغرافیایی (مثلاً مکان اصلی و همه مقصدهای فرعی آن).
- روشهای کلیدی:
-
extend(location): نقطهLatLngرا به مرزها اضافه میکند، و درصورت لزوم آنها را گسترش میدهد. fitBounds(bounds): مرکز نقشه و سطح بزرگنمایی را تنظیم میکند تا کل منطقه تعریفشده توسط شیءLatLngBoundsرا نمایش دهد.
-
با ترکیب این میاناهای برنامهسازی کاربردی «پلاتفرم Google Maps»، برنامه تجربه جامع و تعاملیای برای جستجوی مکانها، مشاهده جزئیات آنها، و تجسم اطلاعات جغرافیایی مرتبط مانند زیرمقصدها و طرحهای کلی ساختمان ارائه میدهد.
ملاحظات پیادهسازی توجه داشته باشید که این ویژگی در همه مناطق فرودگاه کار نمیکند و منوط به دردسترس بودن دادههای (پایانه فرودگاه) است.
منابع Geocoding API Places API Maps Javascript API
نویسندگان: