
Аэропорты – это большие комплексы с несколькими терминалами, и точная навигация в них критически важна для своевременного прибытия и отправления. Google Maps Geocoding API обычно возвращает координаты (широту и долготу), которые в большинстве случаев соответствуют центру крупного аэропорта. Это приложение – интерактивный инструмент, который помогает пользователям находить и визуализировать точные местоположения в крупных комплексах, например определенные терминалы или пункты посадки и высадки в аэропорту.

Вот как это работает:
Поиск аэропорта или места. Пользователи начинают с поиска основного местоположения (например, "Международный аэропорт имени Индиры Ганди"), используя автозаполнение мест Google, которое ограничено Индией.
Поиск уточненных местоположений. После выбора основного местоположения скрипт использует Google Places API для получения подробных сведений, в том числе всех перечисленных "суб-местоположений", связанных с этим местом (например, терминал 1, терминал 3, конкретные выходы на посадку и т. д., если они доступны в данных Google).
Визуальное сопоставление. Скрипт использует Geocoding API, чтобы найти координаты основного местоположения и его подпунктов.
Затем на карте отображается основное местоположение и отдельные кликабельные маркеры (синие круги) для каждого идентифицированного подпункта назначения.
Точная идентификация. При нажатии на маркер подпункта назначения он выделяется зеленым цветом и открывается информационное окно с его названием и другими доступными сведениями, такими как адрес или тип. Это позволяет пользователю убедиться, что он выбрал правильную точку.
Контекстный виджет. Карта автоматически настраивает вид (fitBounds), чтобы все нужные маркеры (основное местоположение и дополнительные пункты назначения) были хорошо видны.
API платформы Google Карт в приложении для навигации по аэропорту
В этом документе описаны основные API платформы Google Карт и их параметры, используемые в демонстрационном приложении Navigate to Airport. Приложение использует несколько сервисов для отображения карты, поиска мест, подробной информации о местах и расширенной аналитики местоположений.
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 в 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:
{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. Прямое и обратное геокодирование: получение сведений о дополнительных пунктах назначения
Приложение использует геокодирование для двух основных целей: преобразование идентификаторов мест в координаты и преобразование координат обратно в сведения о местоположении. В этом разделе рассказывается, как геокодирование используется для получения подробной информации о дополнительных пунктах назначения.
- Используемые API:
google.maps.Geocoder(из Maps JavaScript API) и Geocoding API (через прямой вызовfetchкhttps://maps.googleapis.com/maps/api/geocode/json). - Цель.
google.maps.Geocoder– используется для преобразованияplaceId(полученного из Autocomplete или 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(из библиотеки маркеров 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_computationsGeocoding 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 Карт позволяет приложению предоставлять пользователям комплексные интерактивные возможности для поиска мест, просмотра информации о них и визуализации связанных географических данных, таких как дополнительные пункты назначения и контуры зданий.
Особенности реализации Обратите внимание, что эта функция работает не во всех аэропортах и зависит от доступности данных о терминалах.
Ресурсы Geocoding API Places API Maps Javascript API
Авторы: