Zasady i atrybucje dotyczące interfejsu Geocoding API

W tym dokumencie znajdziesz wymagania dotyczące aplikacji utworzonych za pomocą interfejsu Geocoding API. Pamiętaj, że korzystanie z interfejsu Geocoding API podlega warunkom umowy 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 pomogą Ci prawidłowo korzystać z usługi i spełniać oczekiwania 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 bezterminowo. Identyfikator miejsca jest zwracany w polu place_id w odpowiedziach interfejsu API. Więcej informacji o zapisywaniu i odświeżaniu identyfikatorów miejsc oraz zarządzaniu nimi znajdziesz w przewodniku po identyfikatorach miejsc.

Filtrowanie i zmiana kolejności po stronie klienta

Możesz przeprowadzić filtrowanie po stronie klienta na liście wyników najwyższego poziomu, np. usunąć wyniki adresów, które nie pasują do określonych kryteriów kraju lub kodu pocztowego. Możesz też filtrować lub zmieniać kolejność podlist zawartych w pojedynczym 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 pierwotnych danych zwracanych przez interfejs API.

Kraje i terytoria Europejskiego Obszaru Gospodarczego

W przypadku klientów, których adres rozliczeniowy znajduje się w Europejskim Obszarze Gospodarczym (EOG), ta usługa ma inne Warunki korzystania z usługi i może mieć inne funkcje. Zanim zaczniesz tworzyć rozwiązania za pomocą Google Maps Platform, zapoznaj się z tymi 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 drodze

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 usługi Google Maps Platform
• Szczegółowe 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 podania źródła i wytyczne dotyczące wyświetlania Map Google i treści z Map Google w aplikacjach.

Uwaga: w poniższych zaktualizowanych wymaganiach dotyczących podawania źródła używamy teraz nazwy „Mapy Google” zamiast „Google”. Zdajemy sobie sprawę, że Twoje dotychczasowe implementacje mogą używać atrybucji „Google” zgodnie z wcześniejszymi wskazówkami. Na razie możesz nadal używać atrybucji „Google”. W przypadku nowych implementacji użyj „Map Google”, jak opisano w tej sekcji. W przyszłości podamy harmonogramy i instrukcje, które pomogą Ci zmienić dotychczasowe atrybucje „Google” na atrybucje „Mapy Google”.

Wyświetlanie informacji o autorstwie w Mapach Google

Podczas wyświetlania treści z interfejsów API Google Maps Platform w aplikacji lub witrynie musisz przestrzegać wymagań dotyczących podania źródła Map 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ędniono atrybucję Map Google

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

• Nie usuwaj dołączonych informacji o autorstwie, niezależnie od tego, gdzie są wyświetlane. Nie zmieniaj, nie ukrywaj ani nie zasłaniaj informacji o autorze i upewnij się, że jest ona wyraźnie widoczna 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ść pustego miejsca.
• Wprowadzając zmiany wizualne, musisz przestrzegać wszystkich wymagań Google Maps dotyczących podawania źródła.

Logo Map Google i atrybucja tekstowa

Jeśli to możliwe, atrybucja powinna mieć formę logo Map Google. W przypadkach, gdy ilość miejsca jest ograniczona, dopuszczalny jest tekst Mapy Google. Użytkownicy muszą zawsze wiedzieć, które treści pochodzą z Map Google.

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

Atrybucja logo

Aby używać logo Map Google w aplikacji lub witrynie, musisz spełnić te wymagania.

Przykłady dopuszczalnych wersji atrybucji logo Map Google

Pobieranie logo Map Google

Używaj oficjalnych plików logo Map Google. Pobierz logo poniżej i postępuj zgodnie ze wskazówkami podanymi w tej sekcji.

Pobierz zasoby dotyczące atrybucji Map Google

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

• Nie modyfikuj logo w żaden sposób.
• Zachowaj format obrazu logo, aby uniknąć zniekształceń.
• Używaj logo z obramowaniem na szczegółowym tle, np. na mapie lub obrazie.
• Używaj logo bez obramowania na jednolitym tle, np. w jednolitym kolorze lub z delikatnym gradientem.

Specyfikacja rozmiaru logo

Logo Map Google musi być zgodne z tymi wytycznymi dotyczącymi rozmiaru:

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

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

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

Dostępność logo

Logo Map Google musi spełniać te wymagania dotyczące ułatwień dostępu:

