Zasady i informacje o atrybucji dotyczące interfejsu Places API

W tym dokumencie znajdziesz wymagania dotyczące wszystkich aplikacji opracowanych za pomocą interfejsu Places API (nowego), w tym usługi Autocomplete (nowej), która jest częścią tego interfejsu API. Bardziej ogólne informacje dla deweloperów korzystających z Map Google znajdziesz w Warunkach korzystania z usługi Google Maps Platform.

Zasady

W tej sekcji opisujemy zasady dotyczące interfejsu Places API. Zasady zawierają praktyczne wskazówki i wymagania dotyczące wdrażania, które pomagają prawidłowo korzystać z Usługi zgodnie z oczekiwaniami Google Maps Platform.

Wyjątki od ograniczeń 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 bez ograniczeń czasowych. Identyfikator miejsca jest zwracany w polu place_id w odpowiedziach interfejsu API. Dowiedz się, jak zapisywać, odświeżać i zarządzać identyfikatorami miejsc w przewodniku po identyfikatorach miejsc.

Kraje i terytoria Europejskiego Obszaru Gospodarczego

Ta usługa ma inne Warunki korzystania z usługi dla klientów, których adres rozliczeniowy znajduje się w Europejskim Obszarze Gospodarczym (EOG). Może też mieć inną funkcjonalność. Zanim zaczniesz korzystać z Google Maps Platform, zapoznaj się z poniższymi warunkami i informacjami dotyczącymi Europejskiego Obszaru Gospodarczego:

Jeśli Twój adres rozliczeniowy nie znajduje się w Europejskim Obszarze Gospodarczym, obowiązują Cię te warunki korzystania z usługi:

Wymagania dotyczące podania źródła w Mapach Google

W tej sekcji znajdziesz wymagania dotyczące atrybucji i wytyczne dotyczące wyświetlania Map Google i treści w aplikacjach.

Wyświetlanie informacji o autorstwie Map Google

Wyświetlając w aplikacji lub witrynie treści z interfejsów Google Maps Platform API, musisz przestrzegać wymagań dotyczących atrybucji w Mapach 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.

Atrybucja Map Google

W przypadku atrybucji Map Google, która jest już udostępniana przez Google Maps Platform w interfejsie użytkownika, np. w Places UI Kit:

  • Nie usuwaj dołączonego atrybutu, niezależnie od tego, gdzie jest wyświetlany. Nie zmieniaj, nie ukrywaj ani nie zasłaniaj informacji o źródle. Upewnij się, że są one wyraźnie widoczne na tle.
  • Zawsze wizualnie odróżniaj Treści Google Maps Platform od innych treści, używając elementów interfejsu, takich jak obramowanie, kolor tła, cień lub odpowiednia ilość wolnego miejsca.
  • Wprowadzając zmiany wizualne, musisz przestrzegać wszystkich wymagań dotyczących atrybucji w Mapach Google.

W miarę możliwości atrybucja powinna mieć postać logo Map Google. W przypadku ograniczonej przestrzeni dopuszczalny jest tekst Mapy Google. Użytkownicy muszą zawsze wiedzieć, które treści są dostarczane przez Mapy Google.

Po lewej: atrybucja logo Map Google, po prawej: atrybucja tekstowa Map Google
Po lewej: przykład atrybucji logo Map Google, po prawej: przykład atrybucji tekstowej Map Google

Atrybucja logo

Aby używać logo Map Google w aplikacji lub witrynie, musisz spełniać te wymagania.
Dopuszczalne warianty atrybucji logo Map Google
Przykłady dopuszczalnych wariantów atrybucji logo Map Google

Pobieranie logo Map Google

Używaj oficjalnych plików z logo Map Google. Pobierz logo poniżej i postępuj zgodnie z wytycznymi w tej sekcji.

Pobieranie elementów atrybucji Map Google

