Nutzer mit einer Maps-URL oder der Places API zu Google Maps-Ortsdetails und -Wegbeschreibungen weiterleiten

In der heutigen standortbezogenen Welt erwarten Nutzer einen nahtlosen Zugriff auf Ortsinformationen, Wegbeschreibungen und Navigation. Ob über eine Messenger-App, eine App zur Erkundung des lokalen Kontexts , eine Logistik- und Transportplattform, einen Reiseplaner oder eine Immobilienplattform – Nutzer müssen oft schnell Standortdetails aufrufen oder die beste Route von A nach B finden. Entwickler können zwar ihre eigene In-App- Oberfläche erstellen, aber die umfassende und vertraute Oberfläche von Google Maps bietet eine bessere Nutzererfahrung.

Eine gut strukturierte Google Maps-URL ist für eine nahtlose Nutzererfahrung unerlässlich. Falsche URLs beeinträchtigen diese Erfahrung, indem sie Nutzer zum falschen Standort führen, eine allgemeine Kartenansicht anstelle spezifischer Details anzeigen oder sogar zu einem fehlerhaften Link führen. Das frustriert Nutzer und hindert sie daran, ihr Ziel zu erreichen. Selbst mit einer gültigen Maps-URL kann es passieren, dass ein Nutzer, der Details zu einem bestimmten Unternehmen erwartet, stattdessen auf einer allgemeinen Kartenansicht ohne relevante Informationen landet. Beispiel: 

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152

Diese Maps-URL ist gültig, um Google Maps zu öffnen und einen Standort basierend auf Breiten- und Längengrad anzuzeigen. Sie bietet Nutzern jedoch keine Details zu einem bestimmten Ort.

Nur mit Breiten- und Längengrad suchen
Nur mit Breiten- und Längengrad suchen

Nahtlose Verbindung Ihrer Anwendung mit Google Maps über genaue URLs

Die Seite mit den Ortsdetails in Google Maps aufrufen
Eine Maps-URL mit einem eindeutigen Ortsnamen führt Nutzer zur Detailseite dieses Orts in Google Maps

Die Google Maps Platform (GMP) bietet zwei Hauptmethoden zum Erstellen genauer URLs: die Places API(neu), für die ein API-Schlüssel erforderlich ist, und Maps-URLs, die kostenlos sind und keinen Schlüssel erfordern. Die folgenden Lösungen decken verschiedene Szenarien und Anwendungsfälle ab:

Die Places API(neu) der GMP gibt eine umfassende Reihe von Informationen zu einem bestimmten Ort zurück. Wenn Sie das Feld googleMapsUri oder googleMapsLinks anfordern (indem Sie es in der Feldmaske angeben), enthält die API-Antwort ein Ortsobjekt. Dieses Objekt enthält vorformatierte URLs, mit denen Sie die entsprechende Ansicht, z. B. die Ansicht mit den Ortsdetails, direkt in Google Maps öffnen können.

Beispiel:

„Place Details“-Anfrage

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
-H "X-Goog-FieldMask: googleMapsUri,googleMapsLinks" \
https://places.googleapis.com/v1/places/ChIJ3S-JXmauEmsRUcIaWtf4MzE

„Place Details“-Antwort:

{
    "googleMapsUri": "https://maps.google.com/?cid=3545450935484072529",
    "googleMapsLinks": {
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!3e0",
        "placeUri": "https://maps.google.com/?cid=3545450935484072529",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!10e5"
    }
}

ChIJ3S-JXmauEmsRUcIaWtf4MzE ist im obigen Beispiel die Orts-ID des Opernhauses in Sydney im obigen Beispiel. Eine Orts-ID ist eine Kennung in Textform, die einen Ort in der Google Places-Datenbank und in Google Maps eindeutig definiert.

Orts-IDs kostenlos abrufen

Wenn Sie Orts-IDs programmatisch abrufen möchten, können Sie die Funktion „Places API: Text Search(ID Only)“ verwenden. Dies ist eine kostenlose Methode zum Abrufen von Orts-IDs. Weitere Informationen zu Orts-IDs und zur Anfrage der Places API(neu)

„Places API: Text Search(ID Only)“-Anfrage:

curl -X POST -d '{"textQuery" : "Sydney Opera House"}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

