Zasady dotyczące pakietu Miejsca SDK na iOS

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.

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.

policy attribution placement

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.

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:

Wyświetlanie informacji o autorze

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.

Google
#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.

Google
#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;