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 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. W związku z tym 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.

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:

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

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 końcowi 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: logo Map Google z informacją o autorze, po prawej: tekst z informacją o autorze Map Google

Atrybucja logo

Podczas używania logo Map Google w aplikacji lub witrynie postępuj zgodnie z tymi wymaganiami.
Dopuszczalne warianty atrybucji logo Map Google
Dopuszczalne warianty 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 w Mapach 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 uniknąć zniekształcenia.
  • 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.

Logo Map Google z minimalnym pustym obszarem i dopuszczalnym zakresem rozmiarów
Logo Map Google z minimalną przestrzenią i dopuszczalnym zakresem rozmiarów

Dostępność logo

Przestrzegaj tych wymagań dotyczących ułatwień dostępu w przypadku logo Map Google:
  • Zachowaj kontrast dostępny między logo a tłem.
  • Dołącz etykietę ułatwień dostępu z tekstem Mapy Google.
Niedopuszczalne warianty i problemy z dostępnością atrybucji logo Map Google
Niedopuszczalne warianty i problemy 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
Dopuszczalne warianty tekstu atrybucji 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".
Niedopuszczalne odmiany tekstu atrybucji Map Google
Niedopuszczalne warianty tekstu z informacją o autorstwie w Mapach 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 zastępczych 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 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 artykule 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

Postępuj zgodnie z tymi wymaganiami dotyczącymi 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 atrybucji Map Google umieszczonej u góry, u dołu i z boku treści

Przykład 3 sposobów odróżniania treści z Map Google (oceny miejsca) od innych treści
Przykład 3 sposobów odróżniania 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 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 uwzględnienie „Map Google” lub logo Google nie jest odpowiednim podaniem 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 udostępnionej przez Google Maps Platform.

Wyświetlanie tekstu informacyjnego o podsumowaniach opartych na AI

Wyświetlając podsumowanie wygenerowane przez AI, zawsze umieszczaj tekst informacji w lokalnym języku (podany w polu disclosure_text w treści odpowiedzi) bezpośrednio pod podsumowaniem. Nigdy nie modyfikuj ani nie rozszerzaj tekstu informacji podanego przez interfejs API.

Podsumowanie oparte na AI z tekstem informacyjnym
Rysunek 1. Tekst informacyjny 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).

Podsumowanie oparte na AI z wymaganymi linkami
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 prawa i regulacjami.