„Places API: Text Search(ID Only)“-Antwort:

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

Orts-IDs können auch abgerufen werden, wenn ein Nutzer auf einen POI auf einer Karte klickt oder tippt. Weitere Informationen zu klickbaren POI-Symbolen(JavaScript, Android, iOS)

Implementierung

Wenn Sie die Places API verwenden, können Entwickler das Feld googleMapsUri oder googleMapsLinks einfach aus der Antwort extrahieren und damit die entsprechende Ansicht in der Google Maps App oder in einem Browser öffnen, falls die App nicht installiert ist.

Funktion Beschreibung
directionsUri Link zum Öffnen von Google Maps, um eine Wegbeschreibung vom aktuellen Standort des Nutzers zu diesem Ort anzuzeigen
placeUri Link zum Öffnen von Google Maps zur Detailseite für diesen Ort
writeAReviewUri Link zum Öffnen von Google Maps zur Seite zum Schreiben einer Rezension für diesen Ort
reviewsUri Link zum Öffnen von Google Maps zur Seite mit den Rezensionen für diesen Ort
photosUri Link zum Öffnen von Google Maps zur Seite mit den Fotos für diesen Ort

Sehen Sie sich die Entwickleranleitung an und probieren Sie die Funktion noch heute aus.

Maps-URLs verwenden

Mithilfe von Maps-URLs lässt sich eine universelle, plattformübergreifende URL erstellen, um Google Maps zu starten und dort Suchanfragen zu stellen, Wegbeschreibungen und Navigationsinformationen abzurufen sowie Kartenansichten und Panoramabilder anzusehen. Die URL-Syntax ist unabhängig von der verwendeten Plattform in Gebrauch. Sie benötigen keinen Google API-Schlüssel, um Maps-URLs zu verwenden.

Die verfügbaren Kartenaktionen sind:

  • Die Suchfunktion startet eine Google Maps App oder einen Browser, falls die App nicht installiert ist. Dort wird eine Markierung für einen bestimmten Ort angezeigt oder eine allgemeine Suche durchgeführt und eine Karte mit den Ergebnissen gestartet.

  • Die Funktion „Wegbeschreibung“ startet eine Google Maps App oder einen Browser, falls die App nicht installiert ist. Dort wird eine Wegbeschreibung zwischen zwei Punkten angezeigt oder die detaillierte Routenführung in Google Maps für Mobilgeräte aktiviert.

  • Mit der Funktion „Street View-Panorama“ können Sie einen Viewer starten, um Street View-Bilder als interaktive Panoramen anzuzeigen.

In der Entwicklerdokumentation zu Maps-URLs der GMP finden Sie weitere Funktionen und Beispiele.

Hier gehen wir auf zwei wichtige Funktionen von Maps-URLs ein:

  • Ortsdetails in Google Maps anzeigen:In diesem Abschnitt wird erläutert, wie Sie URLs erstellen, mit denen Details zu einem bestimmten Ort in Google Maps angezeigt werden. Außerdem wird beschrieben, wie Sie mit Orts-IDs und präzisen Suchanfragen mit Orten arbeiten, die keine eindeutigen Namen haben.

  • Wegbeschreibungen mit Maps-URLs bereitstellen:In diesem Abschnitt wird erläutert, wie Sie URLs erstellen, die Wegbeschreibungen zwischen Orten enthalten, einschließlich Wegbeschreibungen mit mehreren Wegpunkten und detaillierter Routenführung.

Ortsdetails in Google Maps anzeigen

Die Suchfunktion verwendet zwei Parameter, um die Ortssuche abzuschließen: sind query(erforderlich) und query_place_id(optional).

Der Parameter query ist für alle Suchanfragen erforderlich. Er akzeptiert einen Orts namen, durch Kommas getrennte Breiten-/Längengradkoordinaten oder einen allgemeinen Suchbegriff.

Die URL-Struktur für die Suche: 

https://www.google.com/maps/search/?api=1&parameters

Szenario 1: Ortsdetails für einen eindeutigen Ortsnamen anzeigen 

https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
 In diesem Beispiel wird nur der Ortsname angegeben. Diese URL öffnet die Detail seite für das Opernhaus in Sydney.

Die Seite mit den Ortsdetails in Google Maps aufrufen
Ortsnamen suchen und Ortsdetails anzeigen

