Richtlinien und Quellenangaben für das Places SDK for iOS

In diesem Dokument sind die Anforderungen für alle mit dem Places SDK for iOS entwickelten Anwendungen aufgeführt, einschließlich des Webservice „Place Autocomplete“, der Teil dieser API ist. Weitere allgemeine Informationen für Google Maps-Entwickler finden Sie in den Nutzungsbedingungen für die Google Maps Platform.

Richtlinien

In diesem Abschnitt werden Richtlinien beschrieben, die für das Places SDK for iOS relevant sind. Die Richtlinien enthalten praktische Implementierungsleitfäden und Anforderungen, die Ihnen helfen, den Dienst korrekt und gemäß den Erwartungen der Google Maps Platform zu nutzen.

Ausnahmen von 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.

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 mit der Google Maps Platform arbeiten, sollten Sie sich die folgenden EWR-spezifischen Nutzungsbedingungen und Informationen ansehen:

Wenn sich Ihre Rechnungsadresse nicht im EWR befindet, gelten die folgenden Nutzungsbedingungen:

Anforderungen an die Quellenangabe in Google Maps

In diesem Abschnitt finden Sie die Anforderungen an die Quellenangabe und die Richtlinien für die Anzeige von Google Maps und Inhalten in Ihren Anwendungen.

Beispiel für Quellenangabe

Im Folgenden finden Sie ein Beispiel für die Quellenangabe im Places UI Kit.

Beispiel für die Quellenangabe im Places UI Kit auf einer Karte, die nicht von Google stammt
Erforderliche Quellenangabe für die kompakte „Place Details“-Komponente. Auf dieser Karte, die nicht von Google stammt, ist die Quellenangabe für Google Maps deutlich sichtbar und die Inhalte der Google Maps Platform sind visuell von anderen Inhalten abgegrenzt.

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-Zuordnung, die bereits von der Google Maps Platform in der Benutzeroberfläche bereitgestellt wird, z. B. im Places UI Kit:

  • Entfernen Sie die 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.

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.

Links: Quellenangabe durch Google Maps-Logo, rechts: Quellenangabe durch Google Maps-Text
Links: Beispiel für die Quellenangabe mit dem Google Maps-Logo, rechts: Beispiel für die Quellenangabe mit Google Maps-Text

Quellenangabe als Logo

Beachten Sie die folgenden Anforderungen für die Verwendung des Google Maps-Logos in Ihrer Anwendung oder auf Ihrer Website.
Zulässige Varianten für die Google Maps-Quellenangabe als Logo
Beispiele für zulässige Varianten für die Google Maps-Quellenangabe als Logo

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 herunterladen

Beachten 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 Umriss 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.

Google Maps-Logo mit Mindestabstand und zulässigem Größenbereich
Beispiel für das Google Maps-Logo mit minimalem Abstand und zulässigem Größenbereich

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.
Nicht zulässige Varianten und Probleme mit der Barrierefreiheit bei der Quellenangabe mit dem Google Maps-Logo
Beispiele für nicht zulässige Varianten und Probleme mit der Barrierefreiheit bei der Quellenangabe mit dem Google Maps-Logo

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:

Zulässige Varianten der Google Maps-Quellenangabe als Text
Beispiele für zulässige Varianten der Google Maps-Quellenangabe als Text
  • Der Text Google Maps darf in keiner Weise geändert werden:
    • Ä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.
Nicht zulässige Varianten der Google Maps-Quellenangabe als Text
Beispiele für nicht zulässige Varianten der Google Maps-Quellenangabe als Text

  • Google Maps-Text wie in der folgenden Tabelle beschrieben formatieren:

    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
    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

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 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. Sie dürfen es niemals entfernen, verbergen, verdecken oder verändern.

Die folgenden Abbildungen zeigen Beispiele für diese visuellen Anforderungen.

