Einführung
Mit 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 anzuzeigen. Die URL-Syntax ist unabhängig von der verwendeten Plattform identisch.
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 angeforderte 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 die URL in der Google Maps App gestartet und die angeforderte Aktion ausgeführt.
- Wenn die Google Maps App nicht installiert oder deaktiviert ist, startet die URL Google Maps in einem Browser und führt die angeforderte Aktion aus.
- Auf einem iOS-Gerät:
- Wenn die Google Maps App für iOS installiert ist, startet die URL Google Maps in der Maps App und führt die angeforderte Aktion aus.
- Ist die Google Maps App nicht installiert, startet die URL Google Maps in einem Browser und führt die angeforderte Aktion aus.
- Auf jedem anderen Gerät wird die URL in einem Browser aufgerufen und die angeforderte Aktion wird ausgeführt.
Wir empfehlen, eine plattformübergreifende URL zu verwenden, um Google Maps über Ihre App oder Website zu starten. Mit diesen universellen URLs können Sie die Maps-Anfragen unabhängig von der verwendeten Plattform umfassender verarbeiten. Für Funktionen, die möglicherweise nur auf einer mobilen Plattform funktionieren, wie etwa die detaillierte Routenführung, empfiehlt es sich, eine plattformspezifische Option für Android oder iOS zu verwenden. Weitere Informationen finden Sie in der folgenden Dokumentation:
- Google Maps Intents für Android – insbesondere zur Einführung der Google Maps App für Android
- Google Maps URL Scheme für iOS – speziell zum Starten der Google Maps App für iOS
Google Maps starten und eine bestimmte Aktion ausführen
Verwenden Sie ein URL-Schema in einer der folgenden Formen, um Google Maps zu starten und optional eine der unterstützten Funktionen auszuführen:
- Suchen — Starte eine Google-Karte, auf der eine Markierung für einen bestimmten Ort zu sehen ist, oder führe eine allgemeine Suche durch und starte eine Karte, um die Ergebnisse anzuzeigen:
https://www.google.com/maps/search/?api=1¶meters
- Wegbeschreibungen
– Wegbeschreibungen abrufen und Google Maps mit den Ergebnissen starten:
https://www.google.com/maps/dir/?api=1¶meters
- Karte anzeigen
– Google Maps ohne Markierungen oder Wegbeschreibungen starten:
https://www.google.com/maps/@?api=1&map_action=map¶meters
- Street View-Panorama aufrufen – ein interaktives Panoramabild starten:
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. Wenn api=1
NICHT in der URL vorhanden ist, werden alle Parameter ignoriert und die standardmäßige Google Maps App gestartet, entweder in einem Browser oder in der mobilen Google Maps App, je nach verwendeter Plattform (z. B. https://www.google.com/maps).
Gültige URLs erstellen
URLs müssen ordnungsgemäß codiert werden.
Einige Parameter verwenden beispielsweise einen senkrechten Strich (|
) als Trennzeichen, den Sie in der finalen URL als %7C
codieren müssen. Andere Parameter verwenden kommagetrennte Werte, wie Breitengrad/Längengrad-Koordinaten oder Stadt, Bundesland. Du musst das Komma als %2C
codieren. Codiere Leerzeichen mit %20
oder ersetze sie durch ein Pluszeichen (+
).
Außerdem sind URLs auf 2.048 Zeichen pro Anfrage begrenzt. Berücksichtigen Sie diesen Grenzwert beim Erstellen Ihrer URLs.
Kartenaktionen
Folgende Kartenaktionen stehen zur Verfügung: Suche, Routenplaner, Karte und Street View-Panorama anzeigen. Sie geben die Aktion in der Anfrage-URL zusammen mit den erforderlichen und optionalen Parametern an. Wie in URLs üblich, trennen Sie Parameter durch das kaufmännische Und-Zeichen (&
). Für jede Aktion wird die Liste der Parameter und ihre möglichen Werte im Abschnitt Suchparameter aufgelistet.
Suchen
Die Suchaktion zeigt Ergebnisse für eine Suche im sichtbaren Kartenbereich an. Wenn Sie nach einem bestimmten Ort suchen, wird eine Markierung auf der Karte angezeigt und die verfügbaren Ortsdetails werden angezeigt.
Such-URL bilden
https://www.google.com/maps/search/?api=1¶meters
Parameter
query
(erforderlich): Definiert die Orte, die auf der Karte hervorgehoben werden sollen. Der Suchparameter ist für alle Suchanfragen erforderlich.- Sie können Orte als Ortsnamen, Adressen oder durch Kommas getrennte Breiten- und Längengrade angeben. Strings sollten URL-codiert werden. Eine Adresse wie „City Hall, New York, NY“ sollte daher in
City+Hall%2C+New+York%2C+NY
umgewandelt werden. - Gib allgemeine Suchbegriffe als URL-codierten String an, z. B.
grocery+stores
oderrestaurants+in+seattle+wa
.
- Sie können Orte als Ortsnamen, Adressen oder durch Kommas getrennte Breiten- und Längengrade angeben. Strings sollten URL-codiert werden. Eine Adresse wie „City Hall, New York, NY“ sollte daher in
query_place_id
(optional): Eine Orts-ID ist eine ID in Textform, die einen Ort eindeutig bezeichnet. Für die Aktionsearch
müssen Sie einequery
, aber auch einequery_place_id
angeben. Wenn Sie beide Parameter angeben, wirdquery
nur verwendet, wenn Google Maps die Orts-ID nicht finden kann. Wenn Sie eine eindeutige Verknüpfung zu einer bestimmten Einrichtung herstellen möchten, ist die Orts-ID die beste Möglichkeit, eine Verknüpfung mit dem richtigen Ort herzustellen. Es wird außerdem empfohlen,query_place_id
anzugeben, wenn Sie mithilfe von Breiten- und Längengraden einen bestimmten Standort abfragen.
Suchbeispiele
Standortsuche
Bei einer Standortsuche suchen Sie anhand eines Ortsnamens, einer Adresse oder durch Kommas getrennter Breiten-/Längengradkoordinaten nach einem bestimmten Standort. Die daraufhin angezeigte Karte zeigt dann eine Stecknadel an. Diese drei Beispiele zeigen Suchanfragen für denselben Standort, CenturyLink Field, ein Sportstadion in Seattle, Washington, mit verschiedenen Standortwerten.
Beispiel 1: Die Suche nach dem Ortsnamen „CenturyLink Field“ ergibt die folgende Karte:
https://www.google.com/maps/search/?api=1&query=centurylink+field
Beispiel 2: In der folgenden Karte sehen Sie mithilfe von Breiten- und Längengraden sowie der Orts-ID die Suche nach CenturyLink-Feld:
Beispiel 3: Die Suche nach einem CenturyLink-Feld mit ausschließlich Breitengrad/Längengrad-Koordinaten führt zur folgenden Karte. In der Karte ist eine Markierung zu sehen, auf der Karte oder in der Seitenleiste werden aber keine zusätzlichen Informationen zu Orten angezeigt:
https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393
Kategoriale Suche
Bei einer kategorischen Suche übergeben Sie einen allgemeinen Suchbegriff. Google Maps sucht dann nach Einträgen, die Ihren Kriterien in der Nähe des von Ihnen angegebenen Standorts entsprechen.
Wenn kein Standort angegeben ist, versucht Google Maps, Einträge in der Nähe deines aktuellen Standorts zu finden. Wenn Sie lieber einen Standort für eine kategoriale Suche angeben möchten, nehmen Sie den Standort in den allgemeinen Suchstring auf (z. B. pizza+seattle+wa
).
In diesem Beispiel ergibt die Suche nach Pizzerien in Seattle, WA, USA:
https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa
Directions
Die Routenplaneraktion zeigt den Pfad zwischen zwei oder mehr Punkten auf der Karte sowie die Entfernung und die Reisezeit an.
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. Standardmäßig wird der relevanteste Ausgangsort verwendet, z. B. der Gerätestandort, falls verfügbar. Wenn keine vorhanden ist, enthält die resultierende Karte möglicherweise ein leeres Formular, über das ein Nutzer den Ursprung eingeben kann. Der Wert kann entweder ein Ortsname, eine Adresse oder ein durch Kommas getrennte Koordinaten sein. Ein String muss URL-codiert sein. Eine Adresse wie „City Hall, New York, NY“ sollte daher inCity+Hall%2C+New+York%2C+NY
umgewandelt werden.Hinweis:Dieser Parameter ist optional, sofern Sie in der URL nicht
origin_place_id
angeben. Wenn duorigin_place_id
angibst, musst du auch einorigin
in die URL aufnehmen.origin_place_id
(optional): Eine Orts-ID ist eine ID in Textform, die einen Ort eindeutig bezeichnet. Wenn Sie eine Einrichtung eindeutig angeben möchten, ist die Verwendung einer Orts-ID die beste Garantie, dass Sie auf den richtigen Ort verweisen. URLs, die diesen Parameter verwenden, müssen auch einorigin
enthalten.destination
: Definiert den Endpunkt der Route. Wenn keine vorhanden ist, enthält die resultierende Karte möglicherweise ein leeres Formular, über das der Nutzer das Ziel eingeben kann. Der Wert kann entweder ein Ortsname, eine Adresse oder ein durch Kommas getrennte Koordinaten sein. Ein String muss URL-codiert sein. Eine Adresse wie „City Hall, New York, NY“ sollte daher inCity+Hall%2C+New+York%2C+NY
umgewandelt werden.Hinweis:Dieser Parameter ist optional, sofern Sie in der URL nicht
destination_place_id
angeben. Wenn dudestination_place_id
angibst, musst du auch eindestination
in die URL aufnehmen.destination_place_id
(optional): Eine Orts-ID ist eine ID in Textform, die einen Ort eindeutig bezeichnet. Wenn Sie eine Einrichtung eindeutig angeben möchten, ist die Verwendung einer Orts-ID die beste Garantie, dass Sie auf den richtigen Ort verweisen. URLs, die diesen Parameter verwenden, müssen auch eindestination
enthalten.travelmode
(optional): Definiert die Mobilitätsform. Mögliche Optionen sinddriving
,walking
(wo Fußgängerwege und Bürgersteige bevorzugt werden, falls verfügbar),bicycling
(die Routen mit Fahrradwegen und bevorzugten Straßen, sofern verfügbar), odertransit
. Wenn keintravelmode
angegeben ist, werden in 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 Ursprung verfügbar ist. Wenn der Nutzer einen Ursprungsort angibt und 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 Ursprung angibt (in diesem Fall wird standardmäßig der aktuelle Standort des Geräts verwendet) oder der Ort in der Nähe des aktuellen Standorts des Nutzers liegt, wird auf der Karte die detaillierte Routenführung gestartet. Beachten Sie, dass die Navigation nicht für alle Google Maps-Produkte und/oder zwischen allen Zielen verfügbar ist. In diesen Fällen wird dieser Parameter ignoriert.waypoints
: Gibt einen oder mehrere Zwischenstellen an, über die Routen zwischenorigin
unddestination
geleitet werden können. Sie können mehrere Wegpunkte angeben, indem Sie den senkrechten Strich (|
) verwenden, um Orte zu trennen (z. B.Berlin,Germany|Paris,France
). Die Anzahl der zulässigen Wegpunkte variiert je nach Plattform, auf der der Link geöffnet wird. Bis zu drei Wegpunkte werden in mobilen Browsern unterstützt, maximal neun Wegpunkte. Wegpunkte werden auf der Karte in der Reihenfolge angezeigt, in der sie in der URL aufgeführt sind. Jeder Wegpunkt kann entweder ein Ortsname, eine Adresse oder ein durch Kommas getrennte Koordinaten sein. Strings sollten URL-codiert werden, sodass Wegpunkte wie „Berlin,Deutschland|Paris,Frankreich“ inBerlin%2CGermany%7CParis%2CFrance
umgewandelt werden sollten.Hinweise:
- Wegpunkte werden nicht in allen Google Maps-Produkten unterstützt. In diesen Fällen wird der Parameter ignoriert.
- Dieser Parameter ist optional, sofern Sie in der URL nicht
waypoint_place_ids
angeben. Wenn duwaypoint_place_ids
angibst, musst du auchwaypoints
in die URL aufnehmen.
waypoint_place_ids
(optional): Eine Orts-ID ist eine ID in Textform, die einen Ort eindeutig bezeichnet. MitWaypoint_place_ids
können Sie eine Liste mit Orts-IDs angeben, die mit der Liste inwaypoints
übereinstimmen. Orts-IDs müssen in derselben Reihenfolge wie die Wegpunkte aufgelistet und durch ein Pipe-Zeichen „|
“ (URL-codiert als%7C
) getrennt werden. Wenn du bestimmte Einrichtungen definitiv angeben möchtest, sind Orts-IDs die beste Möglichkeit, eine Verknüpfung mit den richtigen Orten herzustellen. URLs, die diesen Parameter verwenden, müssen auchwaypoints
enthalten.
Beispiele für Wegbeschreibungen
Mit der folgenden URL wird eine Karte im Routenplanermodus gestartet. Sie enthält ein Formular, über 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 vom Space Needle zum Pike Place Market in Seattle, WA, eingeführt.
Im folgenden Beispiel wird eine Karte mit Fußgängerroute 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 bilden
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ängengrade als durch Kommas getrennte Werte (z. B.-33.8569,151.2152
).zoom
(optional): Legt die anfängliche Zoomstufe der Karte fest. Zulässige Werte sind ganze Zahlen zwischen 0 (die ganze Welt) und 21 (einzelne Gebäude). Das obere Limit kann je nach Kartendaten für den ausgewählten Standort variieren. Der Standardwert ist 15.basemap
(optional): Definiert den anzuzeigenden Kartentyp. Der Wert kann entwederroadmap
(Standardwert),satellite
oderterrain
sein.layer
(optional): Definiert eine zusätzliche Ebene, die auf der Karte angezeigt werden kann, falls vorhanden. Folgende Werte sind möglich:none
(Standard),transit
,traffic
oderbicycling
.
Kartenbeispiele
Mit dieser Beispiel-URL wird eine standardmäßige Google Maps-Karte in der Mitte des aktuellen Standorts des Nutzers geöffnet.
https://www.google.com/maps/@?api=1&map_action=map
Im folgenden Beispiel wird eine Karte mit dem Mittelpunkt Katoomba, NSW, Australien (-33.712206,150.311941
) angezeigt und die optionalen Parameter zoom
und basemap
festgelegt.
Street View-Panorama aufrufen
Mit der Panoramaaktion können Sie einen Viewer starten, der Street View-Bilder als interaktive Panoramen darstellt. Jedes Street View-Panorama bietet eine 360°-Ansicht eines einzelnen Orts. Bilder bieten eine 360-Grad-Horizontalsicht (eine volle Drehung) und eine 180-Grad-Vertikalsicht (von senkrecht oben bis senkrecht unten). Mit der Panoramaaktion wird ein Viewer gestartet, das das Panorama als Kugel mit einer Kamera in der Mitte rendert. Sie können die Kamera bearbeiten, um den Zoom und die Ausrichtung der Kamera zu steuern.
Google Street View bietet im gesamten Abdeckungsbereich Panoramablick von ausgewählten Orten. Es sind auch von Nutzern bereitgestellte 360°-Panoramaaufnahmen und besondere Street View-Sammlungen verfügbar.
Street View-URL erstellen
https://www.google.com/maps/@?api=1&map_action=pano¶meters
Parameter
map_action=pano
(erforderlich): Gibt die Art der Ansicht an. Maps und Street View haben denselben Endpunkt. Damit ein Panorama angezeigt wird, mussaction
alspano
angegeben werden.
Einer der folgenden URL-Parameter ist ebenfalls erforderlich:
viewpoint
: Der Betrachter zeigt das Panorama an, das dem Standortviewpoint
am nächsten ist, angegeben als durch Kommas getrennte Koordinaten für den Längen- und Breitengrad (z. B. 46.414382,10.013988). Da Street View-Bilder regelmäßig aktualisiert werden und die Fotos jedes Mal an leicht unterschiedlichen Positionen aufgenommen werden, kann es passieren, dass Ihr Standort bei einer Aktualisierung der Bilder an ein anderes Panoramabild angrenzt.pano
: Die spezifische Panorama-ID des anzuzeigenden Bildes. Wenn Sie einepano
angeben, können Sie auch eineviewpoint
angeben.viewpoint
wird nur verwendet, wenn Google Maps die Panorama-ID nicht finden kann. Wennpano
angegeben, aber nicht gefunden undviewpoint
NICHT angegeben ist, wird kein Panoramabild angezeigt. Stattdessen wird Google Maps im Standardmodus geöffnet und eine Karte mit dem aktuellen Standort des Nutzers angezeigt.
Folgende URL-Parameter sind optional:
heading
: Gibt die Kompassausrichtung der Kamera in Grad im Uhrzeigersinn von Norden an. Zulässige Werte sind -180 bis 360 Grad. Wird kein Wert angegeben, wird eine Standardausrichtung basierend auf dem Blickwinkel (falls angegeben) der Abfrage und dem tatsächlichen Standort des Bildes ausgewählt.pitch
: Gibt den Neigungswinkel der Kamera an. Die Neigung wird in Grad zwischen -90 und 90 angegeben. Positive Werte versetzen den Winkel der Kamera nach oben, negative Werte dagegen nach unten. Die Standardneigung von 0 wird basierend auf der Kameraposition zum Zeitpunkt der Aufnahme festgelegt. Daher ist ein Tonwert von 0 oft, aber nicht immer, horizontal. So ist beispielsweise bei Bildern, die auf einem Hügel aufgenommen wurden, die Standardneigung wahrscheinlich nicht horizontal.fov
: Legt das horizontale Sichtfeld des Bildes fest. Das Sichtfeld wird in Grad mit einem Bereich von 10 bis 100 angegeben. Der Standardwert ist 90. Bei einem Darstellungsbereich mit fester Größe wird das Sichtfeld als Zoomstufe betrachtet. Kleinere Zahlen zeigen eine höhere Zoomstufe an.
Beispiele für Street View
Die ersten beiden Beispiele zeigen ein Panoramabild des Eiffelturms. Im ersten Beispiel wird nur eine viewpoint
für den Standort verwendet und die optionalen Parameter heading
, pitch
und fov
werden festgelegt. Zum Vergleich werden in Beispiel 2 eine pano
-ID und die Parameter aus dem ersten Beispiel verwendet. Im dritten Beispiel wird ein Panoramabild von innen angezeigt.
Beispiel 1: Es wird nur eine viewpoint
zur Angabe des Standorts verwendet.
Beispiel 2: Es werden eine pano
-ID und ein viewpoint
-Standort verwendet.
Die pano
-ID hat Vorrang vor der viewpoint
.
In diesem Beispiel wird die Panorama-ID gefunden. Daher wird viewpoint
ignoriert. Das Panoramabild, das für die ID pano
angezeigt wird, ist etwas anders und aktueller als das Bild, das nur mit dem viewpoint
angezeigt wird.
Beispiel 3: Zeigt eine Panoramaansicht des Innenbereichs des Sarastro-Restaurants in London, Vereinigtes Königreich, mit einer Panorama-ID.
https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA
Panorama-ID suchen
Es gibt mehrere Methoden, um die ID eines bestimmten Panoramabildes zu finden.
- Verwenden Sie für JavaScript die Klasse StreetViewPanorama.
- Für Android verwenden Sie die öffentliche Klasse StreetViewPanoramaLocation.
- Verwenden Sie für iOS die Klasse GMSPanorama.
- Du kannst auch Metadatenanfragen über die Google Street View Image API stellen. Bildmetadatenanfragen enthalten 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 werden Wegbeschreibungen von Paris, Frankreich nach Cherbourg, Frankreich angezeigt, die die folgenden Wegpunkte umfassen:
Stadt, Land | Name | Orts-ID |
---|---|---|
1. Versailles, Frankreich | Schloss Versailles | ChIJdUyx15R95kcRj85ZX8H8OAU |
2. Chartres, Frankreich | Kathedrale von Chartres | ChIJKzGHdEgM5EcR_OBTT3nQoEA |
3. Le Mans, Frankreich | Kathedrale des Heiligen Julian von Le Mans | ChIJG2LvQNCI4kcRKXNoAsPi1Mc |
4. Caen, Frankreich | Burg Caen | ChIJ06tnGbxCCkgRsfNjEQMwUsc |
In den Beispiel-URLs sind die Wegpunkte auf unterschiedliche Weise definiert, sodass Sie die Unterschiede bei der Anzeige der Wegpunkte auf den resultierenden Karten vergleichen können.
Beispiel 1: Wegpunkte, die als Stadt, Land definiert sind:
Beispiel 2: Als spezifische Ortsnamen definierte Wegpunkte:
Beispiel 3: Als „Stadt, Land“ definierte Wegpunkte und außerdem waypoint_place_ids
für eine bestimmte Einrichtung in jedem Wegpunkt:
Beispiel 4: Definiert Wegpunkte als Stadt, Land, listet die Wegpunkte aber in einer anderen Reihenfolge auf als die vorherigen Beispiele. Zeigt, dass auf der Karte Wegpunkte in der Reihenfolge angezeigt werden, in der sie in der URL aufgeführt sind.
Kartenbeispiele
Zeigt eine Karte mit den angegebenen basemap
(Satellit) und layer
(Transit) an.
Beispiele für Street View
Zeigt ein Street View-Panorama mit einem FIFE-Bildschlüssel als pano
-ID an Beachten Sie, dass der ID von pano
das Zeichen F: vorangestellt wird.