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
googleMapsUriodergoogleMapsLinks). 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) undutm_campaign(beabsichtigte Aktion des Nutzers, z. B.place_details_search) hinzu. - Erste Schritte: Maps-URLs einrichten
Maps-URLs: ähnliche Produkte
- Häufig verwendet mit: Places API (New)
Maps-URLs: Häufige Fehler
- Problem: Bei einer Such-URL, die nur den Breiten- und Längengrad in
queryenthält, wird eine Markierung, aber keine Ortsdetails auf der Karte oder im Seitenbereich angezeigt. Lösung: Verwenden Siequery=PLACE_NAME,ADDRESSoder fügen Siequery_place_idnebenqueryhinzu, 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,destinationoderwaypoints) an, wenn Sie einen Orts-ID-Parameter übergeben. Weitere Informationen finden Sie unter /maps/documentation/urls/get-started. - Problem: Der Parameter
waypointswird in Google Maps-Produkten ignoriert, die keine Wegpunkte unterstützen, und hat plattformabhängige Limits für die Anzahl.dir_action=navigatewird 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, dasswaypointsoderdir_action=navigatein 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 Siemap_action=mapfür Kartenansichten undmap_action=panofür Street View-Panoramen fest. Weitere Informationen finden Sie unter /maps/documentation/urls/get-started. - Problem: Wenn
api=1in einer Maps-URL fehlt, werden alle Parameter ignoriert und Google Maps wird in der Standardansicht geöffnet. Lösung: Fügen Sieapi=1in jede Maps-URL ein (1ist der einzige gültige Wert). Weitere Informationen finden Sie unter /maps/documentation/urls/get-started#forming-the-url.