
Flughäfen sind große Komplexe mit mehreren Terminals. Eine präzise Navigation ist entscheidend, um pünktlich anzukommen und abzufliegen. Die Google Maps Geocoding API gibt in der Regel eine Koordinate (Breitengrad/Längengrad) zurück, die in den meisten Fällen dem Mittelpunkt des großen Flughafenkomplexes entspricht. Diese App ist ein interaktives Tool, mit dem Nutzer genaue Standorte in einem größeren, komplexen Veranstaltungsort wie bestimmte Terminals oder Abhol-/Absetzpunkte an einem Flughafen finden und visualisieren können.

So wird das erreicht:
Flughafen-/Veranstaltungsortsuche: Nutzer suchen zuerst nach einem Hauptort (z.B. „Indira Gandhi International Airport“) über die Google Places Autocomplete-Eingabe, die auf Indien beschränkt ist.
Unterregionen ermitteln: Nachdem ein Hauptort ausgewählt wurde, ruft das Script über die Google Places API Details ab, insbesondere alle aufgeführten „Unterziele“, die mit diesem Ort verknüpft sind (z. B. Terminal 1, Terminal 3, bestimmte Gates usw., sofern in den Daten von Google verfügbar).
Visuelle Kartierung: Das Script verwendet die Geocoding API, um die Koordinaten des Hauptstandorts und seiner Unterziele zu ermitteln.
Anschließend wird der Hauptort angezeigt und für jedes identifizierte Unterziel werden separate, anklickbare Markierungen (blaue Kreise) auf der Karte platziert.
Präzise Identifizierung: Wenn Sie auf eine Markierung für ein untergeordnetes Ziel klicken, wird sie hervorgehoben (wird grün) und es wird ein InfoWindow mit dem Namen und anderen verfügbaren Details (z. B. Adresse oder Typ) geöffnet. So können Nutzer prüfen, ob sie den richtigen Punkt ausgewählt haben.
Kontextansicht: Die Karte passt ihre Ansicht (fitBounds) automatisch an, damit alle relevanten Markierungen (Hauptort und Unterziele) gut sichtbar sind.
Google Maps Platform APIs in der Flughafen-Navigations-App
In diesem Dokument werden die wichtigsten Google Maps Platform APIs und ihre Parameter erläutert, die in der bereitgestellten Demoanwendung „Navigate to Airport“ verwendet werden. Die App nutzt mehrere Dienste, um Kartendarstellungen, die Ortssuche, detaillierte Ortsinformationen und erweiterte standortbezogene Informationen bereitzustellen.
1. Karteninitialisierung und -anzeige
Die Grundlage der Anwendung ist die interaktive Karte selbst.
- Verwendete API:
google.maps.Map(aus der Maps JavaScript API) - Zweck:Die interaktive Karte wird auf der Webseite erstellt und angezeigt.
- Wichtige Parameter:
center: Definiert den anfänglichen geografischen Mittelpunkt der Karte. In dieser App ist sie anfangs auf die Koordinaten von Delhi ({ lat: 28.461835685621395, lng: 77.05004035761647 }) festgelegt.zoom: Legt die anfängliche Zoomstufe der Karte fest.DEFAULT_ZOOM_LEVEL(15) wird für eine Nahaufnahme verwendet.mapId: Eine eindeutige Kennung für einen Kartenstil, der in der Google Cloud Console konfiguriert wurde.
2. Place Search und Place Autocomplete
Die Suchleiste wird von der Places API unterstützt.
- Verwendete API:
google.maps.places.Autocomplete(aus der Places Library der Maps JavaScript API) - Zweck:Bietet eine vorausschauende Textvervollständigung für geografische Suchanfragen, während der Nutzer tippt, und schlägt relevante Orte wie Flughäfen vor.
- Wichtige Parameter:
input: Das HTML-Eingabeelement (#search-input), in das der Nutzer seine Suchanfrage eingibt.componentRestrictions: Filtert Suchergebnisse nach einem bestimmten Land. Hier beschränkt{ country: 'in' }die Ergebnisse auf Indien.fields: Gibt die Datenfelder an, die für den ausgewählten Ort zurückgegeben werden sollen.['place_id']wird anfänglich verwendet, um nur die eindeutige Kennung für den Ort abzurufen, wodurch die Datenübertragung optimiert wird.
- Automatische Vervollständigung verwenden
// 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. Detaillierte Ortsinformationen abrufen und Unterziele verarbeiten
Sobald ein Ort aus den automatisch vervollständigten Vorschlägen ausgewählt wurde, werden umfassendere Details abgerufen.
- Verwendete API:Places API (über direkten
fetch-Aufruf anhttps://places.googleapis.com/v1/places/{placeId}) - Zweck:Abrufen detaillierter Informationen zu einem bestimmten Ort, einschließlich Anzeigename, Adresse, Typen und vor allem
subDestinations(z.B. einzelne Terminals oder wichtige Bereiche innerhalb eines größeren Komplexes wie eines Flughafens). - Wichtige Parameter in der URL:
{placeId}: Die eindeutige Kennung des ausgewählten Orts.fields: Gibt die genauen Datenfelder an, die abgerufen werden sollen. Die App fordertid,displayName,subDestinations,typesundformattedAddressan. Das ist entscheidend, um die Kosten zu kontrollieren und nur die erforderlichen Daten zu erhalten.
subDestinationsfür einen bestimmten Standort abrufen
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. Geocodierung und umgekehrte Geocodierung: Details zu Unterzielen abrufen
Die Anwendung verwendet Geocoding für zwei Hauptzwecke: Orts-IDs in Koordinaten umwandeln und Koordinaten wieder in Standortdetails umwandeln. In diesem Abschnitt wird insbesondere erläutert, wie Geocoding verwendet wird, um detaillierte Informationen zu Unterzielen zu erhalten.
- Verwendete API:
google.maps.Geocoder(aus der Maps JavaScript API) und Geocoding API (über direktenfetch-Aufruf anhttps://maps.googleapis.com/maps/api/geocode/json) - Zweck:
google.maps.Geocoder: Wird verwendet, um eineplaceId(aus der automatischen Vervollständigung oder der Places API) in geografische Koordinaten (lat,lng) und einen Darstellungsbereich umzuwandeln, damit die Karte korrekt auf den ausgewählten Ort und seine Unterziele zentriert und gezoomt werden kann.- Geocoding API (
fetch): Wird für die umgekehrte Geocodierung (Umwandlung von Breiten- und Längengraden in eine menschenlesbare Adresse) und zum Abrufen erweiterter Standortdaten wie Gebäudeumrisse und Navigationspunkte verwendet.
- Wichtige Parameter:
google.maps.Geocoder.geocode():placeId: Die Orts-ID, die geocodiert werden soll.location: DasLatLng-Objekt für die umgekehrte Geocodierung.
fetch-Aufruf der Geocoding API:latlng: Die Breiten- und Längengradkoordinaten für die umgekehrte Geocodierung.extra_computations=BUILDING_AND_ENTRANCES: Mit diesem wichtigen Parameter werden zusätzliche Daten angefordert, insbesondere Gebäudegrundrisse und Informationen zu Eingängen, die dann zum Anzeigen von Gebäudeumrissen und Navigationspunkten verwendet werden.
subDestination-ID verwenden, um weitere Details abzurufen (z.B. Standort, formatierte Adresse, Typen)
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. Markierungen anzeigen
Mit Markierungen werden bestimmte Orte auf der Karte hervorgehoben.
- Verwendete API:
google.maps.Marker(aus der Maps JavaScript API) undgoogle.maps.marker.AdvancedMarkerElementmitgoogle.maps.marker.PinElement(aus der Marker Library der Maps JavaScript API) - Zweck:
google.maps.Marker: Wird für die erste ziehbare Markierung verwendet (obwohldraggableim bereitgestellten Code auffalsegesetzt ist, ist dies Teil der Funktion) und für grundlegende Markierungen für Unterziele, wie in Abschnitt 3 beschrieben.AdvancedMarkerElementundPinElement: Werden für die optisch auffälligeren Navigationspunktmarkierungen verwendet, um die Markierungspins benutzerdefiniert zu gestalten.
- Wichtige Parameter:
position: DieLatLng-Koordinaten, an denen die Markierung platziert wird.map: Die Karteninstanz, auf der die Markierung angezeigt wird.title: Text, der angezeigt wird, wenn der Mauszeiger auf die Markierung bewegt wird.icon: Ermöglicht benutzerdefinierte Symbole fürgoogle.maps.Marker(z.B.google.maps.SymbolPath.CIRCLEmit benutzerdefinierten Farben).content: BeiAdvancedMarkerElementkönnen Sie benutzerdefinierte HTML-Inhalte einbetten, einschließlichPinElementfür vordefinierte Pins.PinElement-Parameter:background,borderColor,glyphColor,scalefür die visuelle Anpassung.
6. Gebäudeumrisse anzeigen
Die Anwendung kann die Grundfläche von Gebäuden visuell darstellen.
- Verwendete API:
google.maps.Data(aus der Maps JavaScript API) - Zweck:Geografische Daten wie Gebäudeumrisse anzeigen (werden als GeoJSON-
display_polygonvomextra_computationsder Geocoding API zurückgegeben). - Wichtige Parameter:
map: Die Karteninstanz, auf die die Datenebene angewendet wird.style: Definiert das visuelle Erscheinungsbild der GeoJSON-Elemente (z.B.strokeColor,fillColor,fillOpacity).addGeoJson(): Methode zum Hinzufügen von GeoJSON-Daten zur Ebene.
7. Kartengrenzen und Zoom
Prüfen Sie, ob die Kartenansicht alle relevanten Standorte umfasst.
- Verwendete API:
google.maps.LatLngBounds(aus der Maps JavaScript API) - Zweck:Der Darstellungsbereich der Karte wird dynamisch angepasst, sodass eine Reihe von geografischen Punkten (z.B. der Hauptort und alle Unterziele) hineinpassen.
- Wichtige Methoden:
extend(location): Fügt den Grenzen einenLatLng-Punkt hinzu und erweitert sie bei Bedarf.fitBounds(bounds): Passt den Mittelpunkt und die Zoomstufe der Karte an, um den gesamten Bereich anzuzeigen, der durch dasLatLngBounds-Objekt definiert ist.
Durch die Kombination dieser Google Maps Platform APIs bietet die Anwendung eine umfassende und interaktive Möglichkeit, nach Orten zu suchen, ihre Details anzusehen und zugehörige geografische Informationen wie Unterziele und Gebäudeumrisse zu visualisieren.
Hinweise zur Implementierung Beachten Sie, dass dies nicht in allen Flughäfen funktioniert und von der Verfügbarkeit von Daten (Flughafenterminal) abhängt.
Ressourcen Geocoding API Places API Maps JavaScript API
Autor*innen: