Richtlinien für Places SDK for iOS

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

Bereitstellen der Nutzungsbedingungen und der Datenschutzerklärung

Wenn Sie eine Places SDK for iOS-App entwickeln, müssen Sie die Nutzungsbedingungen und eine Datenschutzerklärung zusammen mit Ihrer App zur Verfügung stellen. Diese muss den Richtlinien Ihrer Vereinbarung mit Google entsprechen:

• Die Nutzungsbedingungen und die Datenschutzerklärung müssen öffentlich verfügbar sein.
• In Ihren Nutzungsbedingungen müssen Sie explizit angeben, dass die Nutzer Ihrer Anwendung an die Nutzungsbedingungen von Google gebunden sind.
• In Ihrer Datenschutzrichtlinie müssen Sie die Nutzer darauf hinweisen, dass Sie die Google Maps API(s) verwenden und dass die Datenschutzerklärung von Google gilt.

Die empfohlene Platzierung Ihrer Nutzungsbedingungen und Datenschutzerklärung hängt von der Plattform Ihrer Anwendung ab.

Apps

Wenn Sie eine mobile App entwickeln, sollten Sie einen Link zu den Nutzungsbedingungen und zur Datenschutzerklärung auf der Downloadseite Ihrer App im entsprechenden App Store und in einem Einstellungsmenü der App bereitstellen.

Webanwendungen

Wenn Sie eine Webanwendung entwickeln, sollten Sie einen Link zu den Nutzungsbedingungen und zur Datenschutzerklärung in der Fußzeile Ihrer Website einfügen.

Inhalte vorab abrufen, zwischenspeichern oder speichern

Apps, die das Places SDK for iOS verwenden, sind an die Bedingungen Ihrer Vereinbarung mit Google gebunden. Vorbehaltlich der Bedingungen Ihrer Vereinbarung dürfen Sie keine Inhalte vorab abrufen, indizieren, speichern oder zwischenspeichern, es sei denn, dies geschieht unter bestimmten Voraussetzungen, die in den Nutzungsbedingungen aufgeführt sind.

Die Orts-ID, die zur eindeutigen Identifizierung eines Orts verwendet wird, ist von der Caching-Einschränkung ausgenommen. Die Orts-ID wird im Feld „place_id“ in den Antworten des Places SDK for iOS zurückgegeben. Informationen zum Speichern, Aktualisieren und Verwalten von Orts-IDs finden Sie in diesem Leitfaden.

Places SDK for iOS-Ergebnisse anzeigen

Ergebnisse des Places SDK for iOS können auf einer Google-Karte oder ohne Karte angezeigt werden. Wenn Sie Places SDK for iOS-Ergebnisse auf einer Karte anzeigen lassen möchten, müssen sie auf einer Google-Karte angezeigt werden. Es ist nicht zulässig, Daten des Places SDK for iOS auf einer Karte zu verwenden, die keine Google Maps-Karte ist.

Logos und Quellenangaben einblenden

Wenn in Ihrer Anwendung Daten auf einer Google-Karte angezeigt werden, wird das Google-Logo eingefügt und darf nicht verändert werden. In Anwendungen, in denen Google-Daten auf demselben Bildschirm wie eine Google-Karte erscheinen, ist keine weitere Quellenangabe zu Google erforderlich.

Falls in Ihrer Anwendung Daten auf einer Seite oder Ansicht dargestellt werden, auf der nicht ebenfalls eine Google-Karte zu sehen ist, müssen Sie auch ein Google-Logo mit diesen Daten einblenden. Wenn in Ihrer Anwendung beispielsweise Google-Daten auf einem Tab und eine Google-Karte mit diesen Daten auf einem anderen Tab angezeigt werden, muss der erste Tab das Google-Logo enthalten. Werden in Ihrer Anwendung Suchfelder mit oder ohne automatische Vervollständigung verwendet, muss das Logo auf derselben Höhe wie die Suchfelder oder daneben angezeigt werden.

