W tym artykule znajdziesz wymagania dotyczące atrybucji w przypadku wszystkich aplikacji opracowanych za pomocą interfejsu Maps JavaScript API, w tym usługi autouzupełniania miejsc, która jest częścią tego interfejsu API. Więcej warunków dotyczących Google Maps Platform znajdziesz w Warunkach korzystania z tej usługi.
Warunki korzystania z usługi i polityka prywatności
Jeśli tworzysz aplikację korzystającą z interfejsu Maps JavaScript API, musisz udostępnić w niej Warunki korzystania z usługi i Politykę prywatności zgodne z wytycznymi opisanymi w umowie z Google:
- Warunki korzystania z usługi i Polityka prywatności muszą być dostępne publicznie.
- W Warunkach korzystania z aplikacji musisz wyraźnie określić, że korzystanie z niej oznacza, że użytkownicy są związani Warunkami korzystania z usług Google.
- Musisz powiadomić użytkowników w Polityce prywatności, że korzystasz z interfejsów API Map Google, i uwzględnić te informacje w Polityce prywatności Google.
Miejsce, w którym zalecamy udostępnienie Warunków korzystania z aplikacji i Polityki prywatności, zależy od platformy aplikacji.
Aplikacja mobilna
Jeśli tworzysz aplikację mobilną, zalecamy podanie 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 z wyprzedzeniem, buforowanie lub przechowywanie treści
Aplikacje korzystające z interfejsu Maps JavaScript API podlegają warunkom Umowy z Google. Zgodnie z warunkami Umowy Użytkownik nie może pobierać z wyprzedzeniem, indeksować, przechowywać ani zapisywać w pamięci podręcznej żadnych Treści z wyjątkiem ograniczonych warunków określonych w warunkach.
Pamiętaj, że identyfikator miejsca używany do jednoznacznej identyfikacji miejsca jest wykluczony z ograniczeń dotyczących zapisywania w pamięci podręcznej. Identyfikator miejsca jest zwracany w polu place_id
w odpowiedziach interfejsu Maps JavaScript 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 Maps JavaScript API
Wyniki interfejsu Maps JavaScript API możesz wyświetlać w Mapach Google lub bez mapy. Jeśli chcesz wyświetlać wyniki z Maps JavaScript API na mapie, musisz je wyświetlić w Mapach Google. Nie można używać danych interfejsu Maps JavaScript API na mapie, która nie jest mapą Google.
wyświetlać logo i informacje o Google.
Jeśli Twoja aplikacja wyświetla dane w Mapach Google, zostanie uwzględnione logo Google, które nie może zostać zmienione. Aplikacje, które wyświetlają dane Google na tym samym ekranie co Mapy Google, nie muszą dodatkowo podawać danych 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 w aplikacji dane Google są wyświetlane na jednej karcie, a w Mapach Google z tymi danymi na innej, 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 elementy powinny być umieszczone na mapie, która jest prezentowana jako całość, a nie pod mapą ani w innym miejscu w aplikacji. Na przykładzie mapy poniżej widać logo Google w lewym dolnym rogu, a informacje o autorze w prawym dolnym rogu.
Do użytku na jasnym tle | Do użytku 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żna zmieniać rozmiaru ani modyfikować tych logo w żaden sposób.
Pobierz: google_logo.zip
Nie modyfikuj atrybucji. Nie usuwaj, nie zasłaniaj ani nie wycinaj informacji o autorze. 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 obrazów 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 umiejscowienie tekstu z informacjami o autorze, pod warunkiem że znajduje się on blisko treści i jest czytelny dla przeciętnego użytkownika lub czytelnika. Nie możesz przenosić informacji o pochodzeniu danych poza treść, np. na końcu książki, w informacje o autorach plików lub programu ani w stopce witryny.
Uwzględnij zewnętrznych dostawców danych. Niektóre dane i zdjęcia w naszych usługach mapowania pochodzą od dostawców innych 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 korzystasz z Google Maps Platform na urządzeniu, na którym wyświetlanie informacji o źródłach nie jest racjonalne, skontaktuj się z zespołem sprzedaży Google, aby omówić licencje odpowiednie do Twojego zastosowania.
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 informacji o atrybutach z Miejsca
Jeśli aplikacja wyświetla informacje o opiniach uzyskane przez wywołanie funkcji Place.fetchFields
, musi też wyświetlać informacje o źródłach danych dotyczących uzyskanych informacji o miejscu.
Interfejs API zwraca obiekt Place
. Aby pobrać atrybucje z obiektu Place
, użyj właściwości Place.attributions
, która jest zwracana z każdym żądaniem (nie musisz podawać jej za pomocą pól). Usługa zwraca List
z String
obiektów lub null
, jeśli nie ma żadnych atrybucji do wyświetlenia. Poniższy przykładowy kod pokazuje, jak pobierać miejsce i wyświetlać wszystkie atrybuty.
// Use place ID to create a new Place instance. const place = new Place({ id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen }); // Call fetchFields, passing the desired data fields. await place.fetchFields({ fields: ["displayName", "formattedAddress", "location", "reviews"], }); // Check for any place attributions. if (!place.attributions) { console.log('No attributions were found.'); return; } else { // Log the place attribution for (var attribution of place.attributions) { console.log(attribution); } }
Wyświetlanie opinii
Obiekt Place
może zawierać maksymalnie 5 opinii, z których każda jest reprezentowana przez obiekt Review
. Opcjonalnie możesz wyświetlać te opinie w swojej aplikacji.
Przy wyświetlaniu opinii przesłanych przez użytkowników Google musisz umieścić nazwisko autora w pobliżu. Jeśli w polu atrybucji autora obiektu Review
są dostępne, zalecamy dodanie zdjęcia autora i linku do jego profilu. Poniższy obraz przedstawia przykładową opinię o parku:
Ten przykład pokazuje, jak znaleźć miejsce, sprawdzić opinie i wyświetlić dane z pierwszej opinii:
// Use place ID to create a new Place instance. const place = new Place({ id: "ChIJpyiwa4Zw44kRBQSGWKv4wgA", // Faneuil Hall Marketplace, Boston, MA }); // Call fetchFields, passing "reviews" and other needed fields. await place.fetchFields({ fields: ["displayName", "formattedAddress", "location", "reviews"], }); // If there are any reviews display the first one. if (!place.reviews) { console.log('No reviews were found.'); } else { // Log the review count so we can see how many there are. console.log("REVIEW COUNT: " + place.reviews.length); // Get info for the first review. let reviewRating = place.reviews[0].rating; let reviewText = place.reviews[0].text; let authorName = place.reviews[0].authorAttribution.displayName; let authorUri = place.reviews[0].authorAttribution.uri; // Create a bit of HTML to add to the info window const contentString = '<div id="title"><b>' + place.displayName + '</b></div>' + '<div id="address">' + place.formattedAddress + '</div>' + '<a href="' + authorUri + '" target="_blank">Author: ' + authorName + '</a>' + '<div id="rating">Rating: ' + reviewRating + ' stars</div>' + '<div id="rating""><p>Review: ' + reviewText + '</p></div>'; // Create an info window. infoWindow = new InfoWindow({ content: contentString, ariaLabel: place.displayName, }); // Add a marker for the place. const marker = new AdvancedMarkerElement({ map, position: place.location, title: place.displayName, }); // Show the info window. infoWindow.open({ anchor: marker, map, }); }
Zapoznaj się z dokumentacją dotyczącą opinii o miejscach.
Wyświetlanie informacji o autorze 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ć do odpowiedzi tablicę photos
, umieść w żądaniu pole danych photos
.
Każdy element tablicy photos jest instancją klasy 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.
Zapoznaj się z dokumentacją dotyczącą zdjęć miejsca
Atrybucja wyników wyszukiwania
W Europie podczas korzystania z rankingu Google wyniki wyszukiwania nie mogą zawierać tekstu wyjaśnienia, które jest umieszczone w odległości maksymalnie 1 kliknięcia, aby opisać główne czynniki i określić wagę tych czynników, które decydują o pozycji w rankingu wyników wyszukiwania. Wyjaśnienie:
Header: Informacje o tych wynikach
Treść: gdy szukasz firm lub miejsc w pobliżu danej lokalizacji, w Mapach Google zobaczysz wyniki lokalne. Aby wybrać dla Ciebie najlepsze wyniki wyszukiwania, uwzględniamy różne czynniki – przede wszystkim trafność, odległość i renomę.
Przycisk 1: dodatkowe informacje
Tekst „Więcej informacji” powinien prowadzić do artykułu w Centrum pomocy.
Button 2: OK
Wytyczne dotyczące stylu na potrzeby atrybucji Google
Poniżej znajdziesz wskazówki dotyczące stylu atrybucji Google w arkuszach CSS i HTML, jeśli nie możesz użyć logo Google do pobrania.
Pusty obszar
Wielkość pustego obszaru wokół logo powinna być równa wysokości litery „G” w logo Google lub od niej większa.
Odległość między tekstem informacji o źródle a logo Google powinna być o połowę szerokości litery „G”.
czytelność;
Podpis powinien zawsze być wyraźny i czytelny oraz mieć odpowiedni kolor na danym tle. Zawsze dbaj o odpowiedni kontrast dla wybranej odmiany logo.
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 ciemniejszych tłach oraz na zdjęciach lub wzorach brak aktywności użyj białego tekstu jako autora i informacji o autorze.
#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;