W tym dokumencie znajdziesz listę wymagań dotyczących wszystkich aplikacji opracowanych za pomocą interfejsu Places API, w tym usługi autouzupełniania miejsc, która jest częścią tego interfejsu API. Więcej ogólnych informacji dla deweloperów Map Google można znaleźć w Warunkach korzystania z Google Maps Platform.
Podanie warunków korzystania z usługi i polityki prywatności
Jeśli tworzysz aplikację korzystającą z interfejsu Places API, musisz udostępnić Warunki korzystania z aplikacji oraz Politykę prywatności zgodne z wytycznymi opisanymi w umowie z Google:
- Warunki korzystania z usługi i Polityka prywatności muszą być publicznie dostępne.
- W Warunkach korzystania z aplikacji musisz wyraźnie stwierdzić, że korzystanie z aplikacji jest równoznaczne z zaakceptowaniem Warunków korzystania z usługi Google.
- W Polityce prywatności musisz poinformować użytkowników, że używasz interfejsów API Map Google, i załączyć Politykę prywatności Google.
Miejsce, w którym zalecamy udostępnienie Warunków korzystania z usługi i Polityki prywatności, zależy od platformy aplikacji.
Aplikacja mobilna
Jeśli tworzysz aplikację mobilną, zalecamy umieszczenie linku do Warunków korzystania z usługi i Polityki prywatności na stronie pobierania aplikacji w odpowiednim sklepie z aplikacjami oraz w menu ustawień aplikacji.
Aplikacje internetowe
Jeśli tworzysz aplikację internetową, zalecamy umieszczenie w stopce witryny linku do Warunków korzystania z usługi i Polityki prywatności.
pobieranie w ramach wstępnego pobierania, przechowywania w pamięci podręcznej lub przechowywania treści;
Aplikacje korzystające z interfejsu Places API są objęte warunkami umowy z Google. Zgodnie z warunkami Umowy nie wolno Ci pobierać wstępnie, indeksować, przechowywać ani przechowywać w pamięci podręcznej żadnych Treści, z wyjątkiem ograniczonych warunków określonych w Warunkach.
Pamiętaj, że identyfikator miejsca służący do jednoznacznej identyfikacji miejsca nie podlega ograniczeniami dotyczącymi pamięci podręcznej. Identyfikator miejsca jest zwracany w polu place_id w odpowiedziach interfejsu Places API. Więcej informacji o zapisywaniu, odświeżaniu i zarządzaniu identyfikatorami miejsc znajdziesz w przewodniku po identyfikatorach miejsc.
Wyświetlanie wyników interfejsu Places API
Wyniki interfejsu Places API możesz wyświetlać na mapie Google lub bez mapy. Jeśli chcesz wyświetlać wyniki interfejsu Places API na mapie, muszą one być wyświetlane na mapie Google. Nie wolno używać danych interfejsu Places API na mapie, która nie jest mapą Google.
wyświetlać logo i informacje o Google.
Jeśli aplikacja wyświetla dane na mapie Google, logo Google będzie widoczne i nie można go zmienić. Aplikacje, które wyświetlają dane Google na tym samym ekranie co mapa Google, nie muszą zawierać dodatkowych informacji o Google.
Jeśli Twoja aplikacja wyświetla dane na stronie lub w widoku, który nie zawiera też Map Google, musisz wyświetlić logo Google. Jeśli na przykład aplikacja wyświetla dane Google na jednej karcie, a Mapy Google z tymi danymi na drugiej, na pierwszej karcie musi być widoczne logo Google. Jeśli aplikacja używa pól wyszukiwania z autouzupełnianiem lub bez niego, logo musi być wyświetlane w linii.
Logo Google powinno znajdować się w lewym dolnym rogu mapy, a informacje o autorze – w prawym dolnym rogu. Oba te elementy powinny być prezentowane jako całość, a nie pod mapą ani w innym miejscu w aplikacji. Na przykładowej mapie logo Google znajduje się w lewym dolnym rogu, a w prawym dolnym rogu – informacja o źródle.
| Do użytku na jasnym tle | Do użycia na ciemnym tle |
|---|---|
|
|
Ten plik ZIP zawiera logo Google w odpowiednich rozmiarach na potrzeby aplikacji na komputery, urządzenia z Androidem i iOS. Nie możesz zmieniać rozmiaru ani modyfikować tych logotypów w żaden sposób.
Pobierz: google_logo.zip
Nie modyfikuj atrybucji. Nie wolno usuwać, zasłaniać ani przycinać informacji o pochodzeniu. Nie możesz używać logo Google w tekście (np. „Te mapy pochodzą z [Google_logo]”).
Utrzymuj atrybucję w pobliżu. Jeśli używasz zrzutów ekranu z obrazami Google poza bezpośrednim umieszczeniem, dodaj standardowe informacje o źródle, które są widoczne na obrazie. W razie potrzeby możesz dostosować styl i miejsce umieszczenia tekstu z podziękowaniem, o ile tekst znajduje się w pobliżu treści i jest czytelny dla przeciętnego widza lub czytelnika. Nie możesz przenieść informacji o źródle poza treści, np. do końca książki, informacji o treściach w plikach lub programie albo stopki witryny.
Uwzględnij zewnętrznych dostawców danych. Niektóre dane i obrazy w naszych usługach mapowania pochodzą od innych dostawców niż Google. Jeśli używasz takich obrazów, tekst informacji o autorze musi zawierać nazwę „Google” oraz nazwę odpowiedniego dostawcy danych, np. „Dane map: Google, Maxar Technologies”. Jeśli w związku ze zdjęciami są wymienieni zewnętrzni dostawcy danych, podanie tylko nazwy „Google” lub logo Google nie jest prawidłowym przypisaniem autorstwa.
Jeśli używasz Google Maps Platform na urządzeniu, na którym wyświetlanie informacji o pochodzeniu nie jest praktyczne, skontaktuj się z zespołem handlowym Google, aby omówić licencje odpowiednie do Twojego przypadku użycia.
Inne wymagania dotyczące atrybucji
Aby pobrać atrybucję pochodzącą od osoby trzeciej i wyświetlić ją w aplikacji, wykonaj podane niżej instrukcje.
Pobieranie atrybucji z miejsca
Jeśli aplikacja wyświetla informacje uzyskane przez wywołanie szczegółów miejsca z identyfikatorem miejsca, musi też wyświetlać informacje o atrybucji pochodzące od innych firm.
Atrybuty w obiekcie Place odpowiedzi są reprezentowane przez obiekt Attribution. Aby dodać Attribution do odpowiedzi, w polu maski żądania uwzględnij places.attributions (wyszukiwanie w pobliżu i wyszukiwanie tekstowe) lub attributions (szczegóły miejsca).
Pola obiektu Attribution to ciągi znaków zawierające atrybuty provider i providerUri, lub pusty ciąg znaków, jeśli nie ma atrybutów do wyświetlenia.
Wyświetlanie informacji o źródle zdjęcia
Jeśli Twoja aplikacja wyświetla zdjęcia, musisz podać informacje o autorze każdego zdjęcia.
Szczegóły dotyczące zdjęcia w obiekcie Place odpowiedzi znajdują się w tablicy photos. Aby dodać tablicę photos do odpowiedzi, w polu maski żądania podaj wartość places.photos (wyszukiwanie w pobliżu i wyszukiwanie tekstowe) lub photos (szczegóły miejsca).
Każdy element tablicy photos jest wystąpieniem typu Photo, która zawiera tablicę authorAttributions typu AuthorAttribution.
Pola obiektu AuthorAttribution to ciągi znaków zawierające atrybuty displayName, uri i photoUri, lub pusty ciąg znaków, jeśli nie ma atrybutów do wyświetlenia.
Wyświetlanie opinii
Obiekt Place w odpowiedzi może zawierać maksymalnie 5 opinii. Opcjonalnie możesz wyświetlać te opinie w aplikacji.
Podczas wyświetlania opinii przesłanych przez użytkowników Google musisz umieścić nazwę autora w pobliżu. Jeśli w polu atrybucji autora obiektu Review jest dostępne, zalecamy dodanie zdjęcia autora i połączenie go z jego profilem. Na tym obrazie widać przykład recenzji parku:
Google zaleca też wyświetlanie użytkownikom informacji o tym, jak są sortowane opinie.
Każda opinia w obiekcie Place odpowiedzi jest reprezentowana przez obiekt Review. Aby dodać obiekt Review do odpowiedzi, w polu maski żądania podaj wartość places.reviews (wyszukiwanie w pobliżu i wyszukiwanie tekstowe) lub reviews (szczegóły miejsca).
Pola obiektu Review zawierają atrybucję lub są puste, jeśli nie ma atrybucji do wyświetlenia.
Atrybucja wyników wyszukiwania
W Europie, gdy korzystasz z niemodyfikowanego rankingu Google, produkty wyszukiwania muszą mieć tekst wyjaśniający, który jest dostępny maksymalnie w 1 kliknięciu i opisuje główne czynniki oraz ich wagę w określaniu pozycji wyników wyszukiwania. Tekst wyjaśniający:
Nagłówek: informacje o wynikach
Treść: 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ę.
Przycisk 1: dowiedz się więcej
Tekst „Dowiedz się więcej” powinien zawierać link do artykułu w Centrum pomocy.
Przycisk 2: OK
Podsumowania generowane przez AI
Jeśli w swojej aplikacji wyświetlasz podsumowania generowane przez AI, w tym podsumowania miejsc, obszarów i opinii, musisz:
- Wyświetl wymagane atrybuty, linki do raportów i linki referencyjne zgodnie z opisem poniżej.
- Użytkownicy muszą mieć możliwość odczytania pełnego tekstu podsumowania, który jest udostępniany przez Mapy Google.
Wyświetlanie tekstu informacyjnego o podsumowaniach generowanych przez AI
Wyświetlając podsumowanie generowane przez AI dowolnego typu, zawsze dołącz zlokalizowany tekst informacji o zbieraniu danych (w polu disclosureText w tekstowej części odpowiedzi) bezpośrednio pod podsumowaniem. Nigdy nie modyfikuj ani nie rozszerzaj tekstu informacji o zbieraniu danych udostępnianego przez interfejs API.
Dodatkowe wymagania dotyczące podsumowania miejsca i obszaru
Podsumowania miejsc i obszarów wyświetlane w aplikacji muszą być opatrzone tym tekstem i wymaganymi linkami:
| Tekst | Wymaganie |
|---|---|
| Informacje o podsumowaniu | Kliknij ten link, aby dowiedzieć się, jak Google pozyskuje i wykorzystuje informacje z wizytówek lokalnych: https://support.google.com/local-listings/answer/9851099. |
| Zgłoś podsumowanie |
Aby zgłosić Google problem z treścią podsumowania, użyj linku w polu Uwaga: podsumowania generowane przez AI za pomocą interfejsu Places API (New) 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, mogą to zrobić, korzystając z podawanego URL-a treści do zgłoszenia ( |
Wymagania dotyczące podsumowania opinii
Podsumowania opinii wyświetlane w aplikacji muszą być opatrzone nagłówkiem z tekstem „Podsumowanie opinii”. Dodatkowo musisz użyć tego tekstu i wymaganych linków:
| Tekst | Wymaganie |
|---|---|
| Informacje o podsumowaniu | Kliknij ten link, 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 Uwaga: podsumowania generowane przez AI za pomocą interfejsu Places API (New) 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, mogą to zrobić, korzystając z podawanego URL-a treści do zgłoszenia ( |
| Zobacz opinie | Użyj linku zawartego w polu googleMapsLinks.reviewsUri odpowiedzi. |
wyświetlać wskazówki dotyczące zastosowań w motoryzacji.
Ze względów bezpieczeństwa zalecamy renderowanie podsumowań opartych na AI w trybie parkowania. Jeśli podsumowania są renderowane w trybie jazdy, informacje na ekranie powinny być proste, jasne i zwięzłe, aby kierowca mógł szybko wrócić do obserwowania drogi:
- Nie więcej niż 3 wiersze
- 120 znaków lub 24 słowa
- Minimalny rozmiar frontu: 24 dp
Szczególnie w przypadku samochodów deweloper ma obowiązek renderować podsumowania oparte na AI w sposób bezpieczny i zgodny ze wszystkimi lokalnymi przepisami i regulacjami prawnymi.
Wytyczne dotyczące stylu atrybucji Google
Jeśli nie możesz użyć logo Google do pobrania, poniżej znajdziesz wytyczne dotyczące stylów w przypadku informacji o Google w CSS i HTML.
Pusty obszar
Wielkość pustego obszaru wokół logo powinna być równa wysokości litery „G” w logo Google lub od niej większa.
Odstęp między tekstem dotyczącym autorstwa a logo Google powinien mieć połowę szerokości litery „G”.
czytelność;
W przypadku podpisu należy zawsze zadbać o to, aby był on wyraźny, czytelny i wyświetlany w odpowiednim kolorze w zależności od tła. Pamiętaj, aby wybrana przez Ciebie wersja logo miała wystarczający kontrast.
Kolor
Używaj czcionki Google Material Gray 700 na białym lub jasnym tle, która ma zakres 0–40% maksymalnego odcienia czerni.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Na ciemniejszym tle oraz na zdjęciach lub prostych wzorach używaj białego tekstu w przypisach i przyznaniach.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Czcionka
Użyj czcionki Roboto.
Przykładowy kod CSS
Poniższy kod CSS zastosowany do tekstu „Google” spowoduje, że „Google” zostanie wyrenderowane z odpowiednim fontem, kolorem i odstępem na białym lub jasnym tle.
font-family: Roboto; font-style: normal; font-weight: 500; font-size: 16px; line-height: 16px; padding: 16px; letter-spacing: 0.0575em; /* 0.69px */ color: #5F6368;