Ten dokument zawiera wymagania dotyczące wszystkich aplikacji opracowanych za pomocą pakietu Places SDK na iOS, w tym usługi autouzupełniania miejsc, która jest częścią tego interfejsu API. Więcej ogólnych informacji dla deweloperów Map Google znajdziesz w Warunkach korzystania z usługi Google Maps Platform.
Zasady
W tej sekcji opisano zasady dotyczące pakietu Places SDK for iOS. Zasady zawierają praktyczne wskazówki i wymagania dotyczące wdrażania, które pomogą Ci prawidłowo korzystać z usługi i spełniać oczekiwania Google Maps Platform.
Wyjątki od ograniczeń dotyczących buforowania
Pamiętaj, że identyfikator miejsca, który służy do jednoznacznej identyfikacji miejsca, nie podlega ograniczeniom dotyczącym buforowania.
Dlatego możesz przechowywać wartości identyfikatorów miejsc bezterminowo.
Identyfikator miejsca jest zwracany w polu place_id w odpowiedziach interfejsu API. Więcej informacji o zapisywaniu i odświeżaniu identyfikatorów miejsc oraz zarządzaniu nimi znajdziesz w przewodniku po identyfikatorach miejsc.
Kraje i terytoria Europejskiego Obszaru Gospodarczego
W przypadku klientów, których adres rozliczeniowy znajduje się w Europejskim Obszarze Gospodarczym (EOG), ta usługa ma inne Warunki korzystania z usługi i może mieć inne funkcje. Zanim zaczniesz tworzyć rozwiązania za pomocą Google Maps Platform, zapoznaj się z tymi warunkami i informacjami dotyczącymi Europejskiego Obszaru Gospodarczego:
- Warunki korzystania z usługi Google Maps Platform w Europejskim Obszarze Gospodarczym
- Szczegółowe warunki korzystania z usługi Google Maps Platform w Europejskim Obszarze Gospodarczym
- Najczęstsze pytania dotyczące Europejskiego Obszaru Gospodarczego
- Wymagania Google Maps Platform dotyczące bezpieczeństwa na drodze
Jeśli Twój adres rozliczeniowy nie znajduje się w Europejskim Obszarze Gospodarczym, obowiązują Cię te warunki korzystania z usługi:
- Warunki korzystania z usługi Google Maps Platform
- Szczegółowe warunki korzystania z usługi Google Maps Platform
Wymagania dotyczące podania źródła w Mapach Google
W tej sekcji znajdziesz wymagania dotyczące podania źródła i wytyczne dotyczące wyświetlania Map Google i treści z Map Google w aplikacjach.
Przykład atrybucji
Poniżej znajdziesz przykład atrybucji w przypadku Places UI Kit.
Wyświetlanie informacji o autorstwie w Mapach Google
Podczas wyświetlania treści z interfejsów API Google Maps Platform w aplikacji lub witrynie musisz przestrzegać wymagań dotyczących podania źródła Map Google. Nie musisz dodawać dodatkowych informacji o autorstwie, jeśli Treści są wyświetlane w Mapach Google, gdzie informacje o autorstwie są już widoczne.
Uwzględniono atrybucję Map Google
W przypadku atrybucji Map Google, która jest już udostępniana przez Google Maps Platform w interfejsie, np. w Places UI Kit:
- Nie usuwaj dołączonych informacji o autorstwie, niezależnie od tego, gdzie są wyświetlane. Nie zmieniaj, nie ukrywaj ani nie zasłaniaj informacji o autorze i upewnij się, że jest ona wyraźnie widoczna na tle.
- Zawsze wizualnie odróżniaj treści Google Maps Platform od innych treści, używając wskazówek interfejsu, takich jak obramowanie, kolor tła, cień lub wystarczająca ilość pustego miejsca.
- Wprowadzając zmiany wizualne, musisz przestrzegać wszystkich wymagań Google Maps dotyczących podawania źródła.
Logo Map Google i atrybucja tekstowa
Jeśli to możliwe, atrybucja powinna mieć formę logo Map Google. W przypadkach, gdy ilość miejsca jest ograniczona, dopuszczalny jest tekst Mapy Google. Użytkownicy muszą zawsze wiedzieć, które treści pochodzą z Map Google.
Atrybucja logo
Aby używać logo Map Google w aplikacji lub witrynie, musisz spełnić te wymagania.
Pobieranie logo Map Google
Używaj oficjalnych plików logo Map Google. Pobierz logo poniżej i postępuj zgodnie ze wskazówkami podanymi w tej sekcji.
Pobierz zasoby dotyczące atrybucji Map GooglePodczas korzystania z logo Map Google postępuj zgodnie z tymi wytycznymi.
- Nie modyfikuj logo w żaden sposób.
- Zachowaj format obrazu logo, aby uniknąć zniekształceń.
- Używaj logo z obramowaniem na szczegółowym tle, np. na mapie lub obrazie.
- Używaj logo bez obramowania na jednolitym tle, np. w jednolitym kolorze lub z delikatnym gradientem.
Specyfikacja rozmiaru logo
Logo Map Google musi być zgodne z tymi wytycznymi dotyczącymi rozmiaru:- Minimalna wysokość logo: 16 dp
- Maksymalna wysokość logo: 19 dp
- Minimalny pusty obszar wokół logo: 10 dp po lewej i prawej stronie oraz u góry, 5 dp u dołu.
Więcej informacji o dp znajdziesz w artykule Gęstość pikseli na stronie Material Design.
Dostępność logo
Logo Map Google musi spełniać te wymagania dotyczące ułatwień dostępu:- Zachowaj odpowiedni kontrast między logo a tłem.
- Dołącz etykietę ułatwień dostępu z tekstem Mapy Google.
Atrybucja tekstowa
Jeśli rozmiar interfejsu nie pozwala na użycie logo Map Google, możesz wpisać tekst Mapy Google. Skorzystaj z tych wskazówek:
- Nie modyfikuj w żaden sposób tekstu Mapy Google:
- Nie zmieniaj wielkości liter w nazwie Mapy Google.
- Nie zawijaj nazwy Mapy Google do wielu wierszy.
- Nie tłumacz nazwy Mapy Google na inny język.
- Aby uniemożliwić przeglądarkom tłumaczenie Map Google, użyj atrybutu HTML
translate="no".
Tekst Map Google należy sformatować zgodnie z tabelą poniżej:
Wymagania dotyczące stylizacji tekstu w Mapach Google Właściwość Styl Rodzina czcionek Roboto. Wczytywanie czcionki jest opcjonalne. Rodzina czcionek zastępczych Dowolna czcionka bezszeryfowa używana już w Twojej usłudze lub „Sans-Serif”, aby wywołać domyślną czcionkę systemową. Styl czcionki Normalna Grubość czcionki 400 Kolor czcionki Biały, czarny (#1F1F1F) lub szary (#5E5E5E). Zachowaj dostępny kontrast (4,5:1) względem tła. Rozmiar czcionki Minimalny rozmiar czcionki: 12 sp
Maksymalny rozmiar czcionki: 16 sp
Więcej informacji o jednostce sp znajdziesz w sekcji Jednostki rozmiaru czcionki na stronie Material Design.Odstępy między literami Normalna
Przykładowy kod CSS
Poniższy kod CSS renderuje Mapy Google z odpowiednim stylem typograficznym i kolorem na białym lub jasnym tle.
@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; }
Wymagania dotyczące treści wizualnych
Postępuj zgodnie z tymi wymaganiami dotyczącymi wizualnego traktowania atrybucji Map Google.Umieść informacje o autorze w pobliżu góry lub dołu treści i w tym samym kontenerze wizualnym. W przypadku pojedynczego wiersza treści atrybucję można umieścić po prawej lub lewej stronie.
Wizualnie odróżniaj treści Google Maps Platform od innych treści, używając wskazówek interfejsu, takich jak obramowanie, kolor tła, cień lub wystarczająca ilość pustego miejsca.
- Nie przedstawiaj Map Google w fałszywy sposób, przypisując im treści, które nie pochodzą z Google Maps Platform.
- Sprawdź, czy atrybucja jest zawsze widoczna i czytelna. Nigdy nie usuwaj, nie ukrywaj, nie zasłaniaj ani nie modyfikuj tego logo.
Na ilustracjach poniżej pokazano przykłady tych wymagań wizualnych.
zewnętrzni dostawcy danych,
Niektóre dane i zdjęcia w naszych usługach mapowania pochodzą od dostawców innych niż Google. W przypadku niektórych usług, takich jak Map Tiles API, możemy podać wymagane informacje o autorze, które należy przypisać zewnętrznemu dostawcy danych. W takim przypadku tekst atrybucji musi zawierać nazwę „Mapy Google” i nazwy odpowiednich dostawców danych, np. „Dane mapy: Google, Maxar Technologies”. Gdy Google podaje informacje o źródle, które należy do innej firmy, podanie tylko „Map Google” lub logo Google nie jest prawidłowym podaniem źródła.
Inne wymagania dotyczące atrybucji
Atrybucje dostawców zewnętrznych zawierają treści i linki, które musisz wyświetlać użytkownikowi w formacie, w jakim są dostarczane. Google zaleca, aby aplikacja wyświetlała te informacje pod informacjami o miejscu.
Atrybucje innych firm zwracane przez interfejs API nie obejmują atrybucji Google. Musisz samodzielnie dodać te informacje, zgodnie z opisem w artykule Wyświetlanie logo Google i informacji o źródle danych.
Postępuj zgodnie z tymi instrukcjami, aby pobrać informacje o autorze dotyczące jednego miejsca lub zbioru miejsc.
Pobieranie informacji o autorze dla jednego miejsca
Gdy pobierasz miejsce, pobierając miejsce według identyfikatora, możesz pobrać atrybucje dla tego miejsca z właściwości attributions w GMSPlace.
attributions są podawane jako obiekt NSAttributedString.
Pobieranie informacji o autorstwie kolekcji miejsc
Jeśli aplikacja wyświetla informacje uzyskane przez wysłanie żądania dotyczącego aktualnego miejsca, musi wyświetlać informacje o pochodzeniu danych dotyczące wyświetlanych informacji o miejscu. Możesz pobrać atrybucje wszystkich miejsc pobranych w żądaniu z właściwości attributions w
GMSPlaceLikelihoodList.
attributions są udostępniane jako obiekt NSAttributedString, do którego możesz uzyskać dostęp i który możesz wyświetlić w taki sam sposób jak attributions w przypadku pojedynczego miejsca, jak opisano powyżej.
Atrybucje wyników wyszukiwania
W Europie, gdy używasz niezmienionego rankingu Google, usługi wyszukiwania muszą zawierać tekst objaśniający, który znajduje się nie dalej niż 1 kliknięcie od strony głównej i opisuje główne czynniki oraz ich wagę, które decydują o pozycji w rankingu wyników wyszukiwania. Tekst wyjaśniający:
Nagłówek: Informacje o tych wynikach
Treść: Gdy szukasz firm lub miejsc w pobliżu danej lokalizacji, w Mapach Google wyświetlają się wyniki lokalne. Aby wybrać dla Ciebie najlepsze wyniki wyszukiwania, uwzględniamy różne czynniki – przede wszystkim trafność, odległość i renomę.
Przycisk 1: Więcej informacji
Tekst „Więcej informacji” powinien prowadzić do artykułu w Centrum pomocy.
Przycisk 2: OK
Wyświetlanie informacji o autorze zdjęcia
Jeśli aplikacja wyświetla zdjęcia, musisz pokazywać wszystkie attributions i authorAttributions dla każdego zdjęcia, które je zawiera.
- Aby uzyskać dostęp do atrybucji, użyj
GMSPlacePhotoMetadata.attributions. Ta właściwość toNSAttributedStringlubnil, jeśli nie ma żadnych atrybucji do wyświetlenia. - Aby uzyskać dostęp do informacji o autorach, użyj
GMSPlacePhotoMetadata.authorAttributions. Ta właściwość zawiera tablicę obiektówGMSPlaceAuthorAttribution.
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; } } }];
Wyświetlanie opinii
Obiekt GMSPlace może zawierać maksymalnie 5 opinii, z których każda jest reprezentowana przez obiekt GMSPlaceReview. Możesz opcjonalnie wyświetlać te opinie w aplikacji.
Podczas wyświetlania opinii dodanych przez użytkowników Google musisz umieścić imię i nazwisko autora w pobliżu. Jeśli w polu atrybucji autora obiektu GMSPlaceReview jest to możliwe, zalecamy też dodanie zdjęcia autora i linku do jego profilu. Na obrazie poniżej widać przykład
opinii o parku:
Google zaleca też wyświetlanie użytkownikowi informacji o tym, jak opinie są sortowane.
Aby uzyskać dostęp do opinii:
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. } }];
Wyświetlanie atrybucji innych firm
Atrybucje dostawców zewnętrznych są dostarczane jako obiekty NSAttributedString, które zawierają treści i linki, które musisz zachować i wyświetlić użytkownikowi.
Zalecanym sposobem wyświetlania informacji o autorze jest użycie elementu UITextView, ponieważ linki w informacjach o autorze muszą działać.
Aby linki działały, ustaw obiekt delegowany w UITextView i ustaw metodę shouldInteractWithURL obiektu UITextViewDelegate, aby zwracała YES.
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; }
Przykład atrybucji przez firmę zewnętrzną
Atrybucja zewnętrzna zwykle składa się z tekstu z linkiem. Obejmuje to na przykład:
Oferty firmy Przykładowa firma
W powyższym przykładzie zakres tekstu Example Company jest objęty atrybutem NSLink.
Autouzupełnianie adresów użytkowników
Gdy użytkownik korzysta z funkcji autouzupełniania w Twojej aplikacji, aby wpisać adres, który zostałby przez niego podany w całości i prawidłowo bez użycia autouzupełniania, wybrany przez niego adres nie podlega ograniczeniom dotyczącym treści Map Google określonym w Umowie dotyczącej Google Maps Platform. Ten wyjątek dotyczy tylko adresu pocztowego wybranego przez użytkownika i wyłącznie konkretnej transakcji tego użytkownika. Nie dotyczy on listy sugerowanych adresów dostarczanych przez funkcję autouzupełniania ani innych Treści Map Google. Ten wyjątek nie dotyczy funkcji wyszukiwania ciekawych miejsc ani adresów oferowanych przez inne usługi Google Maps Platform.
Na poprzednim obrazie lista adresów po lewej stronie nadal podlega ograniczeniom dotyczącym treści Map Google. Gdy użytkownik wybierze adres, nie będzie on podlegać ograniczeniom dotyczącym Treści Map Google wyłącznie na potrzeby danej transakcji użytkownika.