Beispiel für die Positionierung der Google Maps-Quellenangabe oben, unten und seitlich des Inhalts
Beispiel für die Zuordnung von Google Maps-Inhalten oben, unten und neben den Inhalten

Beispiel für zwei Ansätze zur Unterscheidung von Google Maps-Inhalten (die Ortsbewertung) von anderen Inhalten
Beispiel für zwei Ansätze zur Unterscheidung von Google Maps-Inhalten (Ortsbewertung) von anderen Inhalten

Die Google Maps-Quellenangabe darf nicht verdeckt oder mit Inhalten aus anderen Quellen vermischt werden.
Die Zuordnung von Google Maps-Inhalten darf nicht verdeckt oder mit Inhalten aus anderen Quellen vermischt werden

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

Quellenangaben für Drittanbieter enthalten Inhalte und Links, die Sie dem Nutzer in dem Format anzeigen müssen, in dem sie bereitgestellt werden. Google empfiehlt, diese Informationen in Ihrer App unter den Ortsdetails anzuzeigen.

Die von der API zurückgegebenen Quellenangaben von Drittanbietern enthalten nicht die Quellenangabe von Google. Sie müssen diese Quellenangabe selbst einfügen, wie unter Google-Logo und Quellenangaben einblenden beschrieben.

Folgen Sie dieser Anleitung, um Drittanbieter-Quellenangaben für einen einzelnen Ort oder eine Sammlung von Orten abzurufen.

Quellenangaben für einen einzelnen Ort abrufen

Wenn Sie einen Ort über die ID abrufen, können Sie die Quellenangaben für diesen Ort über die Property attributions in GMSPlace abrufen.

Die attributions werden als NSAttributedString-Objekt bereitgestellt.

Quellenangaben für eine Sammlung von Orten abrufen

Wenn in Ihrer App Informationen angezeigt werden, die durch Abrufen des aktuellen Orts des Geräts eingeholt wurden, müssen auch Drittanbieter-Quellenangaben für die angezeigten Ortsdetails eingeblendet werden. Sie können die Quellenangaben für alle in der Anfrage abgerufenen Orte über die Eigenschaft attributions in GMSPlaceLikelihoodList abrufen.

Die attributions werden als NSAttributedString-Objekt bereitgestellt, auf das Sie wie oben beschrieben zugreifen und es wie die attributions für einen einzelnen Ort anzeigen können.

Attributionen für Suchergebnisse

In Europa müssen Suchprodukte, die das unverfälschte Ranking von Google verwenden, einen Erläuterungstext enthalten, der maximal einen Klick entfernt ist und die wichtigsten Faktoren sowie die Gewichtung der wichtigsten Faktoren beschreibt, die das Ranking der Suchergebnisse bestimmen. Erklärungstext:

Überschrift: Informationen zu diesen Ergebnissen

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

Button 1: Weitere Informationen
Der Text „Weitere Informationen“ sollte mit einem Hilfeartikel verknüpft sein.

Button 2: OK

Quellenangaben für ein Foto anzeigen

Wenn in Ihrer App Fotos zu sehen sind, müssen Sie für jedes Foto die attributions und authorAttributions anzeigen, falls vorhanden.

Swift

GMSPlacesClient.sharedClient().lookUpPhotosForPlaceID(placeID) { (photos, error) -> Void in
  if let error = error {
    // TODO: handle the error.
    print("Error: \(error.description)")
  } else {
    // Get attribution for the first photo in the list.
    if let photo = photos?.results.first {
      let attributions = photo.attributions
    }
  }
}

Objective-C

[[GMSPlacesClient sharedClient]
    lookUpPhotosForPlaceID:placeID
      callback:^(GMSPlacePhotoMetadataList *_Nullable photos,
                  NSError *_Nullable error) {
        if (error) {
          // TODO: handle the error.
          NSLog(@"Error: %@", [error description]);
        } else {
          // Get attribution for the first photo in the list.
          if (photos.results.count > 0) {
            GMSPlacePhotoMetadata *photo = photos.results.firstObject;
            NSAttributedString *attributions = photo.attributions;
          }
        }
      }];

