In diesem Dokument sind die Anforderungen für Anwendungen aufgeführt, die mit der Geocoding API entwickelt werden. Die Nutzung der Geocoding API unterliegt Ihrer Vereinbarung mit Google.
Richtlinien
In diesem Abschnitt werden die Richtlinien für die Geocoding API beschrieben. Die Richtlinien enthalten praktische Implementierungsleitfäden und Anforderungen, die Ihnen helfen, den Dienst korrekt und gemäß den Erwartungen der Google Maps Platform zu nutzen.
Datenspeicherung, Caching und Scraping
Wenn Sie Google Maps-Inhalte in Ihrer Anwendung verwenden, müssen Sie die Anforderungen zur Datenverarbeitung in Abschnitt 3.2.3 der Nutzungsbedingungen für die Google Maps Platform und die dienstspezifischen Nutzungsbedingungen für die Google Maps Platform einhalten:
- Einschränkungen für Caching und Scraping (Abschnitt 3.2.3(a) und (b)): Google Maps-Inhalte dürfen nur im Cache oder anderweitig gespeichert werden, wenn dies in den dienstspezifischen Nutzungsbedingungen für die Google Maps Platform ausdrücklich erlaubt ist. Sie dürfen Google Maps-Inhalte nicht exportieren, extrahieren oder scrapen, um sie außerhalb der Dienste zu nutzen. Beispielsweise dürfen Sie Google Maps-Inhalte nicht außerhalb der Dienste vorab abrufen, indexieren, speichern oder weitergeben. Sie dürfen keine Kartenelemente, Street View-Bilder, Geocodes, Wegbeschreibungen, Distanzmatrixergebnisse, Straßeninformationen, Ortsinformationen, Höhenwerte oder Zeitzonendetails im Bulk herunterladen und keine Unternehmensnamen, Adressen oder Nutzerrezensionen kopieren und speichern.
- Inhaltsbeschränkungen für abgeleitete Inhalte (Abschnitt 3.2.3(c)): Google Maps-Inhalte dürfen in Ihrer Anwendung nur gemäß den Nutzungsbedingungen für die Google Maps Platform verwendet werden. Erstellen Sie keine Inhalte auf Grundlage von Google Maps-Inhalten. Sie dürfen beispielsweise keine Elemente aus Satellitenbildern nachzeichnen oder digitalisieren, keine 3D- oder Geländemodelle erstellen, keine Breiten- und Längengradwerte von Orten als Eingabe für Punkt-in-Polygon-Analysen verwenden, keinen Standortindex aus Street View-Bildern erstellen und keine textbasierten Fahrzeiten in synthetische Sprache umwandeln.
Wenn Sie die Latenz und die in Rechnung gestellten Kosten reduzieren möchten, ohne eingeschränkte Daten im Cache zu speichern, können Sie Feldmasken oder Feldlisten verwenden, um nur die Felder anzufordern, die für Ihre Benutzeroberfläche erforderlich sind. Speichern Sie ausgenommene Kennungen wie die Orts-ID, um aktuelle Details abzurufen, wenn ein Nutzer mit einem Ort interagiert.
Die technischen Support-Entwickler von Google können keine Rechtsberatung anbieten oder Ausnahmen von den Nutzungsbedingungen der Google Maps Platform gewähren. Wenden Sie sich an Ihren Rechtsbeistand, um festzustellen, ob Ihre Implementierung den Nutzungsbedingungen entspricht, oder kontaktieren Sie den Vertrieb, wenn Ihr Anwendungsfall eine benutzerdefinierte Lizenzierung erfordert.
Ausnahmen von Caching-Einschränkungen
In den dienstspezifischen Nutzungsbedingungen für die Google Maps Platform sind die folgenden eingeschränkten Ausnahmen für das Caching aufgeführt:
- Orts-IDs: Die Orts-ID, die zur eindeutigen Identifizierung eines Orts verwendet wird, ist von der Caching-Einschränkung ausgenommen.
Sie können die entsprechenden Werte also unbegrenzt speichern. Orts-IDs werden in API-Antworten im Feld
idoderplace_idzurückgegeben. Informationen zum Speichern, Aktualisieren und Verwalten von Orts-IDs finden Sie in diesem Leitfaden. - Breiten- und Längengradkoordinaten: Sie können Werte für den Breitengrad (
latitude) und den Längengrad (longitude) vorübergehend für bis zu 30 aufeinanderfolgende Kalendertage im Cache speichern. Danach müssen Sie die im Cache gespeicherten Koordinaten löschen, wenn Sie Dienste verwenden, die diese Ausnahme in den dienstspezifischen Nutzungsbedingungen für die Google Maps Platform gewähren:- Routes API, Route Optimization API, Directions API (Legacy) und Roads API
- Geocoding API, Geolocation API und Address Validation API
- Places API, Places UI Kit und Navigation SDK
- Dienstspezifische Caching-Zeiträume: In den dienstspezifischen Nutzungsbedingungen der Google Maps Platform sind auch feldspezifische Caching-Zeiträume und zulässige Zwecke für die Address Validation API, die Air Quality API, die Pollen API, die Solar API, die Weather API und die Places Aggregate API definiert.
Clientseitiges Filtern und Neusortieren
Sie können die Ergebnisse auf oberster Ebene clientseitig filtern, z. B. Adressergebnisse entfernen, die nicht bestimmten Kriterien für Land oder Postleitzahl entsprechen. Du kannst auch Unterlisten innerhalb eines einzelnen Ergebnisses filtern oder neu anordnen, z. B. bestimmte Navigationspunkte priorisieren, solange die Filter- oder Neuanordnungskriterien für Endnutzer nicht irreführend sind. Sie müssen dafür sorgen, dass die von der API zurückgegebenen Originaldaten durch diese Änderungen nicht falsch dargestellt werden.
Länder und Gebiete im Europäischen Wirtschaftsraum
Für dieses Produkt gelten andere Nutzungsbedingungen für Kunden mit einer Rechnungsadresse im Europäischen Wirtschaftsraum (EWR). Außerdem kann es andere Funktionen haben. Bevor Sie die Google Maps Platform verwenden, sollten Sie die folgenden EWR-spezifischen Nutzungsbedingungen und Informationen lesen:
- Nutzungsbedingungen für die Google Maps Platform im EWR
- Dienstspezifische Nutzungsbedingungen für die Google Maps Platform im EWR
- Häufig gestellte Fragen (FAQs) zum EWR
- Anforderungen an die Verkehrssicherheit für die Google Maps Platform
Wenn sich Ihre Rechnungsadresse nicht im EWR befindet, gelten die folgenden Nutzungsbedingungen für Sie:
- Nutzungsbedingungen für die Google Maps Platform
- Dienstspezifische Nutzungsbedingungen für die Google Maps Platform
Anforderungen an die Quellenangabe in Google Maps
In diesem Abschnitt finden Sie Anforderungen an die Quellenangabe und Richtlinien für die Anzeige von Google Maps und Inhalten in Ihren Anwendungen.
Google Maps-Quellenangabe anzeigen
Wenn Sie Inhalte aus Google Maps Platform APIs in Ihrer Anwendung oder auf Ihrer Website präsentieren, müssen Sie die Anforderungen an die Quellenangabe für Google Maps einhalten. Wenn die Inhalte auf einer Google-Karte angezeigt werden, auf der die Quellenangabe bereits sichtbar ist, müssen Sie keine zusätzliche Quellenangabe hinzufügen.
Vorhandene Google Maps-Quellenangabe
Für die Google Maps-Quellenangabe, die bereits von der Google Maps Platform in der Benutzeroberfläche bereitgestellt wird, z. B. im Places UI Kit:
- Entfernen Sie die enthaltene Quellenangabe nicht, unabhängig davon, wo sie angezeigt wird. Die Quellenangabe darf nicht verändert, ausgeblendet oder verdeckt werden und muss sich deutlich vom Hintergrund abheben.
- Google Maps Platform-Inhalte müssen immer durch UI-Elemente wie Rahmen, Hintergrundfarbe, Schatten oder ausreichend Leerraum visuell von anderen Inhalten abgegrenzt werden.
- Wenn Sie visuelle Änderungen vornehmen, müssen Sie alle Anforderungen an die Quellenangabe für Google Maps einhalten.
Quellenangabe durch Google Maps-Logo oder Text
Die Quellenangabe sollte nach Möglichkeit in Form des Google Maps-Logos erfolgen. Bei Platzmangel ist der Text Google Maps zulässig. Für Endnutzer muss immer klar erkennbar sein, welche Inhalte von Google Maps stammen.
Quellenangabe als Logo
Beachten Sie die folgenden Anforderungen für die Verwendung des Google Maps-Logos in Ihrer Anwendung oder auf Ihrer Website.Google Maps-Logos herunterladen
Verwenden Sie die offiziellen Google Maps-Logodateien. Laden Sie die Logos unten herunter und beachten Sie die Richtlinien in diesem Abschnitt.
Assets für Google Maps-Quellenangaben herunterladenBeachten Sie bei der Verwendung des Google Maps-Logos die folgenden Richtlinien.
- Das Logo darf in keiner Weise verändert werden.
- Behalten Sie das Seitenverhältnis des Logos bei, um Verzerrungen zu vermeiden.
- Verwenden Sie das Logo mit Rahmen auf einem unruhigen Hintergrund, z. B. einer Karte oder einem Bild.
- Verwenden Sie das Logo ohne Umrandung auf einem einfachen Hintergrund, z. B. einer einfarbigen Fläche oder einem dezenten Farbverlauf.
Vorgaben für die Logogröße
Beachten Sie die folgenden Größenangaben für das Google Maps-Logo:- Mindesthöhe des Logos: 16 dp
- Maximale Logohöhe: 19 dp
- Mindestabstand des Logos: 10 dp links, rechts und oben, 5 dp unten
Weitere Informationen zu dp finden Sie auf der Material Design-Website unter Pixeldichte.
Barrierefreiheit für Logos
Folgende Anforderungen an die Barrierefreiheit gelten für das Google Maps-Logo:- Achten Sie auf einen barrierefreien Kontrast zwischen dem Logo und dem Hintergrund.
- Fügen Sie ein Label für Bedienungshilfen mit dem Text Google Maps hinzu.
Quellenangabe als Text
Wenn die Größe Ihrer Benutzeroberfläche die Verwendung des Google Maps-Logos nicht zulässt, können Sie Google Maps als Text ausschreiben. Befolgen Sie diese Richtlinien:
- Ändern Sie den Text Google Maps in keiner Weise:
- Ändern Sie die Groß-/Kleinschreibung von Google Maps nicht.
- Fügen Sie keinen Zeilenumbruch in Google Maps ein.
- Lokalisieren Sie Google Maps nicht in eine andere Sprache.
- Verhindern Sie, dass Browser Google Maps übersetzen, indem Sie das HTML-Attribut
translate="no"verwenden.
Formatieren Sie Google Maps-Text wie in der folgenden Tabelle beschrieben:
Anforderungen an die Textformatierung in Google Maps Eigenschaft Stil Schriftfamilie Roboto. Das Laden der Schriftart ist optional. Fallback-Schriftfamilie Eine beliebige serifenlose Schriftart, die bereits in Ihrem Produkt verwendet wird, oder „Sans-Serif“, um die Standardsystemschriftart aufzurufen Schriftstil Normal Schriftstärke 400 Schriftfarbe Weiß, Schwarz (#1F1F1F) oder Grau (#5E5E5E). Achten Sie auf einen barrierefreien Kontrast von 4,5:1 zum Hintergrund. Schriftgröße Mindestschriftgröße: 12 sp
Maximale Schriftgröße: 16 sp
Weitere Informationen zu „sp“ findest du auf der Material Design-Website unter Font size units.Zeichenabstand Normal
Beispiel-CSS
Mit dem folgenden CSS wird Google Maps mit dem entsprechenden typografischen Stil und der entsprechenden Farbe auf einem weißen oder hellen Hintergrund dargestellt.
@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap'); .GMP-attribution { font-family: Roboto, Sans-Serif; font-style: normal; font-weight: 400; font-size: 1rem; letter-spacing: normal; white-space: nowrap; color: #5e5e5e; }
Visuelle Anforderungen
Beachten Sie die folgenden Anforderungen für die visuelle Darstellung der Google Maps-Quellenangabe.Die Quellenangabe muss sich in der Nähe des oberen oder unteren Rands des Inhalts und im selben visuellen Element befinden. Bei einer einzelnen Zeile kann die Quellenangabe rechts oder links positioniert werden.
Google Maps Platform-Inhalte müssen immer durch UI-Elemente wie Rahmen, Hintergrundfarbe, Schatten oder ausreichend Leerraum visuell von anderen Inhalten abgegrenzt werden.
- Stellen Sie Google Maps nicht falsch dar, indem Sie Inhalte, die nicht von der Google Maps Platform stammen, Google Maps zuordnen.
- Achten Sie darauf, dass die Quellenangabe immer sichtbar und lesbar ist. Entfernen, verbergen, verdecken oder verändern Sie es nicht.
Die folgenden Abbildungen zeigen Beispiele für diese visuellen Anforderungen.
Drittanbieter von Daten
Einige der Daten und Bilder in unseren Kartierungsprodukten stammen von anderen Anbietern als Google. Bei einigen Produkten, z. B. der Map Tiles API, stellen wir Ihnen möglicherweise die erforderliche Quellenangabe für den Drittanbieter von Daten zur Verfügung. Wenn wir das tun, muss der Text Ihrer Quellenangabe den Namen „Google Maps“ sowie alle relevanten Datenanbieter enthalten, beispielsweise „Kartendaten: Google, Maxar Technologies“. Stellt Google Quellenangaben von Drittanbietern bereit, ist die Quellenangabe nicht korrekt, wenn nur „Google Maps“ oder das Google-Logo angegeben ist.
KI-basierte Zusammenfassungen (Reiseziele)
Wenn Sie KI-basierte Zusammenfassungen, die von der Methode SearchDestinations zurückgegeben werden, in Ihrer App anzeigen, müssen Sie Folgendes tun:
- Zeigen Sie die erforderlichen Quellenangaben, Links für die Berichterstellung und verweisenden Links an, wie in diesem Abschnitt definiert.
- Sorgen Sie dafür, dass Endnutzer den vollständigen Zusammenfassungstext lesen können, wie er von der Google Maps Platform bereitgestellt wird.
Offenlegungstext für KI-basierte Zusammenfassungen anzeigen
Wenn Sie eine KI-basierte Zusammenfassung anzeigen, fügen Sie immer den lokalisierten Offenlegungstext aus dem Antwortfeld disclosureText direkt unter der Zusammenfassung ein. Du darfst den von der API bereitgestellten Offenlegungstext unter keinen Umständen ändern oder ergänzen.
Anforderungen an die Ankunftszusammenfassung
Ankunftszusammenfassungen, die in Ihrer App angezeigt werden, müssen den folgenden Text und die erforderlichen Links enthalten:
| Text | Anforderung |
|---|---|
| Informationen zu dieser Zusammenfassung | Verwenden Sie den folgenden Link zu „So bezieht und verwendet Google Informationen aus lokalen Einträgen“: https://support.google.com/local-listings/answer/9851099. |
| Zusammenfassung melden |
Verwenden Sie den Link im Feld Hinweis: KI-basierte Zusammenfassungen, die über die Geocoding API bereitgestellt werden, unterliegen weltweit den Inhalts- und Produktrichtlinien von Google. Sie müssen Ihre Endnutzer darüber informieren, dass sie Inhalte, die gemäß anwendbarem Recht aus den Google-Diensten entfernt werden sollten, über die angegebene URL zum Melden von Inhalten ( |
Anzeigehinweise für Automotive-Anwendungsfälle
Aus Sicherheitsgründen empfiehlt Google, KI-basierte Zusammenfassungen für Automotive-Anwendungen nur im Parkmodus zu rendern. Wenn Zusammenfassungen im Fahrmodus gerendert werden, sollten die Informationen auf dem Bildschirm klar und prägnant sein, damit sich der Fahrer schnell wieder auf die Straße konzentrieren kann:
- Maximal 3 Zeilen
- Maximal 120 Zeichen oder 24 Wörter
- Schriftgröße von mindestens 24 dp
Insbesondere im Automobilbereich liegt es in der Verantwortung des Entwicklers, KI-basierte Zusammenfassungen so darzustellen, dass sie sicher sind und allen lokalen Gesetzen und Bestimmungen entsprechen.