Podczas korzystania z logo Map Google postępuj zgodnie z tymi wytycznymi.

  • Nie modyfikuj logo w żaden sposób.
  • Zachowaj format logo, aby uniknąć zniekształceń.
  • Używaj logo z konturem na tle z wieloma elementami, np. na mapie lub obrazie.
  • Używaj logo bez obramowania na prostym tle, np. jednolitym kolorze lub delikatnym gradiencie.

Specyfikacja rozmiaru logo

Logo Map Google musi spełniać te wymagania dotyczące rozmiaru:
  • Minimalna wysokość logo: 16 dp
  • Maksymalna wysokość logo: 19 dp
  • Minimalny pusty obszar wokół logo: 10 dp po lewej, prawej i u góry, 5 dp u dołu

Więcej informacji o dp znajdziesz w sekcji Gęstość pikseli na stronie Material Design.

Logo Map Google z minimalnym pustym obszarem i dopuszczalnym zakresem rozmiarów
Przykład logo Map Google z minimalnym pustym obszarem i dopuszczalnym zakresem rozmiarów

Dostępność logo

Logo Map Google musi spełniać te wymagania dotyczące ułatwień dostępu:
Niedopuszczalne odmiany i problemy z dostępnością w przypadku atrybucji logo Map Google
Przykłady niedopuszczalnych wariantów i problemów z dostępnością w przypadku atrybucji logo Map Google

Atrybucja tekstu

Jeśli rozmiar interfejsu nie pozwala na użycie logo Map Google, możesz wpisać Mapy Google. Skorzystaj z tych wskazówek:

Dopuszczalne warianty atrybucji tekstowej w Mapach Google
Przykłady dopuszczalnych wariantów atrybucji tekstowej Map Google
  • Nie modyfikuj w żaden sposób tekstu Mapy Google:
    • Nie zmieniaj wielkości liter w nazwie Mapy Google.
    • Nie dziel Map Google na kilka 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".
Niedopuszczalne warianty atrybucji tekstowej Map Google
Przykłady niedopuszczalnych wariantów atrybucji tekstowej Map Google
  • Stylizuj tekst w Mapach Google zgodnie z tabelą poniżej:

    Wymagania dotyczące stylu tekstu w Mapach Google
    Właściwość Styl
    Rodzina czcionek Roboto Wczytywanie czcionki jest opcjonalne.
    Zastępcza rodzina czcionek Dowolna czcionka bezszeryfowa używana już w Twoim produkcie 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) na tle.
    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 wizualne

Przestrzegaj tych wymagań dotyczących wizualnego sposobu podawania informacji o autorstwie w Mapach Google.
  • Atrybucja powinna znajdować się w pobliżu górnej lub dolnej części treści, w tym samym kontenerze wizualnym. W przypadku jednego wiersza treści atrybucja może być umieszczona po prawej lub lewej stronie.

  • Wizualnie odróżniaj Treści Google Maps Platform od innych treści, używając elementów interfejsu, takich jak obramowanie, kolor tła, cień lub wystarczająca ilość wolnego miejsca.

  • Nie wprowadzaj użytkowników w błąd co do Map Google, przypisując do nich 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 znajdziesz przykłady tych wymagań wizualnych.

Przykłady atrybucji Map Google umieszczonej u góry, u dołu i z boku treści
Przykład atrybucji Map Google umieszczonej u góry, u dołu i z boku treści

Przykład 2 sposobów odróżniania treści z Map Google (oceny miejsca) od innych treści
Przykład 2 sposobów na odróżnienie treści z Map Google (oceny miejsca) od innych treści

Nie zasłaniaj informacji o autorstwie Map Google ani nie mieszaj ich z treściami z innych źródeł.
Nie zasłaniaj atrybucji Map Google ani nie mieszaj jej z treściami z innych źródeł

zewnętrzni dostawcy danych,

