Einleitung
Mithilfe von Maps-URLs können Sie eine universelle, plattformübergreifende URL erstellen, um Google Maps zu starten und dort Suchanfragen zu stellen, Wegbeschreibungen und Navigationsinformationen abzurufen sowie Kartenansichten und Panoramabilder aufzurufen. Die URL-Syntax ist unabhängig von der verwendeten Plattform gleich.
Sie benötigen keinen Google API-Schlüssel, um Maps-URLs zu verwenden.
Universelle plattformübergreifende Syntax
Als Entwickler einer Android-App, einer iOS-App oder einer Website können Sie eine gemeinsame URL erstellen. Dadurch wird Google Maps geöffnet und die gewünschte Aktion ausgeführt, unabhängig davon, welche Plattform beim Öffnen der Karte verwendet wird.
- Auf einem Android-Gerät:
- Wenn die Google Maps App für Android installiert und aktiv ist, wird über die URL Google Maps in der Maps App gestartet und die angeforderte Aktion ausgeführt.
- Wenn die Google Maps App nicht installiert oder deaktiviert ist, wird über die URL Google Maps in einem Browser gestartet und die angeforderte Aktion ausgeführt.
- Auf einem iOS-Gerät:
- Wenn die Google Maps App für iOS installiert ist, wird über die URL Google Maps in der Maps App gestartet und die angeforderte Aktion ausgeführt.
- Wenn die Google Maps App nicht installiert ist, wird über die URL Google Maps in einem Browser gestartet und die angeforderte Aktion ausgeführt.
- Auf jedem anderen Gerät wird über die URL Google Maps in einem Browser gestartet und die angeforderte Aktion ausgeführt.
Es wird empfohlen, eine plattformübergreifende URL zu verwenden, um Google Maps über Ihre App oder Website zu starten, da diese universellen URLs eine umfassendere Bearbeitung der Kartenanfragen ermöglichen, unabhängig von der verwendeten Plattform. Für Funktionen, die möglicherweise nur auf einer mobilen Plattform funktionieren (z. B. die detaillierte Routenführung), sollten Sie eine plattformspezifische Option für Android oder iOS verwenden. Weitere Informationen finden Sie in der folgenden Dokumentation:
- Google Maps Intents for Android – speziell für die Einführung der Google Maps App for Android
- Google Maps-URL-Schema für iOS – speziell für die Einführung der Google Maps App für iOS
Google Maps starten und eine bestimmte Aktion ausführen
Wenn Sie Google Maps starten und optional eine der unterstützten Funktionen ausführen möchten, verwenden Sie je nach angeforderter Aktion ein URL-Schema in einem der folgenden Formate:
- Suche – Starten Sie eine Google Maps-Karte, auf der eine Markierung für einen bestimmten Ort angezeigt wird, oder führen Sie eine allgemeine Suche durch und starten Sie eine Karte, auf der die Ergebnisse angezeigt werden:
https://www.google.com/maps/search/?api=1¶meters
- Route – Fordern Sie eine Wegbeschreibung an und starten Sie Google Maps mit den Ergebnissen:
https://www.google.com/maps/dir/?api=1¶meters
- Karte anzeigen – starten Sie Google Maps ohne Markierungen oder Wegbeschreibungen:
https://www.google.com/maps/@?api=1&map_action=map¶meters
- Street View-Panorama ansehen – starten Sie ein interaktives Panoramabild:
https://www.google.com/maps/@?api=1&map_action=pano¶meters
Wichtig: Der Parameter api=1
gibt die Version der Maps-URLs an, für die diese URL bestimmt ist. Dieser Parameter ist in jeder Anfrage erforderlich. Der einzige gültige Wert ist 1. Ist api=1
NICHT in der URL vorhanden, werden alle Parameter ignoriert und je nach verwendeter Plattform (z. B. https://www.google.com/maps) entweder in einem Browser oder in der mobilen Google Maps App die Google Maps-Standard-App gestartet.
Gültige URLs erstellen
URLs müssen richtig codiert werden.
Beispielsweise wird bei einigen Parametern ein Pipe-Zeichen (|
) als Trennzeichen verwendet, das in der finalen URL als %7C
codiert werden muss. Andere Parameter verwenden kommagetrennte Werte wie Breiten- und Längengradkoordinaten oder Stadt, Bundesland. Das Komma muss als %2C
codiert werden. Codieren Sie Leerzeichen mit %20
oder ersetzen Sie sie durch ein Pluszeichen (+
).
Außerdem sind URLs für jede Anfrage auf 2.048 Zeichen beschränkt. Diese Beschränkung solltest du beim Erstellen der URLs beachten.
Kartenaktionen
Folgende Kartenaktionen sind verfügbar: Suche, Wegbeschreibung, Karte und Street View-Panorama. Sie geben die Aktion zusammen mit den erforderlichen und optionalen Parametern in der Anfrage-URL an. Wie bei URLs üblich, trennen Sie Parameter mit dem Und-Zeichen (&
). Für jede Aktion sind im Abschnitt Suchparameter die Liste der Parameter und ihre möglichen Werte aufgeführt.
Suche
Durch die Suchaktion werden Ergebnisse für eine Suche im sichtbaren Kartenbereich angezeigt. Wenn nach einem bestimmten Ort gesucht wird, wird in der angezeigten Karte eine Markierung an diesem Ort platziert und es werden verfügbare Ortsdetails angezeigt.
Such-URL erstellen
https://www.google.com/maps/search/?api=1¶meters
Parameter
query
(erforderlich): Definiert die Orte, die auf der Karte hervorgehoben werden sollen. Der Abfrageparameter ist für alle Suchanfragen erforderlich.- Geben Sie Standorte entweder als Ortsname, als Adresse oder als kommagetrennte Breiten- und Längengradkoordinaten an. Strings sollten URL-codiert werden, sodass eine Adresse wie „City Hall, New York, NY“ in
City+Hall%2C+New+York%2C+NY
umgewandelt werden sollte. - Gib allgemeine Suchbegriffe als URL-codierten String an, z. B.
grocery+stores
oderrestaurants+in+seattle+wa
.
- Geben Sie Standorte entweder als Ortsname, als Adresse oder als kommagetrennte Breiten- und Längengradkoordinaten an. Strings sollten URL-codiert werden, sodass eine Adresse wie „City Hall, New York, NY“ in
query_place_id
(optional): Eine Orts-ID ist eine Kennung in Textform, die einen Ort eindeutig identifiziert. Für die Aktionsearch
müssen Sie einenquery
angeben. Sie können aber auch einequery_place_id
angeben. Falls Sie beide Parameter angeben, wirdquery
nur verwendet, wenn Google Maps die Orts-ID nicht findet. Wenn Sie eine bestimmte Einrichtung eindeutig verknüpfen möchten, ist die Orts-ID die beste Garantie dafür, dass Sie auf den richtigen Ort verweisen. Außerdem wird empfohlen,query_place_id
anzugeben, wenn Sie mithilfe von Breiten- und Längengraden einen bestimmten Ort abfragen.
Suchbeispiele
Standortsuche
Bei einer Standortsuche suchen Sie mithilfe eines Ortsnamens, einer Adresse oder durch Kommas getrennten Koordinaten für Breiten- und Längengrad nach einem bestimmten Standort. Auf der Karte wird dann eine Markierung für diesen Standort angezeigt. Diese drei Beispiele veranschaulichen die Suche nach demselben Standort, CenturyLink Field (ein Sportstadion in Seattle, Washington), unter Verwendung verschiedener Standortwerte.
Beispiel 1: Die Suche nach dem Ortsnamen "CenturyLink Field" führt in der folgenden Karte:
https://www.google.com/maps/search/?api=1&query=centurylink+field
Beispiel 2: Die Suche nach dem CenturyLink-Feld mithilfe von Breiten- und Längengradkoordinaten sowie der Orts-ID ergibt die folgende Karte:
Beispiel 3: In der folgenden Karte wird nach dem CenturyLink-Feld nur mit Längen- und Breitengraden gesucht. In der Karte ist zwar eine Markierung zu sehen, aber es werden keine zusätzlichen Ortsinformationen auf der Karte oder in der Seitenleiste angezeigt:
https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393
Kategoriale Suche
Bei einer kategorialen Suche übergeben Sie einen allgemeinen Suchbegriff. Google Maps sucht dann nach Angeboten in der Nähe des von Ihnen angegebenen Standorts, die Ihren Kriterien entsprechen.
Wenn Sie keinen Standort angeben, sucht Google Maps nach Angeboten in der Nähe Ihres aktuellen Standorts. Wenn Sie einen Standort für eine kategoriale Suche angeben möchten, fügen Sie ihn in den allgemeinen Suchstring ein (z. B. pizza+seattle+wa
).
In diesem Beispiel ergibt eine Suche nach Pizzerien in Seattle, WA, die folgende Karte:
https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa
Directions
Bei der Aktion „Route“ werden die Strecke zwischen zwei oder mehr angegebenen Punkten auf der Karte, die Entfernung und die Reisezeit angezeigt.
Routen-URL erstellen
https://www.google.com/maps/dir/?api=1¶meters
Parameter
origin
: Definiert den Startpunkt, von dem aus die Route angezeigt werden soll. Die Standardeinstellung ist der relevanteste Startort, z. B. der Gerätestandort (falls verfügbar). Wenn keiner vorhanden ist, enthält die resultierende Karte möglicherweise ein leeres Formular, in das der Nutzer den Ursprung eingeben kann. Der Wert kann entweder ein Ortsname, eine Adresse oder durch Kommas getrennte Breiten-/Längengradkoordinaten sein. Ein String sollte URL-codiert werden, sodass eine Adresse wie „City Hall, New York, NY“ inCity+Hall%2C+New+York%2C+NY
umgewandelt werden sollte.Hinweis:Dieser Parameter ist optional, sofern Sie in Ihrer URL keine
origin_place_id
angeben. Wenn du einorigin_place_id
angeben möchtest, musst du auch einorigin
in die URL aufnehmen.origin_place_id
(optional): Eine Orts-ID ist eine Kennung in Textform, die einen Ort eindeutig identifiziert. Wenn Sie eine Einrichtung endgültig festlegen möchten, ist die Verwendung einer Orts-ID die beste Garantie, um auf den richtigen Ort zu verweisen. URLs, die diesen Parameter verwenden, müssen außerdem einorigin
enthalten.destination
: Definiert den Endpunkt der Route. Falls keiner vorhanden ist, enthält die resultierende Karte möglicherweise ein leeres Formular, in das der Nutzer das Ziel eingeben kann. Der Wert kann entweder ein Ortsname, eine Adresse oder durch Kommas getrennte Breiten-/Längengradkoordinaten sein. Ein String sollte URL-codiert werden, sodass eine Adresse wie „City Hall, New York, NY“ inCity+Hall%2C+New+York%2C+NY
umgewandelt werden sollte.Hinweis:Dieser Parameter ist optional, sofern Sie in Ihrer URL keine
destination_place_id
angeben. Wenn du eindestination_place_id
angeben möchtest, musst du auch eindestination
in die URL aufnehmen.destination_place_id
(optional): Eine Orts-ID ist eine Kennung in Textform, die einen Ort eindeutig identifiziert. Wenn Sie eine Einrichtung endgültig festlegen möchten, ist die Verwendung einer Orts-ID die beste Garantie, um auf den richtigen Ort zu verweisen. URLs, die diesen Parameter verwenden, müssen auch einendestination
enthalten.travelmode
(optional): Definiert die Mobilitätsform. Zur Auswahl stehendriving
,walking
(für Fußgängerwege und Bürgersteige, falls verfügbar),bicycling
(Routen über Fahrradwege und bevorzugte Straßen, falls verfügbar) odertransit
. Wenn keintravelmode
angegeben ist, wird auf der Google Maps-Karte einer oder mehrere der relevantesten Modi für die angegebene Route und/oder die Nutzereinstellungen angezeigt.dir_action=navigate
(optional): Startet entweder die detaillierte Routenführung oder die Routenvorschau zum angegebenen Ziel, je nachdem, ob der Startort verfügbar ist. Wenn der Nutzer einen Startort angibt, der sich nicht in der Nähe des aktuellen Standorts des Nutzers befindet oder der aktuelle Gerätestandort nicht verfügbar ist, wird auf der Karte eine Routenvorschau gestartet. Wenn der Nutzer keinen Startort angibt (in diesem Fall der aktuelle Gerätestandort als Startort ausgewählt wird) oder der Startort in der Nähe des aktuellen Standorts des Nutzers liegt, startet die Karte die detaillierte Routenführung. Die Navigation ist nicht in allen Google Maps-Produkten und/oder zwischen allen Zielen verfügbar. In diesen Fällen wird dieser Parameter ignoriert.waypoints
: Gibt einen oder mehrere Zwischenorte an, über die die Route zwischenorigin
unddestination
verlaufen soll. Du kannst mehrere Wegpunkte angeben, indem du einen senkrechten Strich (|
) zum Trennen der Stellen verwendest (z. B.Berlin,Germany|Paris,France
). Die Anzahl der Wegpunkte variiert je nach Plattform, auf der der Link geöffnet wird. In mobilen Browsern werden bis zu drei Wegpunkte unterstützt, ansonsten maximal neun. Die Wegpunkte werden auf der Karte in der Reihenfolge angezeigt, in der sie in der URL aufgeführt sind. Wegpunkte können entweder ein Ortsname, eine Adresse oder durch Kommas getrennte Breiten-/Längengradkoordinaten sein. Strings sollten URL-codiert werden, also sollten Wegpunkte wie „Berlin,Germany|Paris,France“ inBerlin%2CGermany%7CParis%2CFrance
umgewandelt werden.Hinweise:
- Wegpunkte werden nicht von allen Google Maps-Produkten unterstützt. In diesen Fällen wird dieser Parameter ignoriert.
- Dieser Parameter ist optional, sofern Sie in der URL nicht
waypoint_place_ids
angeben. Wenn duwaypoint_place_ids
angeben möchtest, musst du auchwaypoints
in die URL aufnehmen.
waypoint_place_ids
(optional): Eine Orts-ID ist eine Kennung in Textform, die einen Ort eindeutig identifiziert. MitWaypoint_place_ids
können Sie eine Liste von Orts-IDs angeben, die mit der Liste derwaypoints
übereinstimmen. Orts-IDs sollten in derselben Reihenfolge wie die Wegpunkte aufgelistet und durch den senkrechten Strich „|
“ ( URL-codiert als%7C
) getrennt werden. Wenn Sie bestimmte Einrichtungen eindeutig angeben möchten, sind Orts-IDs die beste Garantie dafür, dass Sie auf die richtigen Orte verweisen. URLs, die diesen Parameter verwenden, müssen auchwaypoints
enthalten.avoid
(optional): Legt Funktionen fest, die vermieden werden sollen. Es kann auf eine oder mehrere der folgenden Optionen festgelegt werden, getrennt durch ein Komma „,
“ ( URL-codiert als%2C
):ferries
highways
tolls
Beispiele für Wegbeschreibungen
Über die folgende URL wird eine Karte im Routenmodus gestartet und ein Formular bereitgestellt, in das der Nutzer den Start- und Zielort eingeben kann.
https://www.google.com/maps/dir/?api=1
Im folgenden Beispiel wird eine Karte mit Fahrradrouten von der Space Needle zum Pike Place Market in Seattle, Washington, gestartet.
Im folgenden Beispiel wird eine Karte mit Fußgängerrouten von Google in Sydney, Australien, zum Queen Victoria Building gestartet.
Eine Karte anzeigen
Die Kartenaktion gibt eine Karte ohne Markierungen oder Wegbeschreibungen zurück.
Karten-URL erstellen
https://www.google.com/maps/@?api=1&map_action=map¶meters
Parameter
map_action=map
(erforderlich): Gibt den Typ der anzuzeigenden Kartenansicht an. Maps und Street View haben denselben Endpunkt. Damit eine Karte angezeigt wird, mussmap_action
alsmap
angegeben werden.center
(optional): Definiert die Mitte des Kartenfensters und akzeptiert Breiten- und Längengradkoordinaten als kommagetrennte Werte (z. B.-33.8569,151.2152
).zoom
(optional): Legt die anfängliche Zoomstufe der Karte fest. Zulässige Werte sind ganze Ganzzahlen zwischen 0 (die ganze Welt) und 21 (einzelne Gebäude). Die Obergrenze kann je nach den für den ausgewählten Ort verfügbaren Kartendaten variieren. Der Standardwert ist 15.basemap
(optional): Definiert den anzuzeigenden Kartentyp. Der Wert kann entwederroadmap
(Standard),satellite
oderterrain
sein.layer
(optional): Definiert eine zusätzliche Ebene, die auf der Karte angezeigt werden soll, falls vorhanden. Folgende Werte sind möglich:none
(Standard),transit
,traffic
oderbicycling
.
Beispiele für Karten
Mit dieser Beispiel-URL wird eine Google-Standardkarte aufgerufen, die auf den aktuellen Standort des Nutzers zentriert ist.
https://www.google.com/maps/@?api=1&map_action=map
Im folgenden Beispiel wird eine Karte angezeigt, deren Mittelpunkt Katoomba, NSW, Australien (unter -33.712206,150.311941
) ist, und die optionalen Parameter zoom
und basemap
festlegen.
Street View-Panorama anzeigen
Mit der Panoramaaktion können Sie einen Viewer starten, um Street View-Bilder als interaktive Panoramen anzuzeigen. Jedes Street View-Panorama bietet eine 360-Grad-Ansicht eines einzelnen Orts. Die Bilder bieten eine 360-Grad-Horizontalsicht (vollständige Rundumsicht) und eine 180-Grad-Vertikalsicht (von senkrecht oben bis senkrecht unten). Durch die Panoramaaktion wird ein Viewer gestartet, das das Panorama als Kugel mit einer Kamera im Mittelpunkt rendert. Sie können die Kamera bearbeiten, um den Zoom und die Ausrichtung der Kamera zu steuern.
Google Street View bietet Panoramaansichten von bestimmten Orten im gesamten Google Street View-Abdeckungsbereich. Von Nutzern bereitgestellte 360°-Fotos und ausgewählte Street View-Sammlungen sind ebenfalls verfügbar.
Street View-URL erstellen
https://www.google.com/maps/@?api=1&map_action=pano¶meters
Parameter
map_action=pano
(erforderlich): Gibt den anzuzeigenden Ansichtstyp an. Maps und Street View haben denselben Endpunkt. Damit ein Panorama angezeigt wird, mussaction
alspano
angegeben werden.
Außerdem ist einer der folgenden URL-Parameter erforderlich:
viewpoint
: Der Viewer zeigt das Panorama an, das am nächsten amviewpoint
-Ort fotografiert wurde. Die Angabe erfolgt in Form von durch Kommas getrennten Koordinaten für Breiten- und Längengrad, z. B. 46.414382,10.013988. Da die Street View-Bilder regelmäßig aktualisiert werden und Fotos jedes Mal an leicht unterschiedlichen Positionen aufgenommen werden können, ist es möglich, dass Ihr Standort bei der Aktualisierung der Bilder zu einem anderen Panorama wechselt.pano
: Die spezifische Panorama-ID des anzuzeigenden Bildes. Wenn dupano
angibst, kannst du auchviewpoint
angeben.viewpoint
wird nur verwendet, wenn Google Maps die Panorama-ID nicht finden kann. Wennpano
angegeben, aber nicht gefunden wurde undviewpoint
NICHT angegeben wurde, wird kein Panoramabild angezeigt. Stattdessen wird Google Maps im Standardmodus geöffnet und es wird eine Karte mit dem aktuellen Standort des Nutzers angezeigt.
Folgende URL-Parameter sind optional:
heading
: Gibt die Kompassrichtung der Kamera in Grad im Uhrzeigersinn von Norden aus an. Zulässige Werte sind -180 bis 360 Grad. Ohne Angabe wird eine Standardausrichtung basierend auf dem Blickwinkel (falls angegeben) der Abfrage und der tatsächlichen Position des Bildes ausgewählt.pitch
: Gibt den Neigungswinkel der Kamera an (nach oben oder unten). Die Neigung wird in Grad zwischen -90 und 90 angegeben. Positive Werte bewirken, dass die Kamera nach oben gerichtet wird, negative Werte den Winkel nach unten. Die Standardneigung von 0 wird anhand der Position der Kamera zum Zeitpunkt der Aufnahme festgelegt. Aus diesem Grund ist ein Neigungswinkel von 0 häufig, aber nicht immer, horizontal. Ein Bild, das auf einem Hügel aufgenommen wurde, wird wahrscheinlich einen Standardneigungswinkel haben, der nicht horizontal ist.fov
: Bestimmt das horizontale Sichtfeld des Bilds. Das Sichtfeld wird in Grad mit einem Bereich von 10 bis 100 ausgedrückt. Der Standardwert ist 90. Bei einem Darstellungsbereich mit fester Größe wird das Sichtfeld als Zoomstufe betrachtet, wobei kleinere Zahlen eine höhere Zoomstufe angeben.
Street View-Beispiele
Die ersten beiden Beispiele zeigen ein Panorama des Eiffelturms. Im ersten Beispiel wird nur ein viewpoint
für den Standort verwendet und die optionalen Parameter heading
, pitch
und fov
werden festgelegt. Zum Vergleich: In Beispiel 2 werden eine pano
-ID und die im ersten Beispiel festgelegten Parameter verwendet. Im dritten Beispiel wird ein Indoor-Panoramabild angezeigt.
Beispiel 1: Zur Angabe des Standorts wird nur viewpoint
verwendet.
Beispiel 2: Verwendet eine pano
-ID sowie einen viewpoint
-Standort.
Die pano
-ID hat Vorrang vor der viewpoint
.
In diesem Beispiel wird die Panorama-ID ermittelt, daher wird viewpoint
ignoriert. Das Panoramabild, das für die ID pano
angezeigt wird, unterscheidet sich geringfügig und ist aktueller als das Bild, das nur mit viewpoint
gefunden wurde.
Beispiel 3: Zeigt ein Panorama des Innenbereichs des Restaurants Sarastro in London, Vereinigtes Königreich, mit einer Panorama-ID an.
https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA
Ermitteln der Panorama-ID
Es gibt mehrere Methoden, um die ID eines bestimmten Panoramabildes zu ermitteln.
- Verwenden Sie für JavaScript die Klasse StreetViewPanorama.
- Verwenden Sie für Android die öffentliche Klasse StreetViewPanoramaLocation.
- Verwenden Sie für iOS die GMSPanorama-Klasse.
- Du kannst auch Metadatenanfragen über die Google Street View Image API stellen. Metadatenanfragen für Bilder liefern Daten zu Street View-Panoramen, einschließlich der Panorama-ID.
Weitere Beispiele
Beispiele für Routen mit Wegpunkten
In den folgenden Beispielen wird Google Maps gestartet und es wird eine Wegbeschreibung von Paris (Frankreich) nach Cherbourg (Frankreich) mit folgenden Wegpunkten angezeigt:
Stadt, Land | Name | Orts-ID |
---|---|---|
1. Versailles, Frankreich | Schloss Versailles | ChIJdUyx15R95kcRj85ZX8H8OAU |
2. Chartres, Frankreich | Kathedrale von Chartres | ChIJKzGHdEgM5EcR_OBTT3nQoEA |
3. Le Mans, Frankreich | Kathedrale von Le Mans | ChIJG2LvQNCI4kcRKXNoAsPi1Mc |
4. Caen, Frankreich | Schloss Caen | ChIJ06tnGbxCCkgRsfNjEQMwUsc |
In den Beispiel-URLs sind die Wegpunkte unterschiedlich definiert, sodass Sie die Unterschiede bei der Anzeige der Wegpunkte auf den resultierenden Karten vergleichen können.
Beispiel 1: Wegpunkte als Ort, Land:
Beispiel 2: Wegpunkte, die als bestimmte Ortsnamen definiert sind:
Beispiel 3: Wegpunkte, die als Stadt oder Land definiert sind, sowie waypoint_place_ids
für eine bestimmte Einrichtung an jedem Wegpunkt:
Beispiel 4: Definiert Wegpunkte als Stadt, Land, listet die Wegpunkte jedoch in einer anderen Reihenfolge als in den vorherigen Beispielen auf. Zeigt, dass Wegpunkte auf der Karte in der Reihenfolge angezeigt werden, in der sie in der URL aufgeführt sind.
Beispiele für Karten
Zeigt eine Karte mit einer angegebenen basemap
(Satellit) und layer
(öffentliche Verkehrsmittel) an.
Street View-Beispiele
Zeigt ein Street View-Panorama mit einem FIFE-Bildschlüssel als pano
-ID an. Beachten Sie, dass der pano
-ID F: vorangestellt ist.