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 implementacji, 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 jednoznacznego identyfikowania miejsca,
nie podlega ograniczeniom dotyczącym buforowania.
Dlatego możesz przechowywać wartości identyfikatorów miejsc przez nieograniczony czas.
Identyfikator miejsca jest zwracany w polu place_id w
odpowiedziach interfejsu API. Więcej informacji o zapisywaniu, odświeżaniu i zarządzaniu identyfikatorami miejsc znajdziesz w przewodniku po identyfikatorach miejsc.
Kraje i terytoria Europejskiego Obszaru Gospodarczego
W przypadku klientów, których adres rozliczeniowy znajduje się w Europejskim Obszarze Gospodarczym (EOG), obowiązują inne warunki korzystania z usługi, a usługa może też mieć inne funkcje. Zanim zaczniesz tworzyć aplikacje za pomocą Google Maps Platform, zapoznaj się z tymi informacjami i warunkami dotyczącymi EOG:
- Warunki korzystania z Google Maps Platform w Europejskim Obszarze Gospodarczym
- Szczegółowe warunki korzystania z 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:
Wymagania dotyczące atrybucji Map Google
W tej sekcji znajdziesz wymagania i wytyczne dotyczące atrybucji w przypadku wyświetlania Map Google i treści w aplikacjach.
Wyświetlanie atrybucji Map Google
Podczas wyświetlania treści z interfejsów Google Maps Platform API w aplikacji lub witrynie musisz przestrzegać wymagań dotyczących atrybucji Map Google. Jeśli treści są wyświetlane w Mapach Google, gdzie atrybucja jest już widoczna, nie musisz dodawać dodatkowej atrybucji.
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 atrybucji, niezależnie od tego, gdzie jest wyświetlana. Nie zmieniaj, nie ukrywaj ani nie zasłaniaj atrybucji. 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 elementów interfejsu takich jak obramowanie, kolor tła, cień lub wystarczająca ilość białego miejsca.
- Wprowadzając zmiany wizualne, musisz przestrzegać wszystkich wymagań dotyczących atrybucji Map Google.
Logo i tekst Map Google
Jeśli to możliwe, atrybucja powinna mieć postać logo Map Google. W przypadkach, gdy ilość miejsca jest ograniczona, dopuszczalny jest tekst Mapy Google. Użytkownicy końcowi muszą zawsze wiedzieć, które treści pochodzą z Map Google.
Atrybucja logo
Podczas używania logo Map Google w aplikacji lub witrynie postępuj zgodnie z tymi wymaganiami.
Pobieranie logo Map Google
Używaj oficjalnych plików logo Map Google. Pobierz logo poniżej i postępuj zgodnie z wytycznymi w tej sekcji.
Pobierz zasoby atrybucji Map GooglePodczas używania logo Map Google postępuj zgodnie z tymi wytycznymi.
- Nie modyfikuj logo w żaden sposób.
- Zachowaj proporcje 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. na jednolitym kolorze lub subtelnym gradiencie.
Specyfikacja rozmiaru logo
Podczas używania logo Map Google postępuj zgodnie z tymi specyfikacjami rozmiaru:- Minimalna wysokość logo: 16 dp
- Maksymalna wysokość logo: 19 dp
- Minimalny obszar wokół logo: 10 dp z lewej, prawej i górnej strony, 5 dp z dołu
Więcej informacji o dp znajdziesz na stronie Gęstość pikseli w witrynie Material Design.
Ułatwienia dostępu do logo
Podczas używania logo Map Google postępuj zgodnie z tymi wymaganiami dotyczącymi ułatwień dostępu:- Zachowaj kontrast między logo a tłem, który jest zgodny z zasadami ułatwień dostępu.
- Dodaj etykietę ułatwień dostępu z tekstem Mapy Google.
Atrybucja tekstowa
Jeśli rozmiar interfejsu nie pozwala na użycie logo Map Google, możesz wpisać tekst Mapy Google. Postępuj zgodnie z tymi wytycznymi:
- Nie modyfikuj tekstu Mapy Google w żaden sposób:
- Nie zmieniaj wielkości liter w tekście Mapy Google.
- Nie dziel tekstu Mapy Google na kilka wierszy.
- Nie tłumacz tekstu Mapy Google na inny język.
- Uniemożliwiaj przeglądarkom tłumaczenie tekstu Mapy Google za pomocą atrybutu HTML
translate="no".
Stylizuj tekst Map Google zgodnie z opisem w tej tabeli:
Wymagania dotyczące stylizacji tekstu Map Google Właściwość Styl Rodzina czcionek Roboto. Wczytywanie czcionki jest opcjonalne. Zapasowa rodzina czcionek Dowolna czcionka bezszeryfowa używana już w Twojej usłudze lub „Sans-Serif”, aby użyć domyślnej czcionki systemowej Styl czcionki Normalna Grubość czcionki 400 Kolor czcionki Biały, czarny (#1F1F1F) lub szary (#5E5E5E). Zachowaj kontrast zgodny z zasadami ułatwień dostępu (4,5:1) względem tła. Rozmiar czcionki Minimalny rozmiar czcionki: 12 sp
Maksymalny rozmiar czcionki: 16 sp
Więcej informacji o sp znajdziesz na stronie Jednostki rozmiaru czcionki w witrynie Material Design.Odstępy między literami Normalne
Przykładowy kod CSS
Ten 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
Podczas wizualnego traktowania atrybucji Map Google postępuj zgodnie z tymi wymaganiami.Umieść atrybucję u góry lub u dołu 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ść białego miejsca.
- Nie wprowadzaj w błąd użytkowników co do Map Google, przypisując im treści, które nie pochodzą z Google Maps Platform.
- Sprawdź, czy atrybucja jest zawsze widoczna i czytelna. Nigdy jej nie usuwaj, nie ukrywaj, nie zasłaniaj ani nie modyfikuj.
Na ilustracjach poniżej przedstawiono przykłady tych wymagań wizualnych.
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, np. Map Tiles API, możemy udostępnić Ci wymaganą atrybucję zewnętrznego dostawcy danych. W takim przypadku tekst atrybucji musi zawierać nazwę „Mapy Google” oraz nazwę odpowiedniego dostawcy lub dostawców danych, np. „Dane mapy: Google, Maxar Technologies”. Jeśli Google udostępnia atrybucję zewnętrznego dostawcy, samo uwzględnienie „Map Google” lub logo Google nie jest prawidłową atrybucją.
Podsumowania oparte na AI
Gdy wyświetlasz w aplikacji podsumowania oparte na AI, musisz:
- wyświetlać wymagane atrybucje, linki do zgłaszania i linki odsyłające zgodnie z opisem poniżej;
- umożliwiać użytkownikom końcowym odczytanie pełnego tekstu podsumowania w takiej postaci, w jakiej jest on udostępniany przez Google Maps Platform.
Wyświetlanie tekstu ujawnienia podsumowań opartych na AI
Podczas wyświetlania podsumowania opartego na AI zawsze umieszczaj bezpośrednio pod nim zlokalizowany tekst ujawnienia (podany w polu disclosure_text w treści odpowiedzi). Nigdy nie modyfikuj ani nie rozszerzaj tekstu ujawnienia udostępnianego przez interfejs API.
Wymagania dotyczące podsumowania przyjazdu
Podsumowania przyjazdu wyświetlane w aplikacji muszą zawierać 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 lokalnych": https://support.google.com/local-listings/answer/9851099. |
| Zgłoś podsumowanie |
Użyj linku zawartego w polu Uwaga: podsumowania oparte na AI udostępniane przez interfejs Geocoding API podlegają zasadom Google dotyczącym treści i usług w dowolnym miejscu na świecie. Musisz poinformować użytkowników końcowych, ż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 zgłoszenia treści ( |
Wyświetlanie wskazówek dotyczących zastosowań w motoryzacji
Ze względu na bezpieczeństwo kierowcy Google zaleca renderowanie podsumowań opartych na AI w trybie parkowania w przypadku zastosowań w motoryzacji. Jeśli renderujesz podsumowania w trybie jazdy, informacje wyświetlane 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: 24 dp.
Szczególnie w kontekście motoryzacyjnym to deweloper jest odpowiedzialny za renderowanie podsumowań opartych na AI w sposób bezpieczny i zgodny ze wszystkimi lokalnymi przepisami i regulacjami.