W tym temacie przedstawiamy wymagania dotyczące atrybucji we wszystkich aplikacjach utworzonych za pomocą interfejsu Maps JavaScript API, w tym także dla usługi autouzupełniania miejsc, która jest częścią tego interfejsu API. Więcej warunków korzystania z Google Maps Platform znajdziesz w Warunkach korzystania z Google Maps Platform.
Udostępnianie warunków korzystania z usługi i polityki prywatności
Jeśli tworzysz aplikację do interfejsu Maps JavaScript API, musisz udostępnić w swoim zgłoszeniu Warunki korzystania z usługi oraz Politykę prywatności, które są zgodne z wytycznymi określonymi w Umowie z Google:
- Warunki korzystania z usługi i Polityka prywatności muszą być dostępne publicznie.
- W Warunkach korzystania z aplikacji należy wyraźnie zaznaczyć, że korzystając z niej, użytkownicy są zobowiązani do przestrzegania Warunków korzystania z usług Google.
- W swojej Polityce prywatności musisz powiadomić użytkowników, że korzystasz z interfejsów API Map Google, i uwzględnić je w Polityce prywatności Google.
Zalecane miejsce udostępniania Warunków korzystania z usługi i Polityki prywatności zależy od platformy, na której działa aplikacja.
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 podanie w stopce witryny linku do Warunków korzystania z usługi i Polityki prywatności.
Pobieranie z wyprzedzeniem, zapisywanie w pamięci podręcznej lub przechowywanie treści
Aplikacje korzystające z interfejsu Maps JavaScript API są objęte warunkami Umowy z Google. Zgodnie z warunkami Umowy Użytkownik nie może pobierać z wyprzedzeniem, indeksować, przechowywać ani buforować żadnej Treści, z wyjątkiem ograniczonych warunków określonych w warunkach.
Pamiętaj, że identyfikator miejsca używany do jednoznacznej identyfikacji miejsca jest zwolniony z ograniczeń dotyczących buforowania. Identyfikator miejsca jest zwracany w polu `place_id` w odpowiedziach interfejsu Maps JavaScript API. W przewodniku po identyfikatorach miejsc dowiesz się, jak zapisywać i odświeżać identyfikatory miejsc oraz nimi zarządzać.
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świetlić wyniki interfejsu Maps JavaScript API na mapie, musisz je wyświetlić w Mapach Google. Nie wolno używać danych interfejsu Maps JavaScript API na mapie, która nie jest mapą Google.
Wyświetlanie logo Google i informacji o autorach
Jeśli aplikacja wyświetla dane w Mapach Google, pojawia się w nich logo Google i nie można go zmieniać. Aplikacje, które wyświetlają dane Google na tym samym ekranie co Mapa Google, nie muszą podawać Google dodatkowych informacji o źródłach.
Jeśli Twoja aplikacja wyświetla dane na stronie lub w widoku, który nie wyświetla również Map Google, musisz pokazać logo Google z tymi danymi. Jeśli na przykład aplikacja wyświetla dane Google na jednej karcie, a Mapa Google z tymi danymi na innej, pierwsza karta musi zawierać logo Google. Jeśli Twoja aplikacja używa pól wyszukiwania z autouzupełnianiem lub bez niego, logo musi być wyświetlane w tekście.
Logo Google powinno być umieszczone w lewym dolnym rogu mapy, a informacje o autorze umieszczone w prawym dolnym rogu powinny znajdować się na mapie jako całości, a nie pod mapą ani innym miejscem w aplikacji. Na przykładzie poniżej widać logo Google w lewym dolnym rogu mapy, 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 odpowiednim rozmiarze dla aplikacji na komputery oraz na Androida i iOS. Nie można w żaden sposób zmieniać rozmiaru logo ani go modyfikować.
Pobierz: google_logo.zip
Nie modyfikuj atrybucji. Nie usuwaj, nie zasłaniaj ani nie przycinaj informacji o autorze. W tekście nie można używać logo Google (np. „Te mapy pochodzą z: [Google_logo]”).
Dbaj o to, aby informacje o atrybucji były zawsze aktualne. Jeśli używasz zrzutów ekranu ze zdjęciami Google, które nie zostały umieszczone bezpośrednio na stronie, podaj standardową informację o autorze w takiej postaci, w jakiej jest widoczna na zdjęciu. W razie potrzeby możesz dostosować styl i umiejscowienie tekstu z informacjami o autorze, o ile mieści się on blisko treści i jest czytelny dla przeciętnego użytkownika lub czytelnika. Nie możesz odsunąć informacji o autorze za treści, np. do końca książki, w informacjach o autorze plików lub programu albo w stopce witryny.
Uwzględnij zewnętrznych dostawców danych. Niektóre dane i zdjęcia w naszych usługach do mapowania pochodzą od dostawców innych niż Google. Jeśli używasz takich zdjęć, tekst Twojej informacji musi zawierać nazwę „Google” i odpowiednich dostawców danych, np. „Dane map: Google, Maxar Technologies”. Jeśli w zdjęciach wymieniono zewnętrznych dostawców danych, uwzględnienie wyłącznie słowa „Google” lub logo Google nie jest prawidłowe.
Jeśli korzystasz z Google Maps Platform na urządzeniu, na którym wyświetlanie atrybucji jest niepraktyczne, skontaktuj się z zespołem sprzedaży Google, aby omówić licencje odpowiednie do Twojego przypadku użycia.
Inne wymagania dotyczące atrybucji
Wykonaj te instrukcje, aby pobierać dane o atrybucji innych firm i wyświetlać je w swojej aplikacji.
Pobieranie informacji o źródłach z miejsca
Jeśli aplikacja wyświetla opinie uzyskane za pomocą wywołania Place.fetchFields, musi też wyświetlać informacje o pochodzeniu danych o miejscach uzyskane przez osoby trzecie.
Interfejs API zwraca obiekt Place. Aby pobrać informacje o atrybucji z obiektu Place, użyj właściwości Place.attributions, która jest zwracana z każdym żądaniem (nie musisz dodawać do niej pól). Usługa zwraca List z String obiektów lub null, jeśli nie ma informacji o atrybucji. Poniższy przykładowy kod pokazuje, jak uzyskać miejsce i wyświetlić listę wszystkich atrybucji.
// 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, przy czym każda opinia jest reprezentowana przez obiekt Review. Opcjonalnie możesz wyświetlać te opinie w swojej aplikacji.
Jeśli wyświetlasz opinie napisane przez użytkowników Google, imię i nazwisko ich autora musisz umieścić w niewielkiej odległości od siebie. Zalecamy podanie zdjęcia autora i link do jego profilu, jeśli jest ono dostępne w polu informacji o autorze obiektu Review. Poniższy obraz przedstawia przykład opinii 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: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen, 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,
});
}
Wyświetlanie informacji o atrybucji zdjęcia
Jeśli aplikacja wyświetla zdjęcia, musisz umieścić informacje o ich autorach w przypadku każdego zdjęcia, które je zawiera.
Szczegóły zdjęcia zawartego w obiekcie Place odpowiedzi znajdują się w tablicy photos. Aby dodać do odpowiedzi tablicę photos, dołącz w żądaniu pole danych photos.
Każdy element tablicy zdjęć jest wystąpieniem elementu Photo, który zawiera tablicę authorAttributions typu AuthorAttribution. Pola obiektu AuthorAttribution to ciągi tekstowe zawierające displayName, uri i photoUri informacji o atrybucji lub pusty ciąg znaków, jeśli nie ma informacji o atrybucji.
Wytyczne dotyczące stylu w przypadku atrybucji Google
Jeśli nie możesz użyć logo Google do pobrania, poniżej znajdziesz wskazówki dotyczące stylu dotyczące informacji Google w kodach CSS i HTML.
Pusty obszar
Wielkość pustego obszaru wokół logo powinna być równa wysokości litery „G” w Google lub od niej większa.
Odstęp między treścią informacji o źródle a logo Google powinien być o połowę szerokości litery „G”.
Czytelność
Informacje o publikacji powinny być zawsze czytelne i czytelne oraz pojawiać się w odpowiednich wariantach kolorystycznych na danym tle. Zawsze upewnij się, że dla wybranej wersji logo masz wystarczający kontrast.
Kolor
Używaj tekstu Google Material Gray 700 na białym lub jasnym tle o maksymalnym zakresie 0–40% czerni.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Na ciemniejszym tle, nad fotografiami lub w innym miejscu zdjęć dodaj biały tekst.
#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” wyrenderuje tekst „Google” z odpowiednią czcionką, kolorem i odstępami 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;