Das Google-Logo sollte links unten auf der Karte und die Informationen zur Quellenangabe rechts unten auf der Karte platziert werden. Beides sollte sich auf der als Ganzes präsentierten Karte und nicht darunter oder an einer anderen Stelle innerhalb der Anwendung befinden. Im folgenden Kartenbeispiel ist das Google-Logo unten links auf der Karte und die Quellenangabe unten rechts zu sehen.

Zur Verwendung auf einem hellen Hintergrund	Zur Verwendung auf einem dunklen Hintergrund

Die folgende Zip-Datei enthält das Google-Logo in den richtigen Größen für Desktop-, Android- und iOS-Anwendungen. Diese Logos dürfen weder in der Größe noch anderweitig verändert werden.

Herunterladen: google_logo.zip

Ändern Sie die Quellenangabe nicht. Entfernen, verdecken oder beschneiden Sie nicht die Quellenangabe. Sie können Google-Logos inline verwenden (z. B. „Diese Karten sind von [Google_logo]“).

Die Quellenangabe muss nah am zugehörigen Objekt platziert werden. Wenn Sie Screenshots von Google-Bildern außerhalb direkter Einbettungen verwenden, fügen Sie die Standardquellenangabe ein, wie sie im Bild erscheint. Bei Bedarf können Sie Stil und Platzierung der Quellenangabe anpassen, solange sich der Text in unmittelbarer Nähe des Inhalts befindet und für den durchschnittlichen Nutzer gut lesbar ist. Die Quellenangabe darf nicht weg vom Inhalt verschoben werden, etwa an das Ende Ihres Buchs, in den Abspann Ihrer Dateien oder Ihrer Sendung oder in die Fußzeile Ihrer Website.

Führen Sie die Drittdatenanbieter auf. Einige der Daten und Bilder in unseren Kartierungsprodukten stammen von anderen Anbietern als Google. Wenn Sie solche Bilder verwenden, muss der Text Ihrer Quellenangabe den Namen „Google“ sowie alle relevanten Datenanbieter enthalten, beispielsweise „Kartendaten: Google, Maxar Technologies“. Wenn in den Bildern Drittdatenanbieter genannt werden, ist die Quellenangabe korrekt, wenn Sie nur „Google“ oder das Google-Logo einfügen.

Wenn Sie die Google Maps Platform auf einem Gerät verwenden, auf dem die Anzeige der Quellenangabe nicht praktikabel ist, wenden Sie sich an das Google-Vertriebsteam, um für Ihren Anwendungsfall geeignete Lizenzen zu erhalten.

Andere Anforderungen bezüglich Quellenangaben

Quellenangaben zu Drittanbietern enthalten Inhalte und Links, die Sie dem Nutzer im bereitgestellten Format anzeigen müssen. Google empfiehlt, dass diese Informationen in Ihrer App unterhalb der Ortsdetails angezeigt werden.

Die von der API zurückgegebenen Drittanbieterzuordnungen enthalten nicht die Google-Attribution. Du musst diese Quellenangabe selbst einfügen, wie unter Google-Logo und Quellenangaben anzeigen beschrieben.

Tipp :Für das Rendern von NSAttributedString-Daten kann es praktisch sein, eine Drittanbieterbibliothek zu verwenden.

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

Zuordnungen für einen einzelnen Ort abrufen

Wenn Sie einen Ort durch Abrufen eines Ortes nach ID abrufen, können Sie die Quellenangaben für diesen Ort aus der attributions-Property auf GMSPlace abrufen.

attributions werden als NSAttributedString-Objekt bereitgestellt.

Zuordnungen für eine Sammlung von Orten abrufen

Wenn Ihre App Informationen anzeigt, die durch Anfordern des aktuellen Orts des Geräts erhalten wurden, müssen in der App Drittanbieter-Quellenangaben für die angezeigten Ortsdetails angezeigt werden. Sie können die Zuordnungen für alle in der Anfrage abgerufenen Orte über die Property attributions auf GMSPlaceLikelihoodList abrufen.