Niektóre dane i obrazy 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 przekazać Ci wymagane informacje o autorstwie dostawcy danych zewnętrznych. W takim przypadku tekst atrybucji musi zawierać nazwę „Mapy Google” i nazwy odpowiednich dostawców danych, np. „Dane mapy: Google, Maxar Technologies”. Jeśli Google podaje informacje o źródle pochodzącym od innej firmy, samo podanie „Google Maps” lub logo Google nie jest odpowiednim sposobem podania informacji o źródle.

Dodatkowe wymagania dotyczące interfejsu Places API

Te wymagania dotyczą interfejsu Places API.

Autouzupełnianie adresów użytkowników

Jeśli użytkownik końcowy korzysta z funkcji autouzupełniania w Aplikacji Klienta, aby wpisać adres ulicy, a ten adres ulicy zostałby w pełni i dokładnie podany przez tego użytkownika końcowego bez autouzupełniania, wybrany przez niego adres nie podlega ograniczeniom dotyczącym treści w Mapach Google w Umowie Google Maps Platform. Ten wyjątek dotyczy tylko adresu wybranego przez użytkownika i wyłącznie w przypadku konkretnej transakcji tego użytkownika. Nie dotyczy listy sugerowanych adresów podawanych przez funkcję autouzupełniania ani innych treści Map Google. Ten wyjątek nie dotyczy żadnych funkcji wyszukiwania punktów POI ani adresów oferowanych przez inne usługi Google Maps Platform.

Autouzupełnianie adresu użytkownika

Lista adresów po lewej stronie nadal podlega ograniczeniom dotyczącym treści w Mapach Google. Gdy użytkownik wybierze adres, nie podlega on ograniczeniom dotyczącym treści w Mapach Google wyłącznie na potrzeby odpowiedniej transakcji tego użytkownika.

Zdjęcia i recenzje

Przypisywanie wszystkich treści do autora

Podczas wyświetlania zdjęć lub opinii musisz zawsze podawać autora. Każde zdjęcie i każda opinia zawierają atrybucję autora (zdjęcie profilowe, imię i nazwisko oraz link do profilu).

Wymagania wizualne dotyczące podania autora:

  • W miarę możliwości podaj autora, korzystając ze wszystkich dostępnych zasobów (awatar, imię i nazwisko oraz link do profilu).
  • W przypadku opinii, jeśli miejsce jest ograniczone, minimalnym wymaganiem jest wyświetlenie awatara autora.
  • W przypadku zdjęć, jeśli miejsce jest ograniczone (np. w galerii lub w przypadku miniatur), można pominąć atrybucję autora, pod warunkiem że użytkownik ma dostęp do większej wersji obrazu, która zawiera pełną atrybucję autora.
  • Umieść atrybucję autora w taki sposób, aby była wyraźnie powiązana ze zdjęciem lub opinią autora.
Informacje o autorze wyświetlane w lewym górnym rogu zdjęcia i opinii
Przykład atrybucji autora wyświetlanej w lewym górnym rogu zdjęcia i opinii

zapewniać bezpośredni dostęp do treści źródłowych w Mapach Google;

Użytkownicy końcowi muszą mieć zawsze dostęp do poszczególnych zdjęć źródłowych lub opinii w Mapach Google za pomocą podanego elementu googleMapsUri.

Menu pionowe z linkami do wyświetlenia zdjęcia źródłowego lub opinii w Mapach Google
Przykład menu pionowego z linkami do wyświetlenia zdjęcia źródłowego lub opinii w Mapach Google

Wyświetlanie względnej daty publikacji (np. „2 dni temu”) zdjęć i opinii przy użyciu podanej relativePublishTimeDescription zwiększa zaufanie użytkowników do treści.

