Ten dokument zawiera listę wymagań dotyczących wszystkich aplikacji opracowany przy użyciu pakietu SDK Miejsc na iOS, w tym funkcji autouzupełniania miejsc usługi będącej częścią tego interfejsu API. Bardziej ogólne informacje o Mapach Google programistów można znaleźć w Warunki korzystania z usługi Google Maps Platform
Udostępnianie warunków korzystania z usługi i polityki prywatności
Jeśli tworzysz aplikację Places SDK dla iOS, musisz udostępnić Warunki oraz Prywatność Zasady dotyczące aplikacji który jest zgodny z wytycznymi zawartymi w Umowie z Google:
- Warunki korzystania z usługi i Polityka prywatności muszą być dostępne publicznie i dostępności informacji.
- W Warunkach korzystania z aplikacji musisz wyraźnie określić, podczas korzystania z aplikacji, użytkownicy są zobowiązani Warunki korzystania z usług Google Usługa.
- Musisz powiadomić użytkowników w Polityce prywatności, że korzystasz interfejsów API Map Google i uwzględniać przez odniesienie Polityka prywatności Google.
Rekomendowane miejsce, w którym znajdziesz swoje Warunki korzystania z usługi i Polityka prywatności zależy od platformy aplikacji.
Aplikacja mobilna
Jeśli tworzysz aplikację mobilną, zalecamy podanie linku do Warunki korzystania z aplikacji i Polityka prywatności na stronie stronie pobierania w odpowiednim sklepie z aplikacjami oraz w ustawieniach aplikacji. .
Aplikacje internetowe
Jeśli tworzysz aplikację internetową, zalecamy podanie linku do Warunki korzystania z usługi i Politykę prywatności, które znajdziesz w stopce witryny.
Pobieranie z wyprzedzeniem, buforowanie lub przechowywanie treści
Aplikacje korzystające z pakietu SDK Miejsc dla systemu iOS podlegają warunkom Umowa z Google. Zgodnie z warunkami Umowy Użytkownik nie może pobierania z wyprzedzeniem, indeksowania, przechowywania ani buforowania jakiejkolwiek Treści, z wyjątkiem określonych w warunkach.
Pamiętaj, że identyfikator miejsca, używany do jednoznacznej identyfikacji miejsca, to nieobjęte ograniczeniami dotyczącymi buforowania. Identyfikator miejsca jest zwracany w polu „place_id” w Odpowiedzi 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 z pakietu SDK Miejsc dla systemu iOS
Wyniki z pakietu SDK Miejsc dla systemu iOS można wyświetlić w Mapach Google lub bez mapy. Jeśli chcesz wyświetlanie na mapie wyników z pakietu SDK Miejsc dla iOS, należy je wyświetlić w Mapach Google. Nie można używać pakietu Places SDK dla danych iOS na mapie, która nie jest mapą Google.
Wyświetlanie logo i informacji o autorze Google
Jeśli aplikacja wyświetla dane na mapie Google, zostanie uwzględnione i nie można go zmieniać. Aplikacje, które wyświetlają dane Google na tym samym ekranie, co Mapa Google, nie są wymagane do dalszego przypisywania autorstwa Google.
Jeśli aplikacja wyświetla dane na stronie lub w widoku, które nie wyświetla także Mapę Google, wraz z tymi danymi należy wyświetlić logo Google. Przykład: jeśli aplikacja wyświetla dane Google na jednej karcie, a na Mapie Google z tymi danymi na innej, na pierwszej musi być widoczne logo Google. Jeśli aplikacja używa z autouzupełnianiem lub bez niego, logo musi być wyświetlane w tekście.
Logo Google powinno znajdować się w lewym dolnym rogu mapy wraz z informacją o źródle widoczne w prawym dolnym rogu. Oba te elementy powinny znajdować się na mapie przedstawiane w całości, a nie pod mapą czy innym miejscem w aplikacji. Na poniższej przykładowej mapie w lewym dolnym rogu znajduje się logo Google w prawym dolnym rogu.
![miejsce docelowe atrybucji zasad](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/policies_attribution_placement.png?authuser=19&hl=pl)
Do użytku na jasnym tle | Do użytku na ciemnym tle |
---|---|
![]() |
![]() |
Poniższy plik ZIP zawiera logo Google w odpowiednim rozmiarze na komputerach oraz w aplikacjach na Androida i iOS. Nie możesz zmienić ich rozmiaru ani zmienić ich rozmiaru logo.
Pobierz: google_logo.zip
Nie modyfikuj atrybucji. Nie usuwaj, nie zasłaniaj ani nie wycinaj informacji o autorze i informacjami o nich. Nie można używać w tekście logo Google (na przykład „Te mapy są przeznaczone z [Google_logo]”).
Zadbaj o to, aby informacje o atrybucji były jak najbardziej trafne. Jeśli używasz zrzutów ekranu ze zdjęciami Google poza umieszczanie bezpośrednie, należy dołączyć standardowe źródło w takiej postaci, w jakiej jest widoczne na obrazie. W razie potrzeby: możesz dostosować styl i położenie tekstu źródła, o ile znajdować się w pobliżu treści i być czytelne dla przeciętnego widza lub czytelnika. Nie można przenosić informacji o pochodzeniu danych poza treść, na przykład na koniec książki, informacje o autorach plików lub programu albo stopkę witryny.
Uwzględnij zewnętrznych dostawców danych. Niektóre dane i zdjęcia na mapach produkty pochodzą od dostawców innych niż Google. W przypadku korzystania z takich zdjęć tekst źródło danych musi zawierać nazwę „Google” oraz odpowiednich dostawców danych, takich jak „Dane map: Google, Maxar Technologies”. Gdy są cytowani zewnętrzni dostawcy danych ze zdjęciami, w tym tylko nazwa „Google” lub logo Google nie jest prawidłowym oznaczeniem.
Jeśli korzystasz z Google Maps Platform na urządzeniu, na którym wyświetlanie atrybucji nie jest praktyczne, skontaktuj się z zespołem sprzedaży Google, aby omówić licencje odpowiednie do Twojego zastosowania.
Inne wymagania dotyczące atrybucji
Źródła danych o dostawcach zewnętrznych zawierają treści i linki, które zostały przez Ciebie muszą być wyświetlane użytkownikowi w formacie, w jakim zostały przekazane. Google zaleca, aby aplikacja wyświetlała te informacje pod szczegółami miejsca.
Zewnętrzne atrybucje zwrócone przez interfejs API nie uwzględnia atrybucji Google. Musisz samodzielnie umieścić tę informację o pochodzeniu danych, tak jak to opisano Wyświetlanie logo Google i informacji o źródłach.
Wykonaj te instrukcje, aby pobrać atrybucję w przypadku pojedynczej witryny miejsca lub zbioru miejsc.
Pobieranie informacji o autorze utworu
Jeśli pobierzesz miejsce, uzyskasz
według identyfikatora,
można pobrać informacje o tym miejscu z
Usługa attributions
włączona
GMSPlace
attributions
są podawane jako
NSAttributedString
obiekt.
Pobieranie informacji o autorach kolekcji miejsc
Jeśli aplikacja wyświetla informacje uzyskane po przesłaniu żądania
aktualne miejsce, aplikacja musi wyświetlać
atrybucje innych firm dotyczące wyświetlanych informacji o danym miejscu. Możesz pobrać
atrybucje wszystkich miejsc pobranych w żądaniu, od
Usługa attributions
jest włączona
GMSPlaceLikelihoodList
.
attributions
są udostępniane jako
NSAttributedString
obiekt, do którego możesz uzyskać dostęp i który możesz wyświetlić
tak samo jak attributions
w jednym miejscu, zgodnie z opisem
powyżej.
Wyświetlanie informacji o autorze zdjęcia
Jeśli aplikacja się wyświetla
zdjęcia, musisz
pokaż dowolne wartości attributions
i authorAttributions
dla każdej
zdjęcia, na których są widoczne.
- Aby uzyskać dostęp do atrybucji, użyj opcji
GMSPlacePhotoMetadata.attributions
Ta właściwość toNSAttributedString
lubnil
, jeśli brak atrybucji do wyświetlenia. - Aby uzyskać dostęp do informacji o autorze, użyj funkcji
GMSPlacePhotoMetadata.authorAttributions
Ta właściwość zawiera tablicęGMSPlaceAuthorAttribution
. obiektów.
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świetl opinię
Obiekt GMSPlace
może zawierać do 5 opinii, z których każda
jest reprezentowana przez obiekt GMSPlaceReview
. Dostępne opcje
(opcjonalnie) wyświetlanie opinii w aplikacji.
Aby wyświetlać opinie przesłane przez użytkowników Google, musisz umieścić atrybut
nazwisko autora. Jeśli jest dostępny w polu informacji o autorze
obiektu GMSPlaceReview
, zalecamy podanie adresu autora
i link do jej profilu. Poniższa grafika przedstawia przykład
opinii o parku:
Google zaleca również wyświetlanie sposobu sortowania opinii według kategorii użytkownika końcowego.
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. } }];
Sieć reklamowa – atrybucje zewnętrzne
Źródła danych o dostawcach zewnętrznych są podawane jako obiekty NSAttributedString
, które
zawierają treści i linki, które należy zachować i wyświetlić użytkownikowi.
Zalecanym sposobem wyświetlania atrybucji jest użycie atrybutu UITextView
, ponieważ linki w nich muszą działać.
Aby linki działały, ustaw przedstawiciela na UITextView
i ustaw shouldInteractWithURL
metody UITextViewDelegate
, która zwróci 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 innej firmy
Atrybucja firm zewnętrznych zazwyczaj składa się z tekstu i linku. Dla: przykład:
Informacje o firmie Przykładowa firma
W powyższym przykładzie zakres tekstowy Przykładowa firma jest objęty zakresem tekstowym
atrybut NSLink
.
Wytyczne dotyczące stylu na potrzeby atrybucji Google
Poniżej znajdziesz wskazówki dotyczące stylu atrybucji Google w CSS i HTML, jeśli nie możesz za pomocą dostępne do pobrania logo Google.
Pusty obszar
Wielkość pustego obszaru wokół logo powinna być równa wysokości lub większa. litery „G” w Google.
Odległość między tekstem informacji o źródle a logo Google powinna być o połowę szerokości literę „G”.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/policies_spacing.png?authuser=19&hl=pl)
Czytelność
Podpis powinien zawsze być wyraźny i czytelny oraz pojawiać się w odpowiedniej wersji kolorystycznej danego kontekstu. Zawsze zadbaj o odpowiedni kontrast dla odmiany wybierz opcję.
Kolor
Użyj tekstu Google Material Gray 700 na białym lub jasnym tle o zakresie 0–40% maksymalny odcień czerni.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Na ciemniejszych tłach oraz na fotografiach i wzorach braku aktywności użyj białego tekstu do umieszczenia informacji o autorze o pochodzeniu danych.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Czcionka
Należy użyć funkcji Czcionka Roboto.
Przykładowy arkusz CSS
Poniższy kod CSS zastosowany do tekstu „Google” wyrenderowałaby „Google” z odpowiednim czcionkę, kolor i odstępy 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;