Richtlinien und Quellenangaben für die Maps JavaScript API

In diesem Dokument sind die Anforderungen für Anwendungen aufgeführt, die mit der Maps JavaScript API entwickelt wurden. Die Nutzung der Maps JavaScript API unterliegt Ihrer Vereinbarung mit Google.

Richtlinien

In diesem Abschnitt werden Richtlinien beschrieben, die für die Maps JavaScript API relevant sind. Richtlinien enthalten praktische Implementierungsrichtlinien und Anforderungen, die Ihnen helfen, den Dienst korrekt und gemäß den Erwartungen der Google Maps Platform zu nutzen.

Ausnahmen von den Caching-Einschränkungen

Die Orts-ID, die zur eindeutigen Identifizierung eines Orts verwendet wird, ist von der Caching-Einschränkung ausgenommen. Daher können Sie Orts-ID-Werte unbegrenzt speichern. Die Orts-ID wird im Feld place_id in API-Antworten zurückgegeben. Informationen zum Speichern, Aktualisieren und Verwalten von Orts-IDs finden Sie in diesem Leitfaden.

Content-Scraping

Der Ortsname kann Ihnen basierend auf Nutzerinteraktionen mit Ihrer App zurückgegeben werden. Wenn Sie den Ortsnamen für die Verwendung in einem anderen Kontext außerhalb der Nutzersitzung erfassen oder speichern, stellt dies Scraping dar, was gemäß unseren Nutzungsbedingungen nicht zulässig ist.

Länder und Gebiete im Europäischen Wirtschaftsraum

Für dieses Produkt gelten für Kunden mit einer Rechnungsadresse im Europäischen Wirtschaftsraum (EWR) andere Nutzungsbedingungen. Außerdem kann die Funktionalität abweichen. Bevor Sie mit der Google Maps Platform entwickeln, 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 zum EWR
• Anforderungen an die Verkehrssicherheit für die Google Maps Platform

Wenn sich Ihre Rechnungsadresse nicht im EWR befindet, gelten für Sie die folgenden Nutzungsbedingungen:

• Nutzungsbedingungen für die Google Maps Platform
• Dienstspezifische Nutzungsbedingungen für die Google Maps Platform

Anforderungen an die Quellenangabe für Google Maps

In diesem Abschnitt finden Sie Anforderungen und Richtlinien für die Quellenangabe, wenn Sie Google Maps und Inhalte über Ihre Anwendungen präsentieren.

Beispiel für eine Quellenangabe

Im Folgenden finden Sie ein Beispiel für eine Quellenangabe für das Places UI Kit.

Quellenangabe für Google Maps 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 Google Maps-Quellenangaben, die bereits von der Google Maps Platform in der Benutzeroberfläche bereitgestellt werden, z. B. im Places UI Kit, gilt Folgendes:

• Entfernen Sie die vorhandene Quellenangabe nicht, unabhängig davon, wo sie angezeigt wird. Ändern, verbergen, oder verdecken Sie die Quellenangabe nicht und sorgen Sie dafür, dass sie sich deutlich vom Hintergrund abhebt.
• 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. Wenn der Platz begrenzt ist, ist der Text Google Maps zulässig. Endnutzer müssen immer klar erkennen können, welche Inhalte von Google Maps bereitgestellt werden.

Quellenangabe als Logo

Google Maps-Logos herunterladen

Verwenden Sie die offiziellen Google Maps-Logodateien. Laden Sie die Logos unten herunter und folgen Sie den Richtlinien in diesem Abschnitt.

Wenn Sie das Google Maps-Logo verwenden, beachten Sie die folgenden Richtlinien.

• Ändern Sie das Logo nicht.
• Behalten Sie das Seitenverhältnis des Logos bei, um Verzerrungen zu vermeiden.
• Verwenden Sie das umrandete Logo auf einem unruhigen Hintergrund, z. B. einer Karte oder einem Bild.
• Verwenden Sie das nicht umrandete Logo auf einem einfarbigen Hintergrund, z. B. einer Vollfarbe oder einem dezenten Farbverlauf.

Spezifikation der Logogröße

• Mindesthöhe des Logos:16 dp
• Maximale Höhe des Logos:19 dp
• Mindestabstand des Logos:10 dp links, rechts und oben, 5 dp unten

Informationen zu dp finden Sie auf der Material Design-Website unter Pixel density.

Barrierefreiheit für Logos

• Achten Sie auf einen barrierefreien Kontrast zwischen dem Logo und dem Hintergrund.
• Fügen Sie ein Label für die Barrierefreiheit mit dem Text Google Maps ein.

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 angeben. Beachten Sie die folgenden Richtlinien:

• Ändern Sie den Text Google Maps nicht:
  
  • Ändern Sie die Groß- und Kleinschreibung von Google Maps nicht.
  • Fügen Sie keinen Zeilenumbruch in Google Maps ein.
  • Übersetzen 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 den Text „Google Maps“ wie in der folgenden Tabelle beschrieben:

  Anforderungen an die Formatierung des Texts „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 Standardschriftart des Systems 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 Informationen zu sp finden Sie 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