Zdjęcia i opinie udostępniane za pomocą interfejsu Places API (nowego) i Places API (starszego) podlegają zasadom Google dotyczącym treści i usług w każdym miejscu na świecie. Ty i Twoi użytkownicy możecie zgłaszać treści, które Waszym zdaniem powinny zostać usunięte z usług Google zgodnie z naszymi zasadami lub obowiązującymi przepisami prawa, korzystając z ikony flagContentUri przy każdym zdjęciu i opinii. Treści można też zgłaszać, klikając bezpośredni link do nich w Mapach Google, gdzie również można zgłosić problem.

Opinie

Opis sposobu sortowania i filtrowania opinii

Umieść wyraźne powiadomienie opisujące sposób sortowania i filtrowania opinii, w tym wszelkie zastosowane kryteria wyszukiwania. Domyślnie opinie są uporządkowane według trafności.

Informacja o kolejności wyświetlania opinii
Przykład powiadomienia opisującego sposób sortowania opinii

Wyświetlanie miesiąca i roku, w którym recenzenci odwiedzili miejsca we Francji

Podczas wyświetlania opinii o miejscach we Francji i na terytoriach francuskich interfejs Places API zwraca visitDate (miesiąc i rok, w którym autor odwiedził to miejsce), które muszą być wyświetlane obok treści.

Data wizyty wyświetlana pod opinią użytkownika
Przykład daty wizyty wyświetlanej pod opinią użytkownika

Informuj użytkowników, że opinia została przetłumaczona z języka oryginału. Możesz zezwolić użytkownikom na wyświetlanie oryginalnego, nieprzetłumaczonego tekstuoriginalText. Mogą też kliknąć bezpośredni link do treści w Mapach Google, gdzie dostępny jest oryginalny, nieprzetłumaczony tekst.

Powiadomienie o tłumaczeniu wyświetlane pod opinią użytkownika
Przykład powiadomienia o tłumaczeniu wyświetlanego pod opinią użytkownika

Opinie i średnia ocena

Nie weryfikujemy opinii, ale staramy się wykrywać i usuwać fałszywe treści. Informuj użytkowników o zasadach Google dotyczących opinii, gdy wyświetlasz opinie i średnią ocenę. Więcej informacji o zasadach dotyczących treści użytkowników w Mapach Google

Przykład powiadomienia opisującego zasady Google dotyczące opinii
Przykład powiadomienia opisującego zasady Google dotyczące opinii

Podsumowania oparte na AI

Jeśli wyświetlasz w aplikacji podsumowania oparte na AI, w tym podsumowania miejsc, obszarów i opinii, musisz:

  • Wyświetlaj wymagane atrybucje, linki do raportów i linki odsyłające zgodnie z opisem poniżej.
  • Użytkownicy końcowi muszą mieć możliwość przeczytania pełnego tekstu podsumowania w formie udostępnionej przez Mapy Google.

Wyświetlanie tekstu oświadczenia dotyczącego podsumowań opartych na AI

Wyświetlając podsumowanie oparte na AI dowolnego typu, zawsze umieszczaj zlokalizowany tekst informacji (podany w polu disclosureText w treści odpowiedzi) bezpośrednio pod podsumowaniem. Nigdy nie modyfikuj ani nie rozszerzaj tekstu informacji udostępnianego przez interfejs API.

Informacje dotyczące wszystkich typów podsumowań generowanych przez AI
Tekst z informacjami wyświetlany prawidłowo pod każdym z 3 rodzajów podsumowań opartych na AI

Dodatkowe wymagania dotyczące podsumowania miejsca i obszaru

Podsumowania miejsc i obszarów wyświetlane w aplikacji muszą zawierać ten tekst i wymagane linki:

Tekst Wymaganie
Informacje o podsumowaniu Skorzystaj z tego linku, aby dowiedzieć się, „Jak Google pozyskuje i wykorzystuje informacje z wizytówek firm lokalnych”: https://support.google.com/local-listings/answer/9851099.
Zgłoś podsumowanie

Użyj linku zawartego w polu flagContentUri odpowiedzi, aby umożliwić zgłoszenie Google problemu dotyczącego treści podsumowania.