Die attributions werden als NSAttributedString-Objekt bereitgestellt, auf das Sie genau wie die attributions an einem einzelnen Ort zugreifen und sie anzeigen lassen können, wie oben beschrieben.

Quellenangaben für ein Foto anzeigen

Wenn in Ihrer App Fotos angezeigt werden, müssen Sie für jedes Foto, das diese Bilder enthält, attributions und authorAttributions anzeigen.

• Verwenden Sie GMSPlacePhotoMetadata.attributions, um auf Quellenangaben zuzugreifen. Diese Property ist ein NSAttributedString oder nil, wenn keine Quellenangaben vorhanden sind.
• Mit GMSPlacePhotoMetadata.authorAttributions kannst du auf Autorenangaben zugreifen. Diese Eigenschaft enthält ein Array mit GMSPlaceAuthorAttribution-Objekten.

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 Rezension durch ein GMSPlaceReview-Objekt dargestellt wird. Du kannst diese Rezensionen optional in deiner App anzeigen lassen.

Wenn Sie Rezensionen von Google-Nutzern anzeigen lassen, müssen Sie den Namen des Autors nahe beieinander platzieren. Sofern im Feld für die Autorenangabe des Objekts GMSPlaceReview verfügbar, empfehlen wir, auch das Foto des Autors und einen Link zu seinem Profil anzugeben. Die folgende Abbildung zeigt ein Beispiel für eine Rezension eines Parks:

Google empfiehlt außerdem, die Sortierung der Rezensionen für den Endnutzer darzustellen.

Hinweis : Rezensionen werden standardmäßig nach Relevanz sortiert. Beim neuen SDK ist die Sortierung nach Relevanz die einzige Option.

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 zu Drittanbietern werden als NSAttributedString-Objekte bereitgestellt, die Inhalte und Links enthalten, die Sie aufbewahren und dem Nutzer anzeigen müssen.

Die empfohlene Methode zur Darstellung der Quellenangaben ist UITextView, da die Links in den Quellenangaben funktionieren müssen. Damit Links funktionieren, legen Sie einen Delegaten für UITextView fest und stellen Sie die shouldInteractWithURL-Methode Ihrer UITextViewDelegate so ein, 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 nach Beispielunternehmen

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

Stilrichtlinien für Google-Quellenangaben

Im Folgenden finden Sie Stilrichtlinien für Google-Quellenangaben in CSS und HTML, wenn Sie nicht das herunterladbare Google-Logo verwenden können.

Speicherplatz freigeben

Der Freiraum um das Logo mit Claim sollte mindestens so groß sein wie die Höhe des „G“ in Google.

Der Abstand zwischen der Quellenangabe und dem Google-Logo sollte halb so breit sein wie das „G“.

Lesbarkeit

Die Verfasserzeile sollte immer klar und deutlich lesbar sein und in der richtigen Farbvariante für einen bestimmten Hintergrund erscheinen. Wichtig ist, dass die von Ihnen gewählte Logovariante genügend Kontrast bietet.

Farbe

Verwenden Sie Google Material Gray 700 für Text auf einem weißen oder hellen Hintergrund, der einen Bereich mit einer maximalen Schwarztönung von 0 %–40 % hat.

Google

#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

Auf dunkleren Hintergründen und über Fotos oder unauffälligen Mustern verwenden Sie weißen Text für die Verfasserzeile und Quellenangabe.

Google

#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

Schriftart

Verwenden Sie die Schriftart Roboto.

Beispiel-CSS

Wenn das folgende CSS auf den Text „Google“ angewendet wird, wird dieser mit der entsprechenden Schriftart, Farbe und den entsprechenden Abständen auf einem weißen oder hellen Hintergrund dargestellt.

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;