• 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 es mit Inhalten auszeichnen, die nicht von der Google Maps Platform stammen.
• Achten Sie darauf, dass die Quellenangabe immer sichtbar und lesbar ist. Entfernen, verbergen, verdecken oder ändern Sie sie niemals.

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.

Andere Anforderungen bezüglich Quellenangaben

Befolgen Sie diese Anweisungen, um Drittanbieter-Quellenangaben abzurufen und die Quellenangabe in Ihrer App anzuzeigen.

Quellenangaben von einem Ort abrufen

Wenn in Ihrer App Informationen angezeigt werden, die durch Aufrufen von Place.fetchFields eingeholt wurden, müssen auch Drittanbieter-Quellenangaben für die angerufenen Ortsdaten eingeblendet werden.

Die API gibt ein Place-Objekt zurück. Verwenden Sie zum Abrufen von Quellenangaben aus dem Place-Objekt die Place.attributions-Eigenschaft, die mit jeder Anfrage zurückgegeben wird (sie muss nicht mithilfe von Feldern angegeben werden). Die Eigenschaft gibt ein List von String-Objekten zurück oder null, wenn es keine anzuzeigenden Quellenangaben gibt. Das folgende Beispiel veranschaulicht, wie Informationen zu einem Ort abgerufen und Quellenangaben aufgelistet werden.

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen
  });

  // Call fetchFields, passing the desired data fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // Check for any place attributions.
  if (!place.attributions) {
      console.log('No attributions were found.');
      return;
  } else {
      // Log the place attribution
      for (var attribution of place.attributions) {
          console.log(attribution);
      }
  }

  

Rezension anzeigen

Ein Place-Objekt kann bis zu fünf Rezensionen enthalten, wobei jede einzelne durch ein Review-Objekt dargestellt wird. Sie können diese Rezensionen optional in Ihrer App anzeigen.

Wenn Sie Rezensionen von Google-Nutzern anzeigen, müssen Sie den Namen des Autors in unmittelbarer Nähe platzieren. Wir empfehlen, im Feld für die Autorenangabe des Review-Objekts auch das Foto des Autors und einen Link zu seinem Profil anzugeben, falls verfügbar. Im folgenden Bild ist eine Beispielrezension für einen Park zu sehen:

Das folgende Beispiel veranschaulicht, wie Informationen zu einem Ort abgerufen, die Rezensionen geprüft und die Daten aus der ersten Rezension dargestellt werden:

// Create a new Place instance.
const place = new Place({
    id: 'ChIJpyiwa4Zw44kRBQSGWKv4wgA', // Faneuil Hall Marketplace, Boston, MA
});

// Call fetchFields, passing 'reviews' and other needed fields.
await place.fetchFields({
    fields: ['displayName', 'formattedAddress', 'location', 'reviews'],
});

// Create an HTML container.
const content = document.createElement('div');
const title = document.createElement('div');
const rating = document.createElement('div');
const address = document.createElement('div');
const review = document.createElement('div');
const authorLink = document.createElement('a');

// If there are any reviews display the first one.
if (place.reviews && place.reviews.length > 0) {
    // Get info for the first review.
    const reviewRating = place.reviews[0].rating;
    const reviewText = place.reviews[0].text;
    const authorName = place.reviews[0].authorAttribution.displayName;
    const authorUri = place.reviews[0].authorAttribution.uri;

    // Safely populate the HTML.
    title.textContent = place.displayName || '';
    address.textContent = place.formattedAddress || '';
    rating.textContent = `Rating: ${reviewRating} stars`;
    review.textContent = reviewText || '';
    authorLink.textContent = authorName;
    authorLink.href = authorUri || '';
    authorLink.target = '_blank';

    content.appendChild(title);
    content.appendChild(address);
    content.appendChild(rating);
    content.appendChild(review);
    content.appendChild(authorLink);
} else {
    content.textContent = `No reviews were found for ${place.displayName}.`;
}

// Create an infoWindow to display the review.
infoWindow = new InfoWindow({
    content,
    ariaLabel: place.displayName,
});
index.js

Weitere Informationen finden Sie in der Dokumentation zu Ortsrezensionen.

Quellenangaben für ein Foto anzeigen

Wenn in Ihrer App Fotos zu sehen sind, müssen Sie für jedes Foto die Autorenangabe anzeigen, falls vorhanden. Details zum Foto in einem Place-Objekt einer Antwort sind im photos-Array enthalten. Um das photos-Array der Antwort hinzufügen, fügen Sie das photos-Datenfeld in die Anfrage ein.

Jedes Element des Foto-Arrays ist eine Instanz von Photo, das das authorAttributions-Array vom Typ „AuthorAttribution“ enthält. Die Felder des AuthorAttribution Objekts sind Strings, die displayName, uri und photoUri der Quellenangaben enthalten, oder einen leeren String, wenn es keine anzuzeigende Quellenangabe gibt.