• Zachowaj odpowiedni kontrast między logo a tłem.
• Dołącz etykietę ułatwień dostępu z tekstem Mapy Google.

Przykłady niedopuszczalnych odmian i problemów z dostępnością w przypadku atrybucji logo Map Google

Atrybucja tekstowa

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

Przykłady dopuszczalnych odmian atrybucji tekstowej Map Google

• Nie modyfikuj w żaden sposób tekstu Mapy Google:
  
  • Nie zmieniaj wielkości liter w nazwie Mapy Google.
  • Nie zawijaj nazwy Mapy Google do wielu 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".

Przykłady niedopuszczalnych odmian atrybucji tekstowej Map Google

• Tekst Map Google należy sformatować zgodnie z tabelą poniżej:

  Wymagania dotyczące stylizacji 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 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 dotyczące treści wizualnych

Postępuj zgodnie z tymi wymaganiami dotyczącymi wizualnego traktowania atrybucji Map Google.

• Umieść informacje o autorze w pobliżu góry lub dołu treści i w tym samym kontenerze wizualnym. W przypadku pojedynczego wiersza treści atrybucję można umieścić po prawej lub lewej stronie.

• 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ść pustego miejsca.

• Nie przedstawiaj Map Google w fałszywy sposób, przypisując im 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 pokazano przykłady tych wymagań wizualnych.

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

Przykłady 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 zdjęcia 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 podać wymagane informacje o autorze, które należy przypisać zewnętrznemu dostawcy danych. W takim przypadku tekst atrybucji musi zawierać nazwę „Mapy Google” i nazwy odpowiednich dostawców danych, np. „Dane mapy: Google, Maxar Technologies”. Gdy Google podaje informacje o źródle, które należy do innej firmy, podanie tylko „Map Google” lub logo Google nie jest prawidłowym podaniem źródła.

Podsumowania oparte na AI (miejsca docelowe)

Gdy wyświetlasz w aplikacji podsumowania oparte na AI zwrócone przez metodę SearchDestinations, musisz wykonać te czynności:

• Wyświetlaj wymagane informacje o autorze, linki do raportów i linki odsyłające zgodnie z definicją w tej sekcji.
• Upewnij się, że użytkownicy mogą przeczytać pełny tekst podsumowania dostarczony przez Google Maps Platform.

Wyświetlanie tekstu oświadczenia o podsumowaniach opartych na AI

Podczas wyświetlania podsumowania opartego na AI zawsze umieszczaj pod nim zlokalizowany tekst oświadczenia podany w polu odpowiedzi disclosureText. Nigdy nie modyfikuj ani nie rozszerzaj tekstu oświadczenia dostarczanego przez interfejs API.

Rysunek 1. Tekst z informacją o wykorzystaniu AI prawidłowo wyświetlany pod podsumowaniami wygenerowanymi przez AI.

Wymagania dotyczące podsumowania przyjazdu

Podsumowaniom przyjazdów wyświetlanym w aplikacji musi towarzyszyć ten tekst i wymagane linki:

Tekst	Wymaganie
Informacje o podsumowaniu	Użyj tego linku do artykułu „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 w polu flagContentUrl odpowiedzi, aby zgłosić Google problem z treścią podsumowania. Uwaga: podsumowania oparte na AI dostarczane przez Geocoding API podlegają zasadom Google dotyczącym treści i usług niezależnie od tego, gdzie się znajdujesz. 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ć, korzystając z podanego adresu URL do zgłaszania treści: flagContentUrl.

Ilustracja 2. Podsumowanie wygenerowane przez AI z wymaganymi powiązanymi linkami udostępnionymi użytkownikom w rozszerzonym menu.

Wyświetlanie wskazówek w przypadku zastosowań motoryzacyjnych

Ze względu na bezpieczeństwo kierowcy Google zaleca renderowanie podsumowań opartych na AI w trybie parkowania w przypadku aplikacji samochodowych. Jeśli podsumowania są renderowane w trybie prowadzenia samochodu, informacje na ekranie powinny być jasne i zwięzłe, aby kierowca mógł szybko skupić się na drodze:

• Maksymalnie 3 wiersze
• Maksymalnie 120 znaków lub 24 słowa
• Minimalny rozmiar czcionki: 24 dp

Szczególnie w przypadku zastosowań motoryzacyjnych deweloper jest odpowiedzialny za renderowanie podsumowań opartych na AI w sposób bezpieczny i zgodny ze wszystkimi lokalnymi przepisami i regulacjami prawnymi.