Zasady i atrybucje dotyczące interfejsu Geocoding API

Ten dokument zawiera listę wymagań dotyczących aplikacji opracowanych za pomocą interfejsu Geocoding API. Pamiętaj, że korzystanie z interfejsu Geocoding API podlega Twojej umowie z Google.

Zasady

W tej sekcji opisujemy zasady dotyczące interfejsu Geocoding API. Zasady zawierają praktyczne wytyczne 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ń 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 bez ograniczeń czasowych. Identyfikator miejsca jest zwracany w polu place_id w odpowiedziach API. Dowiedz się, jak zapisywać, odświeżać i zarządzać identyfikatorami miejsc w przewodniku po identyfikatorach miejsc.

Filtrowanie i zmiana kolejności po stronie klienta

Możesz filtrować po stronie klienta listę wyników najwyższego poziomu (np. usuwać wyniki adresów, które nie spełniają określonych kryteriów dotyczących kraju lub kodu pocztowego) oraz filtrować lub zmieniać kolejność podlist znajdujących się w ramach jednego wyniku (np. nadawać priorytet określonym punktom nawigacyjnym), o ile kryteria filtrowania lub zmiany kolejności nie wprowadzają użytkowników w błąd. Musisz zadbać o to, aby te modyfikacje nie zniekształcały oryginalnych danych zwracanych przez interfejs API.

Kraje i terytoria Europejskiego Obszaru Gospodarczego

Ten produkt 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:

• 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 drogach

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 platformy Mapy Google
• Dodatkowe 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 atrybucji i wytyczne dotyczące wyświetlania Map Google i treści w aplikacjach.

Uwaga: w zaktualizowanych wymaganiach dotyczących atrybucji używamy teraz nazwy „Mapy Google” zamiast „Google”. Zdajemy sobie sprawę, że w Twoich dotychczasowych wdrożeniach może być używana atrybucja „Google” zgodnie z wcześniejszymi wskazówkami. Na razie możesz nadal używać „Google” jako atrybucji. W przypadku nowych implementacji używaj opcji „Mapy Google” zgodnie z opisem w tej sekcji. W przyszłości udostępnimy harmonogramy i instrukcje, które pomogą Ci przekształcić istniejące atrybucje „Google” w atrybucje „Mapy Google”.

Wyświetlanie informacji o autorstwie Map Google

Wyświetlając w aplikacji lub witrynie treści z interfejsów API Google Maps Platform, 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.

Uwzględnienie atrybucji 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 wskazówek interfejsu, takich jak obramowanie, kolor tła, cień lub wystarczająca ilość wolnego miejsca.
• Wprowadzając zmiany wizualne, musisz przestrzegać wszystkich wymagań dotyczących atrybucji w Mapach Google.

Logo Map Google i atrybucja tekstowa

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

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

Atrybucja logo

Podczas używania logo Map Google w aplikacji lub witrynie postępuj zgodnie z tymi wymaganiami.

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.

Pobierz zasoby dotyczące atrybucji Map Google

Używając logo Map Google, postępuj zgodnie z tymi wytycznymi.

• Nie modyfikuj logo w żaden sposób.
• Zachowaj format obrazu logo, aby zapobiec zniekształceniu.
• Używaj logo z obramowaniem na tle z wieloma elementami, np. na mapie lub obrazie.
• Używaj logo bez obramowania na prostym tle, np. jednolitym kolorze lub subtelnym gradiencie.

Specyfikacja rozmiaru logo

Przestrzegaj tych specyfikacji rozmiaru logo Map Google:

• Minimalna wysokość logo: 16 dp
• Maksymalna wysokość logo: 19 dp
• Minimalny pusty obszar wokół logo: 10 dp po lewej, prawej i górnej stronie, 5 dp u dołu

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

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

Dostępność logo

Przestrzegaj tych wymagań dotyczących ułatwień dostępu w przypadku logo Map Google:

• Zachowaj dostępny kontrast między logo a tłem.
• Dodaj etykietę ułatwień dostępu z tekstem Mapy 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:

Przykłady akceptowanych 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.
  • Zablokuj przeglądarkom możliwość tłumaczenia Map Google, używając atrybutu HTML translate="no".

Przykłady niedopuszczalnych wariantów atrybucji tekstowej Map Google

• Stylizuj tekst w Mapach Google zgodnie z opisem w tej tabeli:

  Wymagania dotyczące stylu tekstu w Mapach Google
  Właściwość	Styl
  Rodzina czcionek	Roboto. Wczytywanie czcionki jest opcjonalne.
  Rodzina czcionek rezerwowych	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 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 odpowiednia 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 tych informacji.

Na ilustracjach poniżej pokazano przykłady tych wymagań wizualnych.

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

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 mapowych 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 „Mapy Google” lub logo Google nie jest odpowiednim sposobem podania informacji o źródle.

Podsumowania oparte na AI

Gdy wyświetlasz w aplikacji podsumowania oparte na AI, musisz:

• Wyświetlaj wymagane atrybucje, linki do raportowania i linki odsyłające zgodnie z opisem poniżej.
• Użytkownicy muszą mieć możliwość odczytania pełnego tekstu podsumowania w formie, w jakiej jest on udostępniany przez Google Maps Platform.

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

Gdy wyświetlasz podsumowanie wygenerowane przez AI, zawsze umieszczaj zlokalizowany tekst informacji (podany w polu disclosure_text w treści odpowiedzi) bezpośrednio pod podsumowaniem. Nigdy nie modyfikuj ani nie rozszerzaj tekstu informacji udostępnianego przez interfejs API.

Rysunek 1. Tekst z informacją wyświetlany prawidłowo pod podsumowaniami opartymi na AI.

Wymagania dotyczące podsumowania przyjazdu

Podsumowania przyjazdu 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 lokalnych”: https://support.google.com/local-listings/answer/9851099
Zgłoś podsumowanie	Użyj linku zawartego w polu flag_content_url odpowiedzi, aby zgłosić Google problem dotyczący treści podsumowania. Uwaga: podsumowania oparte na AI udostępniane przez Geocoding API podlegają zasadom Google dotyczącym treści i usług w każdym miejscu na ś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 (flag_content_url).

Rysunek 2. Podsumowanie oparte na AI z wymaganymi powiązanymi linkami udostępnianymi użytkownikom za pomocą menu dodatkowego.

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 deweloper jest odpowiedzialny za renderowanie podsumowań opartych na AI w sposób bezpieczny i zgodny ze wszystkimi lokalnymi przepisami i regulacjami prawnymi.