Weitere Informationen finden Sie in der Dokumentation zu Ortsfotos.

Quellenangaben für Suchergebnisse

In Europa muss bei der Verwendung des unveränderten Rankings von Google in Suchprodukten ein Erklärungstext mit maximal einem Klick erreichbar sein, in dem die wichtigsten Faktoren und die Gewichtung der wichtigsten Faktoren beschrieben werden, die das Ranking der Suchergebnisse bestimmen. Erklärungstext:

Überschrift: Informationen zu diesen Ergebnissen

Text: Wenn Sie nach Unternehmen oder Orten in der Nähe eines Standorts suchen, werden auf Google Maps lokale Suchergebnisse angezeigt. Damit Ihre Suche zu den bestmöglichen Ergebnissen führt, werden verschiedene Faktoren kombiniert. Die wichtigsten sind Relevanz, Entfernung und Bekanntheit.

Schaltfläche 1: Weitere Informationen
Der Text „Weitere Informationen“ sollte auf einen Hilfeartikel verlinken.

Schaltfläche 2: OK

Automatische Vervollständigung für Adressen von Endnutzern

Wenn ein Endnutzer die Funktion zur automatischen Vervollständigung in Ihrer Kundenanwendung verwendet, um eine Straße einzugeben und diese Straße ohne die automatische Vervollständigung vollständig und korrekt von diesem Endnutzer angegeben worden wäre, unterliegt die ausgewählte Adresse des Endnutzers dann nicht den Inhaltsbeschränkungen für Google Maps-Inhalte in Ihrer Google Maps Platform-Vereinbarung. Diese Ausnahme gilt nur für die vom Endnutzer ausgewählte Straße und nur für die spezifische Transaktion dieses Endnutzers. Sie gilt nicht für die Liste der vorgeschlagenen Adressen, die von der Funktion zur automatischen Vervollständigung bereitgestellt werden, oder für andere Google Maps-Inhalte. Diese Ausnahme gilt nicht für Funktionen zur Suche nach POIs oder Adressen, die von anderen Google Maps Platform -Diensten angeboten werden.

Im vorherigen Bild unterliegt die Adressliste auf der linken Seite weiterhin den Einschränkungen für Google Maps-Inhalte. Sobald der Endnutzer die gewünschte Adresse ausgewählt hat, unterliegt diese Adresse nur für die entsprechende Transaktion des Endnutzers nicht den Einschränkungen für Google Maps-Inhalte.

KI-basierte Zusammenfassungen

Wenn Sie KI-basierte Zusammenfassungen in Ihrer App anzeigen, einschließlich Orts-, Gebiets- und Rezensionszusammenfassungen, müssen Sie Folgendes tun:

• Zeigen Sie die erforderlichen Quellenangaben, Links zum Melden und Referenzlinks wie definiert an.
• Endnutzer müssen den vollständigen Zusammenfassungstext lesen können, so wie er von Google Maps bereitgestellt wird.

Offenlegungstext für KI-basierte Zusammenfassungen anzeigen

Wenn Sie eine KI-basierte Zusammenfassung jeglicher Art anzeigen, fügen Sie immer den lokalisierten Offenlegungstext (im Feld disclosureText des Antworttexts) direkt unter der Zusammenfassung ein. Ändern oder ergänzen Sie den von der API bereitgestellten Offenlegungstext niemals.

Zusätzliche Anforderungen für Orts- und Gebietszusammenfassungen

Orts und Gebiets zusammenfassungen, die in Ihrer App angezeigt werden, müssen den folgenden Text und die folgenden erforderlichen Links enthalten:

Anforderungen an Rezensionszusammenfassungen

Rezensionszusammenfassungen , die in Ihrer App angezeigt werden, müssen eine Überschrift mit dem Text „Rezension szusammenfassung“ enthalten. Außerdem müssen Sie den folgenden Text und die folgenden erforderlichen Links verwenden:

Anleitung zur Anzeige für Anwendungsfälle im Automobilbereich

Aus Gründen der Fahrersicherheit empfiehlt Google, KI-basierte Zusammenfassungen im geparkten Modus für Anwendungsfälle im Automobilbereich zu rendern. Wenn Zusammenfassungen im Fahrmodus gerendert werden, sollten die Informationen auf dem Bildschirm einfach, klar und prägnant sein, damit der Fahrer seine Aufmerksamkeit schnell wieder auf die Straße richten kann:

• Maximal 3 Zeilen
• Maximal 120 Zeichen oder 24 Wörter
• Mindestschriftgröße von 24 dp

Insbesondere im Automobilbereich ist der Entwickler dafür verantwortlich, KI-basierte Zusammenfassungen so zu rendern, dass sie sicher sind und allen lokalen Gesetzen und Bestimmungen entsprechen.