Uwaga: podsumowania oparte na AI udostępniane przez interfejs Places API (nowy) podlegają zasadom Google dotyczącym treści i usług na całym świecie. Musisz poinformować użytkowników, że jeśli chcą zgłosić treści, które powinny zostać usunięte z usług Google w świetle obowiązującego prawa, powinni to zrobić za pomocą podanego adresu URL do zgłaszania treści (flagContentUri).

Informacje o podsumowaniach miejsc i obszarów
Podsumowanie obszaru oparte na AI z wymaganymi powiązanymi linkami udostępnianymi użytkownikom za pomocą rozszerzonego menu

Wymagania dotyczące podsumowania opinii

Podsumowania opinii wyświetlane w aplikacji muszą być opatrzone nagłówkiem „Podsumowanie opinii”. Musisz też użyć tego tekstu i wymaganych linków:

Tekst Wymaganie
Informacje o podsumowaniu Skorzystaj z tego linku, aby dowiedzieć się, „jak Google pozyskuje i wykorzystuje informacje z wizytówek firm lokalnych”: https://support.google.com/local-listings/answer/9851099
Zgłoś podsumowanie

Użyj linku zawartego w polu flagContentUri w odpowiedzi.

Uwaga: podsumowania oparte na AI udostępniane przez interfejs Places API (nowy) podlegają zasadom Google dotyczącym treści i usług na całym świecie. Musisz poinformować użytkowników, że jeśli chcą zgłosić treści, które powinny zostać usunięte z usług Google w świetle obowiązującego prawa, powinni to zrobić za pomocą podanego adresu URL do zgłaszania treści (flagContentUri).

Zobacz opinie Użyj linku zawartego w polu reviewSummary.reviewsUri w odpowiedzi.
Informacje dotyczące podsumowań opinii
Podsumowanie opinii oparte na AI wyświetlane z wymaganymi powiązanymi linkami udostępnianymi użytkownikom za pomocą rozszerzonego menu

Wyświetlanie wskazówek dotyczących zastosowań w przypadku motoryzacji

Ze względu na bezpieczeństwo kierowcy Google zaleca renderowanie podsumowań opartych na AI w trybie parkowania w przypadku funkcji samochodowych. Jeśli podsumowania są renderowane w trybie jazdy, informacje na ekranie powinny być jasne i zwięzłe, aby kierowca mógł szybko wrócić do obserwowania drogi:

  • Maksymalnie 3 wiersze.
  • maksymalnie 120 znaków lub 24 słowa;
  • Minimalny rozmiar czcionki to 24 dp.

Szczególnie w przypadku zastosowań w motoryzacji obowiązkiem dewelopera jest renderowanie podsumowań opartych na AI w sposób bezpieczny i zgodny ze wszystkimi lokalnymi przepisami i regulacjami prawnymi.

Wyniki wyszukiwania miejsc

W ramach interakcji z użytkownikiem końcowym należy poinformować go o głównych czynnikach i ich wadze, które decydują o pozycji wyników wyszukiwania.

Jeśli używasz niezmodyfikowanego rankingu Google, możesz wyświetlać ten tekst wyjaśniający:

„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ę. Więcej informacji”.

Informacje o wynikach wyszukiwania miejsc
Okno dialogowe z opisem, jak Google określa pozycję wyników wyszukiwania

Zgodność z obowiązującymi przepisami

Musisz zawsze przestrzegać wszystkich obowiązujących przepisów prawa. Pamiętaj, że praktyki oznaczone w tych zasadach jako (zalecane) mogą być wymagane przez prawo. Ponadto przestrzeganie wszystkich podanych wymagań i zalecanych praktyk nie gwarantuje pełnej zgodności z przepisami prawa we wszystkich jurysdykcjach. Jeśli masz pytania dotyczące stanu zgodności, skonsultuj się z prawnikiem.