In diesem Dokument werden Anforderungen aufgeführt, die für alle Anwendungen, die mit dem Places SDK for iOS entwickelt wurden, spezifisch sind. Dazu gehört auch der Place Autocomplete-Dienst, 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 Datenschutzrichtlinie
Wenn Sie eine App für das Places SDK for iOS entwickeln, müssen Sie die Nutzungsbedingungen und eine Datenschutzerklärung in Ihrer App zur Verfügung stellen. Diese muss den in Ihrer Vereinbarung mit Google beschriebenen Richtlinien entsprechen:
- Die Nutzungsbedingungen und die Datenschutzerklärung müssen öffentlich zugänglich sein.
- Du musst in den Nutzungsbedingungen deiner App ausdrücklich angeben, dass Nutzer durch die Verwendung deiner App an die Nutzungsbedingungen von Google gebunden sind.
- Sie müssen die Nutzer in Ihrer Datenschutzerklärung darüber informieren, dass Sie die Google Maps APIs verwenden und die Datenschutzerklärung von Google einbeziehen.
Wo du deine Nutzungsbedingungen und deine Datenschutzerklärung veröffentlichen solltest, hängt von der Plattform deiner App ab.
Mobile Apps
Wenn Sie eine mobile App entwickeln, sollten Sie auf der Downloadseite Ihrer App im entsprechenden App-Shop und im Menü der App-Einstellungen einen Link zu den Nutzungsbedingungen und zur Datenschutzerklärung angeben.
Webanwendungen
Wenn Sie eine Webanwendung entwickeln, sollten Sie in der Fußzeile Ihrer Website einen Link zu den Nutzungsbedingungen und zur Datenschutzerklärung angeben.
Vorabruf, Caching oder Speicherung von Inhalten
Anwendungen, die das Places SDK for iOS verwenden, sind an die Bedingungen Ihrer Vereinbarung mit Google gebunden. Gemäß den Bedingungen Ihrer Vereinbarung dürfen Sie Inhalte nur unter den in den Bedingungen angegebenen Bedingungen im Voraus abrufen, indexieren, speichern oder im Cache speichern.
Die Orts-ID, die zur eindeutigen Identifizierung eines Ortes verwendet wird, ist von den Caching-Einschränkungen ausgenommen. Die Orts-ID wird in den Antworten des Places SDK for iOS im Feld „place_id“ zurückgegeben. Informationen zum Speichern, Aktualisieren und Verwalten von Orts-IDs finden Sie im Leitfaden zu Orts-IDs.
Ergebnisse des Places SDK for iOS anzeigen
Die Ergebnisse des Places SDK for iOS können auf einer Google Maps-Karte oder ohne Karte angezeigt werden. Wenn Ergebnisse aus dem Places SDK for iOS auf einer Karte angezeigt werden sollen, müssen die Ergebnisse auch auf einer Google-Karte angezeigt werden. Daten des Places SDK for iOS dürfen nicht auf Karten verwendet werden, die keine Google-Karten sind.
Google-Logo und Quellenangaben anzeigen
Wenn Ihre App Daten auf einer Google Maps-Karte anzeigt, ist das Google-Logo enthalten und darf nicht verändert werden. Bei Anwendungen, die Google-Daten auf demselben Bildschirm wie eine Google-Karte anzeigen, muss Google nicht weiter namentlich erwähnt werden.
Falls deine App Daten auf einer Seite oder Ansicht anzeigt, die nicht auch eine Google-Karte umfasst, musst du ein Google-Logo mit diesen Daten anzeigen. Wenn in deiner Anwendung beispielsweise Google-Daten auf einem Tab und eine Google-Karte mit diesen Daten auf einem anderen Tab angezeigt werden, muss auf dem ersten Tab das Google-Logo angezeigt werden. Wenn Ihre Anwendung Suchfelder mit oder ohne automatische Vervollständigung verwendet, muss das Logo inline angezeigt werden.
Das Google-Logo sollte in der unteren linken Ecke der Karte und die Attributionsinformationen in der unteren rechten Ecke platziert werden. Beide Elemente sollten auf der Karte als Ganzes dargestellt werden und nicht unter der Karte oder einem anderen Ort innerhalb der Anwendung. Das folgende Kartenbeispiel zeigt das Google-Logo unten links auf der Karte und die Quellenangabe unten rechts.
Zur Verwendung auf hellem 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-Apps. Sie dürfen die Größe dieser Logos weder verändern noch ändern.
Herunterladen:google_logo.zip
Ändern Sie die Attribution nicht. Die Attributionsinformationen dürfen nicht entfernt, verdeckt oder abgeschnitten werden. Google-Logos (z. B. „Diese Karten stammen von [Google_logo]“) dürfen nicht verwendet werden.
Achten Sie darauf, dass die Namensnennung möglichst genau ist. Wenn du Screenshots von Google-Bildern außerhalb direkter Einbettungen verwendest, füge die Standardkennzeichnung so hinzu, wie sie im Bild zu sehen ist. Bei Bedarf kannst du den Stil und die Platzierung des Quellenangabetexts anpassen, solange er sich in unmittelbarer Nähe zum Inhalt befindet und für den durchschnittlichen Zuschauer oder Leser gut lesbar ist. Die Quellenangabe darf vom Inhalt nicht entfernt werden, etwa am Ende des Buchs, den Mitwirkenden an den Dateien oder der Sendung oder in der Fußzeile deiner Website.
Datendrittanbieter einbeziehen. Einige der Daten und Bilder in unseren Kartenprodukten stammen nicht von Google, sondern von anderen Anbietern. Wenn Sie solche Bilder verwenden, müssen Ihre Quellenangaben den Namen „Google“ und die entsprechenden Datenanbieter enthalten, z. B. „Map data: Google, Maxar Technologies“. Wenn in den Bildern Datendrittanbieter genannt werden, ist nur die Angabe von „Google“ oder des Google-Logos keine ordnungsgemäße Quellenangabe.
Wenn Sie die Google Maps Platform auf einem Gerät verwenden, auf dem die Attributionsanzeige nicht praktikabel ist, kontaktieren Sie das Vertriebsteam von Google, um zu besprechen, welche Lizenzen für Ihren Anwendungsfall geeignet sind.
Sonstige Anforderungen für Quellenangaben
Quellenangaben zu Drittanbietern enthalten Inhalte und Links, die Sie dem Nutzer in dem Format anzeigen müssen, in dem sie bereitgestellt werden. Google empfiehlt, diese Informationen in der App unter den Ortsdetails zu sehen.
Die von der API zurückgegebenen Drittanbieter-Attributionen enthalten nicht die Google-Attribution. Sie müssen diese Quellenangabe selbst einfügen, wie unter Google-Logo und Quellenangaben anzeigen beschrieben.
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 Orts nach ID abrufen, können Sie die Quellenangaben für diesen Ort aus der Eigenschaft attributions
in GMSPlace
abrufen.
Die attributions
werden als NSAttributedString
-Objekt angegeben.
Quellenangaben für eine Sammlung von Orten abrufen
Wenn in deiner App Informationen angezeigt werden, die durch Anfordern des aktuellen Orts des Geräts abgerufen wurden, müssen für die angezeigten Ortsdetails Quellenangaben von Drittanbietern angegeben werden. Du kannst die Quellenangaben für alle in der Anfrage abgerufenen Orte aus dem Attribut attributions
in
GMSPlaceLikelihoodList
abrufen.
Die attributions
werden als NSAttributedString
-Objekt bereitgestellt, das Sie wie die attributions
an einem einzigen Ort aufrufen und 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 solche Fotos enthält, Quellenangaben hinzufügen. Rufen Sie
GMSPlacePhotoMetadata.attributions
auf, um Quellenangaben für ein Foto zu erhalten. Dieses Attribut ist ein NSAttributedString
oder nil
, wenn keine Attributionen vorhanden sind.
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; } } }];
Quellenangaben von Drittanbietern anzeigen
Quellenangaben zu Drittanbietern werden als NSAttributedString
-Objekte bereitgestellt, die Inhalte und Links enthalten, die Sie beibehalten und dem Nutzer anzeigen müssen.
Die empfohlene Methode zur Anzeige der Quellenangaben ist die Verwendung von UITextView
, da die Links in den Zuordnungen funktionieren müssen.
Damit die Links funktionieren, legen Sie einen Delegaten für UITextView
fest und legen Sie in der Methode shouldInteractWithURL
der UITextViewDelegate
fest, 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 die Google-Attribution
Im Folgenden finden Sie Stilrichtlinien für Google-Quellenangaben in CSS und HTML, wenn Sie das herunterladbare Google-Logo nicht verwenden können.
Mindestabstand
Der Mindestabstand rund um das Logo mit Claim sollte der Höhe des „G“ in Google entsprechen oder größer sein.
Der Abstand zwischen dem Attributionstext und dem Google-Logo sollte die halbe Breite des „G“ haben.
Lesbarkeit
Die Verfasserzeile sollte immer klar und gut lesbar sein und in der richtigen Farbvariation für einen gegebenen Hintergrund erscheinen. Für die ausgewählte Logovariante muss immer genügend Kontrast geschaffen werden.
Farbe
Verwenden Sie Google Material Gray 700-Text auf weißem oder hellem Hintergrund mit einem maximalen Schwarzwert von 0 bis 40 %.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Verwenden Sie auf dunkleren Hintergründen und auf Fotos oder bei Mustern, die nicht überladen sind, weißen Text für die Verfasserzeile und die Quellenangabe.
#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, würde es „Google“ mit der entsprechenden Schriftart, Farbe und dem entsprechenden Abstand auf weißem oder hellem Hintergrund rendern.
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;