Betrachten wir nun einen Ort mit einem nicht eindeutigen Namen. Was passiert, wenn Sie nur nach diesem nicht eindeutigen Namen suchen? Siehe nächstes Szenario.

Szenario 2: Orte nach einem nicht eindeutigen Ortsnamen suchen 

https://www.google.com/maps/search/?api=1&query=7-Eleven

Da der Ortsname nicht eindeutig ist, öffnet diese URL eine Liste mit 7‑Eleven-Standorten in der Nähe im sichtbaren Bereich. Nutzer können dann ein bestimmtes Geschäft auswählen, um die Details zu sehen.

Seite „Ortsliste“ in Google Maps öffnen
Seite mit der Ortsliste für die Suche nach einem nicht eindeutigen Namen

Wenn Sie die Liste der Orte vermeiden und direkt auf eine bestimmte Detailseite zugreifen möchten, können Sie eine genauere Methode verwenden. Siehe nächstes Beispiel.

Szenario 3: Ortsdetails für einen nicht eindeutigen Ortsnamen anzeigen

Bei häufigen Ortsnamen gibt eine einfache Namenssuche oft eine Liste von Orten zurück. Wenn Sie direkt zu einer bestimmten Detailseite verlinken möchten, können Sie eine der folgenden Methoden verwenden:

Methode 1: Eine präzise Suchanfrage mit Ortsname und Adresse verwenden 

https://www.google.com/maps/search/?api=1&query=7-Eleven%2C37%20Swanston%20St%2C%20Melbourne%20Australia

In dieser URL ist der Parameter query als Ortsname, Adresse formatiert. So lässt sich die Suche eingrenzen und direkt zum gewünschten Ort verlinken.

Methode 2: Die Orts-ID verwenden

Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert. 

https://www.google.com/maps/search/?api=1&query=7-Elevan&query_place_id=ChIJGcmcg7ZC1moRAOacd3HoEwM

`ChIJGcmcg7ZC1moRAOacd3HoEwM` ist hier die eindeutige Orts-ID für den jeweiligen Ort. Der query Parameter ist weiterhin erforderlich, wird aber nur verwendet, wenn Google Maps die Orts-ID nicht finden kann.

Szenario 4: Ortsdetails mit Breiten- und Längengradkoordinaten sowie der Orts-ID anzeigen

Mit der Orts-ID wird sichergestellt, dass in Google Maps detaillierte Ortsinformationen angezeigt werden.

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE
Detailseite für einen Ort mit Breiten- und Längengrad sowie Orts-ID
Seite mit Ortsdetails mit Breiten- und Längengrad sowie Orts-ID

Orts-IDs kostenlos abrufen

Wenn Sie Orts-IDs programmatisch abrufen möchten, können Sie die Funktion „Places API: Text Search(ID Only)“ verwenden. Dies ist eine kostenlose Methode zum Abrufen von Orts-IDs. Weitere Informationen zu Orts-IDs und zur Anfrage der Places API(neu)

„Places API: Text Search(ID Only)“-Anfrage: 

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

„Places API: Text Search(ID Only)“-Antwort: 

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

Orts-IDs können auch abgerufen werden, wenn ein Nutzer auf einen POI auf einer Karte klickt oder tippt. Weitere Informationen zu klickbaren POI-Symbolen(JavaScript, Android, iOS)

Schlusswort

Genaue Ortsdetails sind entscheidend für eine positive Nutzererfahrung. Damit Nutzer auf der richtigen Detailseite für Orte landen, erstellen Sie die Such-URLs in einem der folgenden empfohlenen Formate:

  • query=PLACE_NAME, ADDRESS
  • query=PLACE_NAME&query_place_id=PLACE_ID

Verwenden Sie im Parameter query nicht nur Breiten-/Längengradkoordinaten, wenn Sie die Details eines bestimmten Orts anzeigen möchten. Formate wie query=latitude,longitude, query=PLACE_NAME,latitude,longitude oder query=ADDRESS,latitude,longitude führen nicht immer zur gewünschten Seite mit Ortsdetails. Stattdessen werden der Breiten- und Längengrad des Orts angezeigt.

Kategorische Suche mit Maps-URLs