Rezension anzeigen

Ein GMSPlace-Objekt kann bis zu fünf Rezensionen enthalten, wobei jede einzelne durch ein GMSPlaceReview-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 GMSPlaceReview-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:

Anzeige der Autorenangabe

Google empfiehlt außerdem, dem Endnutzer anzuzeigen, wie Rezensionen sortiert werden.

So greifen Sie auf die Rezensionen zu:

Swift

// Define a Place ID.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let myProperties: [GMSPlaceProperty] = [.name, .website, .reviews]

// Create the GMSFetchPlaceRequest object.
let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties)

client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    let firstReview: GMSPlaceReview = place.reviews![0]

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
})

Objective-C

// Define a Place ID.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return, including reviews.
NSArray<GMSPlaceProperty *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite,GMSPlacePropertyReviews];

GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties];

[placesClient fetchPlaceWithRequest: fetchPlaceRequest, callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) {
  if (error) {
    // TODO: handle the error.
    NSLog(@"Error: %@", [error description]);
  } else {
    // Get first review.
    GMSPlaceReview *firstReview = [place reviews][0];

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
}];

Attributionen von Drittanbietern anzeigen

Quellenangaben für Drittanbieter werden als NSAttributedString-Objekte bereitgestellt, die Inhalte und Links enthalten, die Sie beibehalten und dem Nutzer anzeigen müssen.

Wir empfehlen, die Quellenangaben mit einem UITextView anzuzeigen, da Links in den Quellenangaben funktionieren müssen. Damit Links funktionieren, müssen Sie einen Delegaten für UITextView festlegen und die Methode shouldInteractWithURL von UITextViewDelegate so einrichten, dass YES zurückgegeben wird.

Swift

...
  self.attributionTextView.delegate = self
...

// MARK: - UITextViewDelegate

func textView(textView: UITextView, shouldInteractWithURL URL: NSURL,
  inRange characterRange: NSRange) -> Bool {
  // Make links clickable.
  return true
}

Objective-C

...
  self.attributionTextView.delegate = self;
...

#pragma mark - UITextViewDelegate

- (BOOL)textView:(UITextView *)textView
    shouldInteractWithURL:(NSURL *)url
                  inRange:(NSRange)characterRange {
  // Make links clickable.
  return YES;
}

Beispiel einer Zuordnung für Inhalte Dritter

Eine Drittanbieterzuordnung besteht normalerweise aus Text mit einem Link. Beispiel:

Einträge von Beispielunternehmen

Im obigen Beispiel wird der Textbereich Example Company durch ein NSLink-Attribut abgedeckt.

Automatische Vervollständigung für Adressen von Endnutzern

Wenn ein Endnutzer die automatische Vervollständigung in Ihrer Kundenanwendung verwendet, um eine Adresse einzugeben, und diese Adresse auch ohne die automatische Vervollständigung vollständig und korrekt angegeben worden wäre, unterliegt die vom Endnutzer ausgewählte Adresse 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 Adresse und ausschließlich für die spezifische Transaktion dieses Endnutzers. Sie gilt nicht für die Liste der vorgeschlagenen Adressen, die von der Autovervollständigung bereitgestellt werden, oder für andere Google Maps-Inhalte. Diese Ausnahme gilt nicht für POI- oder Adresssuchfunktionen, die von anderen Google Maps Platform-Diensten angeboten werden.

Automatische Vervollständigung der Adresse des Endnutzers

In der Abbildung oben unterliegt die Adressliste links weiterhin den Einschränkungen für Google Maps-Inhalte. Sobald der Endnutzer die gewünschte Adresse ausgewählt hat, unterliegt diese Adresse nicht mehr den Einschränkungen für Google Maps-Inhalte, die ausschließlich für die entsprechende Transaktion des Endnutzers gelten.