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 Google Maps Platform.
Udostępnianie warunków korzystania z usługi i polityki prywatności
Jeśli opracowujesz pakiet SDK Miejsca na potrzeby aplikacji na iOS, musisz udostępnić w aplikacji Warunki korzystania z usługi i Politykę prywatności, które są zgodne z wytycznymi opisanymi w umowie z Google:
- Warunki korzystania z usługi i Polityka prywatności muszą być publicznie dostępne.
- W Warunkach korzystania z aplikacji musisz wyraźnie stwierdzić, że korzystanie z aplikacji jest równoznaczne z zaakceptowaniem Warunków korzystania z usługi Google.
- Musisz powiadomić użytkowników w Polityce prywatności, że korzystasz z interfejsów API Map Google, i uwzględnić te informacje w Polityce prywatności Google.
Miejsce, w którym zalecamy udostępnienie Warunków korzystania z aplikacji i Polityki prywatności, zależy od platformy aplikacji.
Aplikacja mobilna
Jeśli tworzysz aplikację mobilną, zalecamy umieszczenie linku do Warunków korzystania z usługi i Polityki prywatności na stronie pobierania aplikacji w odpowiednim sklepie z aplikacjami oraz w menu ustawień aplikacji.
Aplikacje internetowe
Jeśli tworzysz aplikację internetową, zalecamy umieszczenie w stopce witryny linku do Warunków korzystania z usługi i Polityki prywatności.
pobieranie w ramach wstępnego pobierania, przechowywania w pamięci podręcznej lub przechowywania treści;
Aplikacje korzystające z pakietu SDK Miejsca na iOS są objęte postanowieniami umowy z Google. Zgodnie z warunkami Umowy nie wolno Ci pobierać wstępnie, indeksować, przechowywać ani przechowywać w pamięci podręcznej żadnych Treści, z wyjątkiem ograniczonych warunków określonych w Warunkach.
Pamiętaj, że identyfikator miejsca służący do jednoznacznej identyfikacji miejsca nie podlega ograniczeniami dotyczącymi pamięci podręcznej. Identyfikator miejsca jest zwracany w polu place_id w odpowiedziach pakietu SDK Miejsc na iOS. Więcej informacji o zapisywaniu i odświeżaniu identyfikatorów miejsc oraz zarządzaniu nimi znajdziesz w przewodniku na temat identyfikatorów miejsc.
Wyświetlanie wyników pakietu SDK Miejsc na iOS
Wyniki z pakietu SDK Miejsc dla systemu iOS można wyświetlić w Mapach Google lub bez mapy. Jeśli chcesz wyświetlać wyniki Places SDK na iOS na mapie, muszą one być wyświetlane na mapie Google. Nie wolno używać danych z pakietu Places SDK na iOS na mapie, która nie jest mapą Google.
wyświetlać logo i informacje o Google.
Jeśli Twoja aplikacja wyświetla dane w Mapach Google, zostanie uwzględnione logo Google, które nie może zostać zmienione. Aplikacje, które wyświetlają dane Google na tym samym ekranie co Mapa Google, nie muszą zawierać dodatkowych informacji o Google.
Jeśli Twoja aplikacja wyświetla dane na stronie lub w widoku, który nie zawiera też Map Google, musisz wyświetlić logo Google. Jeśli na przykład w aplikacji dane Google są wyświetlane na jednej karcie, a w Mapach Google z tymi danymi na innej, na pierwszej karcie musi być widoczne logo Google. Jeśli aplikacja używa pól wyszukiwania z autouzupełnianiem lub bez niego, logo musi być wyświetlane w linii.
Logo Google powinno znajdować się w lewym dolnym rogu mapy, a informacje o autorze – w prawym dolnym rogu. Oba elementy powinny być umieszczone na mapie, która jest prezentowana jako całość, a nie pod mapą ani w innym miejscu w aplikacji. Na przykładowej mapie logo Google znajduje się w lewym dolnym rogu, a w prawym dolnym rogu – informacja o źródle.
| Do użytku na jasnym tle | Do użytku na ciemnym tle |
|---|---|
|
|
Ten plik ZIP zawiera logo Google w odpowiednich rozmiarach na potrzeby aplikacji na komputery, urządzenia z Androidem i iOS. Nie można zmieniać rozmiaru ani modyfikować tych logo w żaden sposób.
Pobierz: google_logo.zip
Nie modyfikuj atrybucji. Nie wolno usuwać, zasłaniać ani przycinać informacji dotyczących atrybucji. Nie możesz używać logo Google w tekście (np. „Te mapy pochodzą z [Google_logo]”).
Utrzymuj atrybucję w pobliżu. Jeśli używasz zrzutów ekranu obrazów Google poza bezpośrednim umieszczeniem, dodaj standardowe informacje o źródle, które są widoczne na obrazie. W razie potrzeby możesz dostosować styl i miejsce umieszczenia tekstu z podziękowaniem, o ile tekst znajduje się w pobliżu treści i jest czytelny dla przeciętnego widza lub czytelnika. Nie możesz przenieść informacji o źródle poza treści, np. do końca książki, informacji o treściach w plikach lub programie albo stopki witryny.
Uwzględnij zewnętrznych dostawców danych. Niektóre dane i obrazy w naszych usługach mapowania pochodzą od innych dostawców niż Google. Jeśli używasz takich obrazów, tekst informacji o autorze musi zawierać nazwę „Google” oraz nazwę odpowiedniego dostawcy danych, np. „Dane map: Google, Maxar Technologies”. Jeśli w związku ze zdjęciami są wymienieni zewnętrzni dostawcy danych, podanie tylko nazwy „Google” lub logo Google nie jest prawidłowym przypisaniem autorstwa.
Jeśli korzystasz z Google Maps Platform na urządzeniu, na którym wyświetlanie informacji o pochodzeniu nie jest praktyczne, skontaktuj się z zespołem handlowym Google, aby omówić licencje odpowiednie do Twojego przypadku użycia.
Inne wymagania dotyczące atrybucji
Informacje o dostawcach zewnętrznych zawierają treści i linki, które musisz wyświetlić użytkownikowi w takim formacie, w jakim zostały one przekazane. Google zaleca, aby aplikacja wyświetlała te informacje pod szczegółami miejsca.
Atrybucja zewnętrzna zwracana przez interfejs API nie zawiera atrybucji Google. Informacje o autorze musisz dodać samodzielnie zgodnie z opisem w sekcji Wyświetlanie logo i informacji o autorze Google.
Aby pobrać atrybucję pochodzącą od osoby trzeciej dla pojedynczego miejsca lub grupy miejsc, postępuj zgodnie z tymi instrukcjami.
Pobieranie danych o przypisaniu do pojedynczego miejsca
Jeśli pobierzesz miejsce, uzyskując jego identyfikator, możesz pobrać jego źródło z usługi attributions na stronie GMSPlace.
attributions są udostępniane jako obiekt NSAttributedString.
Pobieranie atrybucji w przypadku kolekcji miejsc
Jeśli aplikacja wyświetla informacje uzyskane przez wysłanie żądania o bieżące miejsce, musi wyświetlić informacje o źródłach danych zewnętrznych dotyczących wyświetlanych szczegółów miejsca. Atrybucja wszystkich miejsc pobranych w żądaniu możesz pobrać z usługi attributions na stronie
GMSPlaceLikelihoodList.
attributions są udostępniane jako obiekt NSAttributedString, do którego możesz uzyskać dostęp i wyświetlić go w ten sam sposób, w jaki wyświetlasz attributions w jednym miejscu, jak opisano wyżej.
Atrybucja w wynikach wyszukiwania
W Europie, gdy korzystasz z niemodyfikowanego rankingu Google, produkty wyszukiwania muszą mieć tekst wyjaśniający, który jest dostępny maksymalnie w 1 kliknięciu i opisuje główne czynniki oraz ich wagę w określaniu pozycji w wynikach wyszukiwania. Tekst wyjaśniający:
Header: About these results
Body: 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: dowiedz się więcej
Tekst „Dowiedz się więcej” powinien zawierać link do artykułu w Centrum pomocy.
Przycisk 2: OK
Wyświetlanie informacji o źródle zdjęcia
Jeśli Twoja aplikacja wyświetla zdjęcia, musisz pokazać dowolne wartości attributions i authorAttributions dla każdego zdjęcia, które je zawiera.
- Aby uzyskać dostęp do atrybucji, użyj wartości
GMSPlacePhotoMetadata.attributions. Ta usługa toNSAttributedStringlubnil, jeśli nie ma żadnych atrybucji do wyświetlenia. - Aby uzyskać dostęp do informacji o autorze, skorzystaj z narzędzia
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ć do 5 opinii, z których każda jest reprezentowana przez obiekt GMSPlaceReview. Możesz opcjonalnie wyświetlać te opinie w aplikacji.
Przy wyświetlaniu opinii przesłanych przez użytkowników Google musisz umieścić nazwisko autora w pobliżu. Jeśli w polu atrybucji autora obiektu GMSPlaceReview jest dostępne, zalecamy dodanie zdjęcia autora i linku do jego profilu. Na ilustracji widać przykład opinii na temat parku:
Google zaleca też wyświetlanie użytkownikom informacji o tym, jak są sortowane opinie.
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 firm zewnętrznych
Informacje o przypisach do zewnętrznych dostawców są podawane jako obiekty NSAttributedString, które zawierają treści i linki, które musisz zachować i wyświetlić użytkownikowi.
Zalecamy wyświetlanie informacji atrybucyjnych za pomocą elementu UITextView, ponieważ linki w tych informacjach muszą działać.
Aby mieć pewność, że linki działają, ustaw delegowanie na UITextView i ustaw metodę shouldInteractWithURL w funkcji UITextViewDelegate, aby zwracała wartość 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. Przykład:
Oferty firmy Przykładowa firma
W powyższym przykładzie zakres tekstowy Przykładowa firma jest objęty atrybutem NSLink.
Wytyczne dotyczące stylu na potrzeby atrybucji Google
Poniżej znajdziesz wskazówki dotyczące stylu atrybucji Google w arkuszach CSS i HTML, jeśli nie możesz użyć logo Google do pobrania.
Pusty obszar
Wielkość pustego obszaru wokół logo powinna być równa wysokości litery „G” w logo Google lub od niej większa.
Odstęp między tekstem dotyczącym atrybucji a logo Google powinien wynosić połowę szerokości litery „G”.
czytelność;
Podpis powinien zawsze być wyraźny i czytelny oraz mieć odpowiedni kolor na danym tle. Pamiętaj, aby wybrana przez Ciebie wersja logo miała wystarczający kontrast.
Kolor
Użyj tekstu Google Material Gray 700 na białym lub jasnym tle o zakresie 0%–40% maksymalnego odcienia czerni.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Na ciemniejszych tłach oraz na zdjęciach lub wzorach brak aktywności użyj białego tekstu jako autora i informacji o autorze.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Czcionka
Użyj czcionki Roboto.
Przykładowy kod CSS
Poniższy kod CSS zastosowany do tekstu „Google” spowoduje, że „Google” zostanie wyrenderowane z odpowiednim fontem, kolorem i odstępem na białym lub jasnym tle.
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;