Bei einer kategorischen Suche übergeben Sie einen allgemeinen Suchbegriff und Google Maps versucht, Einträge zu finden, die Ihren Kriterien in der Nähe des von Ihnen angegebenen Orts entsprechen. Wenn kein Ort angegeben ist, versucht Google Maps, Einträge in der Nähe Ihres aktuellen Standorts zu finden.

Szenario 1: Suche nach Orten in der Nähe

https://www.google.com/maps/search/?api=1&query=Cafe%20near%20Sydney%20Opera%20House%20that%20are%20open%20now
Kategorische Suche – Orte in der Nähe
Kategorische Suche – Orte in der Nähe

Wegbeschreibungen mit Maps-URLs bereitstellen

Die Funktion „Wegbeschreibung“ zeigt den Pfad zwischen zwei oder mehr angegebenen Punkten auf der Karte sowie die Entfernung und die Reisezeit an. Entwickler haben damit mehr Kontrolle über die bereitgestellten Wegbeschreibungen. In der Dokumentation zu Wegbeschreibungen mit Maps-URLs der GMP finden Sie detaillierte Anleitungen zum Erstellen von URLs für benutzerdefinierte Wegbeschreibungen.

Die URL-Struktur für die Wegbeschreibung: 

https://www.google.com/maps/dir/?api=1&parameters

Szenario 1: Die beste Route vom aktuellen Standort des Nutzers zu einem Ziel finden

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving

Diese URL öffnet Google Maps und zeigt eine Wegbeschreibung vom aktuellen Standort des Nutzers an.

In dieser URL wird der Parameter origin weggelassen. Wenn origin weggelassen wird, wird standardmäßig der relevanteste Startort verwendet, z. B. der Gerätestandort, falls verfügbar. Andernfalls enthält die resultierende Karte ein Formular, in dem der Nutzer den Startort eingeben kann. Der Wert für Startort und Ziel kann entweder ein Ortsname, eine Adresse oder durch Kommas getrennte Breiten-/Längengradkoordinaten sein.

travelmode ist ein optionaler Parameter. Er definiert die Art der Reise. Dieser Parameter kann so festgelegt werden:

  • Fahren
  • Spazierengehen
  • Fahrrad
  • Motorrad
  • Transit

Wenn kein Reisemodus angegeben ist, zeigt Google Maps einen oder mehrere der relevantesten Modi für die angegebene Route und/oder die Nutzereinstellungen an.

Entwickler können auch Orts-IDs mit den Parametern origin_place_id und destination_place_id angeben. Die Verwendung einer Orts-ID ist die beste Garantie dafür, dass Sie zum richtigen Ort verlinken.

Orts-IDs kostenlos abrufen

Wenn Sie Orts-IDs programmatisch abrufen möchten, können Sie die Funktion „Places API: Text Search(ID Only)“ verwenden. Dies ist eine kostenlose Methode zum Abrufen von Orts-IDs. Weitere Informationen zu Orts-IDs und zur Anfrage der Places API(neu)

„Places API: Text Search(ID Only)“-Anfrage: 

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

„Places API: Text Search(ID Only)“-Antwort: 

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

Orts-IDs können auch abgerufen werden, wenn ein Nutzer auf einen POI auf einer Karte klickt oder tippt. Weitere Informationen zu klickbaren POI-Symbolen(JavaScript, Android, iOS)

Routenbeschreibung ab dem aktuellen Standort des Nutzers
Wegbeschreibung vom aktuellen Standort des Nutzers

Szenario 3: Detaillierte Routenführung bereitstellen

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving&dir_action=navigate

Wenn Sie dir_action=navigate in der URL festlegen, wird Google Maps im Navigationsmodus für die detaillierte Routenführung gestartet, wenn der aktuelle Standort des Nutzers(Gerätestandort) verfügbar ist und als Startort verwendet wird (entweder explizit angegeben oder implizit verwendet, wenn der Parameter „origin“ weggelassen wird). Andernfalls wird eine Routenvorschau angezeigt.

Die detaillierte Routenführung wird gestartet, wenn `dir_action=navigate` festgelegt ist und:

  • Der Startort angegeben ist und sich in der Nähe des aktuellen Standorts des Nutzers befindet.
  • Der Startort weggelassen wird und der aktuelle Standort des Nutzers verfügbar ist.

