Kurzübersicht zu Maps-URLs

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, Kartenansichten anzusehen, eine Auswahlliste mit Orten zu erstellen oder Street View-Panoramen anzuzeigen. Die URL-Syntax ist auf allen Plattformen gleich und es ist kein API-Schlüssel erforderlich.

Maps-URLs: Wichtige Fakten

  • Produkt: Maps URLs
  • Auch bekannt als: Google Maps-URLs
  • Kategorie: Maps
  • Plattform: URL-Schema
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Maps URLs – Übersicht

Maps-URLs: Wann sollten sie verwendet werden?

Verwenden Sie Maps-URLs in folgenden Fällen:

  • Sie benötigen einen Link aus Ihrer Android-App, iOS-App oder Website, über den Google Maps geöffnet wird, um nach einem Ort zu suchen oder Suchergebnisse anzuzeigen.
  • Sie möchten Google Maps mit einer Wegbeschreibung zwischen zwei Punkten öffnen, optional mit Wegpunkten, Mobilitätsform oder detaillierter Routenführung.
  • Sie müssen Google Maps in einer Kartenansicht, einer Auswahlliste von Orten oder einem Street View-Panorama öffnen, ohne einen API-Schlüssel zu verwenden.
  • Sie benötigen eine URL-Syntax, die in Android-, iOS- und Desktop-Browsern gleich funktioniert.

Verwenden Sie Maps-URLs nicht, wenn:

  • Sie rufen bereits Place Details ab und möchten vorformatierte Google Maps-URLs für einen Ort (Felder googleMapsUri oder googleMapsLinks). Verwenden Sie stattdessen die Places API (New).
  • Wenn Sie beim Starten der Google Maps App nur mobile Funktionen benötigen, verwenden Sie Google Maps-Intents für Android oder das Google Maps-URL-Schema für iOS.

Maps-URLs: Einrichtung

  • Nutzungszuordnung: Fügen Sie den Maps-URLs die optionalen Suchparameter utm_source (Name Ihrer Anwendung) und utm_campaign (beabsichtigte Aktion des Nutzers, z. B. place_details_search) hinzu.
  • Erste Schritte: Maps-URLs einrichten

Maps-URLs: Häufige Fehler

  • Problem: Bei einer Such-URL, die nur den Breiten- und Längengrad in query enthält, wird eine Markierung, aber keine Ortsdetails auf der Karte oder im Seitenbereich angezeigt. Lösung: Verwenden Sie query=PLACE_NAME,ADDRESS oder fügen Sie query_place_id neben query hinzu, um die Details des jeweiligen Orts anzuzeigen. Weitere Informationen finden Sie unter /maps/documentation/urls/get-started.
  • Problem: Die Parameter für die Orts-ID (query_place_id, origin_place_id, destination_place_id, waypoint_place_ids) funktionieren nicht allein. Lösung: Geben Sie immer den passenden Basisparameter (query, origin, destination oder waypoints) an, wenn Sie einen Orts-ID-Parameter übergeben. Weitere Informationen finden Sie unter /maps/documentation/urls/get-started.
  • Problem: Der Parameter waypoints wird in Google Maps-Produkten ignoriert, die keine Wegpunkte unterstützen, und hat plattformabhängige Limits für die Anzahl. dir_action=navigate wird ignoriert, wenn die Navigation nicht verfügbar ist. Lösung: Verwenden Sie für Links, die in mobilen Browsern geöffnet werden, maximal drei Wegpunkte (andernfalls neun) und verlassen Sie sich nicht darauf, dass waypoints oder dir_action=navigate in jedem Google Maps-Produkt oder auf jeder Route funktionieren. Weitere Informationen finden Sie unter /maps/documentation/urls/get-started#directions-action.
  • Problem: Maps und Street View verwenden denselben @-Endpunkt. Daher wird bei einer Karten-URL ohne die richtige Aktion möglicherweise keine Karte angezeigt. Lösung: Legen Sie map_action=map für Kartenansichten und map_action=pano für Street View-Panoramen fest. Weitere Informationen finden Sie unter /maps/documentation/urls/get-started.
  • Problem: Wenn api=1 in einer Maps-URL fehlt, werden alle Parameter ignoriert und Google Maps wird in der Standardansicht geöffnet. Lösung: Fügen Sie api=1 in jede Maps-URL ein (1 ist der einzige gültige Wert). Weitere Informationen finden Sie unter /maps/documentation/urls/get-started#forming-the-url.