In diesem Dokument werden Anforderungen beschrieben, die für alle mit dem Places SDK for iOS entwickelten Anwendungen 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 Places SDK for iOS-App entwickeln, müssen Sie in Ihrer App die Nutzungsbedingungen und eine Datenschutzerklärung bereitstellen, die den in Ihrer Vereinbarung mit Google aufgeführten Richtlinien entsprechen:
- Die Nutzungsbedingungen und die Datenschutzerklärung müssen öffentlich zugänglich sein.
- Sie müssen explizit in den Nutzungsbedingungen Ihrer Anwendung angeben, dass Nutzer durch die Verwendung Ihrer Anwendung an die Nutzungsbedingungen von Google gebunden sind.
- Sie müssen Nutzer in Ihrer Datenschutzerklärung darüber informieren, dass Sie die Google Maps APIs nutzen, und sie mithilfe der Datenschutzerklärung von Google einbinden.
Der empfohlene Ort für die Bereitstellung der Nutzungsbedingungen und der Datenschutzerklärung hängt von der Plattform Ihrer Anwendung ab.
Mobile Apps
Wenn Sie eine mobile App entwickeln, sollten Sie auf der Downloadseite Ihrer App im entsprechenden App-Shop und im Menü „App-Einstellungen“ einen Link zu den Nutzungsbedingungen und der Datenschutzerklärung angeben.
Webanwendungen
Bei der Entwicklung einer Webanwendung empfehlen wir, in der Fußzeile Ihrer Website einen Link zu den Nutzungsbedingungen und zur Datenschutzerklärung anzugeben.
Prefetching, 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 Nutzungsbedingungen genannten Bedingungen abrufen, indexieren, speichern oder im Cache speichern.
Ergebnisse des Places SDK for iOS anzeigen
Sie können das Places SDK for iOS auf einer Google Maps-Karte oder ohne Karte anzeigen. Wenn die Ergebnisse des Places SDK for iOS auf einer Karte erscheinen sollen, müssen sie auf einer Google Maps-Karte angezeigt werden. Es ist nicht zulässig, das Places SDK for iOS auf einer Karte zu verwenden, die keine Google-Karte ist.
Google-Logo und Quellenangaben
Wenn Ihre Anwendung Daten auf einer Google Maps-Karte anzeigt, wird das Google-Logo eingefügt und darf nicht geändert werden. Anwendungen, die Google-Daten auf demselben Bildschirm wie eine Google Maps-Karte anzeigen, müssen Google keine weiteren Quellenangaben machen.
Wenn in Ihrer App Daten auf einer Seite oder in einer Ansicht ohne Google-Karte angezeigt werden, muss mit diesen Daten ein Google-Logo angezeigt werden. Wenn Ihre App beispielsweise Google-Daten auf einem Tab und eine Google Maps-Karte mit diesen Daten auf einem anderen Tab anzeigt, muss der erste Tab das Google-Logo enthalten. Wenn in Ihrer Anwendung Suchfelder mit oder ohne automatische Vervollständigung verwendet werden, muss das Logo inline angezeigt werden.
Das Google-Logo sollte unten links auf der Karte platziert werden. Die Attributionsinformationen müssen in der rechten unteren Ecke platziert werden. Beides sollte auf der Karte als Ganzes dargestellt werden, nicht unter der Karte oder an einer anderen Stelle in der App. Im folgenden Kartenbeispiel ist das Google-Logo unten links auf der Karte und die Quellenangabe rechts unten zu sehen.
| Zur Verwendung auf hellem Hintergrund | Zur Verwendung auf dunklem Hintergrund |
|---|---|
|
|
Die folgende ZIP-Datei enthält das Google-Logo in den richtigen Größen für Computer-, Android- und iOS-Anwendungen. Diese Logos dürfen weder in der Größe noch anderweitig verändert werden.
Herunterladen:google_logo.zip
Ändern Sie nicht die Attribution. Entfernen, ausblenden oder schneiden Sie die Attributionsinformationen nicht ab. Google-Logos dürfen nicht inline verwendet werden. Beispiel: „Diese Karten stammen von [Google_logo].“
Die Attribution sollte immer nah genug sein. Wenn du Screenshots von Google-Bildern außerhalb von direkten Einbettungen verwendest, platziere die Standard-Attribution so, wie sie im Bild erscheint. Bei Bedarf kannst du den Stil und die Platzierung des Zuordnungstexts anpassen, solange er sich in der Nähe des Inhalts befindet und für den durchschnittlichen Zuschauer gut lesbar ist. Du darfst die Quellenangabe nicht vom Inhalt, z. B. zum Ende des Buchs, von den Quellenangaben der Dateien oder der Sendung oder von der Fußzeile deiner Website entfernen.
Drittanbieter von Daten einbeziehen Einige der Daten und Bilder in unseren Kartierungsprodukten stammen von anderen Anbietern als Google. Wenn Sie solche Bilder verwenden, muss der Text der Zuordnung den Namen „Google“ und die jeweiligen Datenanbieter enthalten, z. B. „Kartendaten: Google, Maxar Technologies“. Wenn Drittanbieter Daten in den Bildern angeben, ist nur die Verwendung von „Google“ oder das Google-Logo nicht zulässig.
Wenn Sie die Google Maps Platform auf einem Gerät verwenden, auf dem die Attributionsanzeige nicht praktikabel ist, wenden Sie sich an das Google-Vertriebsteam, um über Lizenzen für Ihren Anwendungsfall zu sprechen.
Sonstige Attributionsanforderungen
Zuordnungen zu Drittanbietern enthalten Inhalte und Links, die Sie dem Nutzer in dem Format anzeigen müssen, in dem er sie bereitgestellt hat. Google empfiehlt, diese Informationen in Ihrer App unter den Ortsdetails anzuzeigen.
Die von der API zurückgegebenen Drittanbieter-Attributionen enthalten nicht die Google-Attribution. Sie müssen diese Zuordnung selbst einfügen, wie unter Google-Logo und Quellenangaben anzeigen beschrieben.
Folgen Sie dieser Anleitung, um Zuordnungen von Drittanbietern für einen einzelnen Ort oder eine Gruppe von Orten abzurufen.
Zuordnungen für einen einzelnen Ort abrufen
Wenn Sie einen Ort über einen Ort anhand der ID abrufen, können Sie die Quellenangaben für diesen Ort aus der Eigenschaft attributions in GMSPlace abrufen.
attributions wird als NSAttributedString-Objekt angegeben.
Zuordnungen für eine Auflistung von Orten abrufen
Wenn in Ihrer App Informationen angezeigt werden, die durch Anfordern des aktuellen Orts des Geräts erfasst wurden, müssen in der App
Quellenangaben von Drittanbietern für die angezeigten Details angezeigt werden. Die Zuordnungen für alle in der Anfrage abgerufenen Orte kannst du aus der attributions-Property am
GMSPlaceLikelihoodList abrufen.
Die attributions wird als NSAttributedStringObjekt bereitgestellt, auf das du auf dieselbe Weise wie attributionsan einem einzigen Ort zugreifen und zugreifen kannst, wie oben.
Zuordnungen für ein Foto anzeigen
Wenn in deiner App Fotos angezeigt werden, musst du für jedes Foto, das sie enthält, Quellenangaben machen. Um Quellenangaben für ein Foto zu erhalten, müssen Sie
GMSPlacePhotoMetadata.attributions aufrufen. 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;
}
}
}];
Zuordnungen für Inhalte Dritter anzeigen
Zuordnungen an Drittanbieter werden als NSAttributedString-Objekte angegeben, die Inhalte und Links enthalten, die du beibehalten und für den Nutzer anzeigen musst.
Die empfohlene Methode zum Anzeigen der Zuordnungen ist ein UITextView, da Links in den Zuordnungen funktionieren müssen.
Damit Links funktionieren, musst du einen Bevollmächtigten für UITextView festlegen und die Methode shouldInteractWithURL von UITextViewDelegate festlegen, um YES zurückzugeben.
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 Beispiel oben wird der Textbereich Beispielunternehmen durch das Attribut NSLink abgedeckt.
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. Die Orts-ID wird im Feld place_id des Places SDK for iOS zurückgegeben.
Stilrichtlinien für die Google-Attribution
Wenn du das herunterladbare Google-Logo nicht verwenden kannst, gelten die folgenden Stilrichtlinien für die Google-Attribution in CSS und HTML:
Mindestabstand
Der Mindestabstand rund um das Logo mit Claim sollte mindestens der Höhe des „G“ in Google entsprechen.
Der Abstand zwischen der Namensnennung und dem Google-Logo muss halb so breit wie das „G“ sein.
Lesbarkeit
Die Verfasserzeile sollte immer klar und gut lesbar sein und in der richtigen Farbvariante für einen bestimmten Hintergrund erscheinen. Achten Sie darauf, für die ausgewählte Logovariante immer genügend Kontrast zu bieten.
Farbe
Verwenden Sie Google Material Grau 700-Text auf weißem oder hellem Hintergrund mit einem maximalen Farbton von 0–40 %.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Verwenden Sie auf dunklem Hintergrund und bei Fotos mit wenig oder mit Nichtbeschäftigten den weißen Text für Verfasserzeile und Attribution.
#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 „Google“ mit der entsprechenden Schriftart, Farbe und Abständen auf weißem oder hellem Hintergrund gerendert.
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;