Die Routenvorschau wird gestartet, wenn:

  • dir_action=navigate nicht festgelegt ist.
  • dir_action=navigate festgelegt ist und der Startort angegeben ist und sich der Startort nicht in der Nähe des aktuellen Standorts des Nutzers befindet.
  • dir_action=navigate festgelegt ist und der Startort weggelassen wird und der aktuelle Standort des Nutzers nicht verfügbar ist.

Die Navigation ist nicht in allen Google Maps-Produkten wie Google Maps im Web und/oder zwischen allen Zielen verfügbar. In diesen Fällen wird dieser Parameter ignoriert.

Detaillierte Routenführung Routenvorschau
Detaillierte Routenführung
Routenvorschau

Schlusswort

Wenn Sie die Maps-URLs richtig erstellen, können Sie dafür sorgen, dass Nutzer schnell und effizient die richtigen Informationen erhalten.

  • Geben Sie immer das Ziel an und verwenden Sie nach Möglichkeit die Orts-ID, um die Genauigkeit zu gewährleisten.

  • Wenn Sie eine sofortige Navigation bereitstellen möchten, fügen Sie den Parameter `dir_action=navigate` ein, um die detaillierte Routenführung auszulösen. Die Navigation beginnt am aktuellen Standort des Nutzers, wenn der Gerätestandort verfügbar ist und als Startort verwendet wird (entweder explizit festgelegt oder weggelassen).

Den richtigen Ansatz für Ihre Anwendung wählen

Sie haben zwei Hauptoptionen: die vorformatierten URLs der Places API verwenden oder Maps-URLs manuell in Ihrer Anwendung erstellen. Jeder Ansatz hat seine eigenen Vor- und Nachteile.

Places API:

  • Die Felder googleMapsUri und googleMapsLinks in der Antwort „Place Details“ enthalten URLs, die sofort verwendet werden können. Das verkürzt die Entwicklungszeit und minimiert das Risiko von Fehlern bei der URL-Formatierung.

  • Weniger Kontrolle über die Konfiguration von Wegbeschreibungen. googleMapsLinks bietet zwar grundlegende Wegbeschreibungen, unterstützt aber keine Wegpunkte oder erweiterte Anpassungen. Außerdem ist es relativ weniger einfach, die detaillierte Routenführung direkt auszulösen.

Maps-URLs:

  • Bieten mehr Flexibilität und Kontrolle. Entwickler können URLs erstellen, um Ortsdetails anzuzeigen und verschiedene Aspekte von Wegbeschreibungen zu konfigurieren, z. B. Wegpunkte hinzufügen, Reisemodi angeben und die detaillierte Routenführung starten.

  • Erfordern ein tieferes Verständnis der URL-Parameter und -Struktur. Bei der manuellen Erstellung steigt das Fehlerrisiko, wenn nicht sorgfältig vorgegangen wird.

Maps-URLs mit UTM-Parametern verbessern

Damit Google besser nachvollziehen kann, wie Entwickler Maps-URLs einbinden, und um eine optimale Leistung zu gewährleisten, empfehlen wir Ihnen, UTM-Tracking-Parameter in Ihre URL-Erstellung aufzunehmen. Wenn Sie die Parameter utm_source und utm_campaign hinzufügen, stellen Sie wertvolle Daten bereit, mit denen wir Nutzungsmuster analysieren und das Produkt „ Maps-URLs“ verbessern können.

Verwenden Sie für den Parameter utm_source den Namen Ihrer Anwendung. Der utm_campaign Parameter sollte die beabsichtigte Aktion des Nutzers widerspiegeln, z. B. „location_sharing“, „place_details_search“ oder „directions_request“.

Eine URL mit UTM-Parametern könnte beispielsweise so aussehen: 

https://www.google.com/maps/search/?api=1&query=Sydney+Opera+House&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE&utm_source=YourAppName&utm_campaign=place_details_search

Wenn Sie diese Parameter konsistent verwenden, können wir Bereiche mit Optimierungsbedarf identifizieren, Probleme effektiver beheben und letztendlich eine bessere Nutzererfahrung für alle Nutzer bieten.

Nächste Schritte

Empfohlene Artikel:

Beitragende

Hauptautoren:

Teresa Qin | Google Maps Platform Solutions Engineer