Ten dokument zawiera listę wymagań dotyczących aplikacji tworzonych za pomocą interfejsu Map Tiles API. Pamiętaj, że korzystanie z interfejsu Map Tiles API podlega umowie zawartej z Google.
Udostępnianie warunków korzystania z usługi i polityki prywatności
Jeśli tworzysz aplikację do interfejsu Map Tiles 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 Map Tiles 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.
W szczególności do wizualizacji map aplikacje powinny używać interfejsu Map Tiles API. Nie możesz używać interfejsu Map Tiles API do żadnych celów niezwiązanych z wizualizacją, takich jak:
- Analiza obrazu
- Interpretacja maszynowa
- Wykrywanie/identyfikacja obiektów
- Pobieranie lub odsprzedaż danych geograficznych
- Użycie offline, w tym powyższe
Odpowiedzi interfejsu Map Tiles API mogą zawierać nagłówki Cache-Control
, które należy wdrożyć zgodnie z dokumentacją protokołu HTTP. Na przykład podczas przekazywania w odpowiedzi klient musi przestrzegać wartości max-age
, wartości stale-while-revalidate
, dyrektywy must-revalidate
i private
.
Odpowiedzi interfejsu Map Tiles API mogą też zawierać nagłówek ETag
, który należy zaimplementować zgodnie z dokumentacją protokołu HTTP w przypadku żądania z ponowną walidacją.
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 Map Tiles API. W przewodniku po identyfikatorach miejsc dowiesz się, jak zapisywać i odświeżać identyfikatory miejsc oraz nimi zarządzać.
Wyświetlanie logo Google
Jeśli korzystasz z interfejsu Map Tiles API do wyświetlania Map Google, musisz też wyświetlać na mapie logo Google i nie możesz go w żaden sposób zmieniać. Logo Google należy umieścić w lewym dolnym rogu mapy, a informacje o autorze – w prawym rogu mapy. Więcej informacji znajdziesz w naszych wytycznych dotyczących Centrum zasobów marki.
W przypadku map 3D, które mają bardziej kinowy charakter, czyli nie możesz dostosować się do naszych wymagań dotyczących rozmieszczenia, musisz wyraźnie umieścić logo Google na początku lub na końcu albo na obu końcach mapy, aby odbiorcy wiedzieli, kto jest autorem mapy. Wyświetlanie informacji o atrybucji danych pochodzących od innych firm zgodnie z poniższymi zasadami jest wymagane przez cały czas trwania eksperymentu filmowego. Więcej wskazówek znajdziesz poniżej w sekcji Wyświetlanie logo i atrybucji danych w wizualizacjach hybrydowych.
Na przykładzie poniżej widać logo Google w lewym dolnym rogu mapy i 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 do wykorzystania na komputerze oraz w aplikacji na Androida i iOS. Nie można zmieniać rozmiaru logo ani w żaden sposób 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.
Wyświetlanie logo Google za pomocą zewnętrznych mechanizmów renderowania
Jeśli używasz interfejsu Map Tiles API do wyświetlania Map Google za pomocą mechanizmu renderowania innej firmy, nie możesz zasłaniać logo Google innym logo, np. mechanizmu renderowania, ani je zasłaniać. Zachowaj odpowiednią odległość między logo Google a logo innych firm, aby logo było wyświetlane jako niezależne logo. Żadne logo nie może zasłaniać ani zasłaniać informacji o źródle danych dostarczanych przez odpowiedź interfejsu API.
Wyświetlanie atrybucji danych Google
Dane zwracane przez interfejs Map Tiles API wymagają wyświetlania informacji o atrybucji i prawach autorskich pochodzących z odpowiednich metadanych lub żądań informacji o widocznym obszarze. Powinny one być wyświetlane w całości w sposób podany w odpowiednim miejscu, zwykle w prawym dolnym rogu wyświetlanego zestawu kafelków, lub w widoku mechanizmu renderowania 3D. Pamiętaj, że ciągi znaków atrybucji są zmienne i zależą od danych mapy żądane przez widoczny obszar mechanizmu renderowania.
Jeśli wyświetlenie atrybucji danych w całości jest niemożliwe z powodu ograniczeń rozmiaru widocznego obszaru, rozważ dodanie elementu interfejsu, który można najechać kursorem lub kliknąć, o nazwie „Źródła danych”, który otwiera się w oknie mapy i zawiera informacje o atrybucji. Pamiętaj, aby zawsze przestrzegać dobrych praktyk kartograficznych.
Wyświetlanie atrybucji danych pochodzących od innych firm
Gdy używasz interfejsu Map Tiles API do wyświetlania danych Map Google jako mapy podstawowej i nakładania danych geoprzestrzennych pochodzących od innych firm (nie Google), może być konieczne wyświetlenie atrybucji od zewnętrznego dostawcy danych. Nie możesz w żaden sposób zasłaniać ani zasłaniać informacji o pochodzeniu danych Google z atrybucją danych pochodzących od innych firm. Atrybucja danych pochodzących od innych firm musi być wyraźnie oddzielona od informacji pochodzących od Google. Musi też być jasne, że logo Google i oznaczenie danych Google są powiązane z mapą bazową i ze sobą nawzajem.
Wyświetlanie logo i atrybucji danych w wizualizacjach hybrydowych
Jeśli używasz danych Map Google jako mapy podstawowej i nakładasz na swoje własne mapy, musisz upewnić się, że odbiorcy w pełni wiedzą, która część wizualizacji mapy jest przypisana do Google, a które z Twoich danych map. Dodatkowo przestrzegaj wytycznych w sekcji Wyświetlanie logo Google powyżej.
Możesz na przykład połączyć fotorealistyczne kafelki 3D (jako wypełniacz tła) z własnymi fotorealistycznymi modelami (na pierwszym planie). Użytkownicy mogą nie być pewni, które elementy sceny pochodzą z danych Map Google. W takich przypadkach musisz w ciągu tekstowym w interfejsie użytkownika lub w przepływie użytkowników jasno określić, która część sceny pochodzi z danych Map Google. Ponosisz odpowiedzialność za przestrzeganie wszelkich wymagań dotyczących atrybucji osób trzecich, które mogą mieć zastosowanie do źródeł danych, których używasz z danymi Map Google.
Nakładki danych geograficznych z fotorealistycznymi kafelkami 3D
Na kafelkach fotorealistycznych 3D możesz nakładać własne obiekty 3D, o ile nie zostały one wyodrębnione, śledzone ani w inny sposób wyodrębnione ręcznie lub automatycznie z kafelków 3D fotorealistycznych.
Tworzenie filmów przy użyciu interfejsu Map Tiles API
- Filmy promocyjne: użytkownik może tworzyć filmy promocyjne zgodnie z warunkami Umowy oraz:
- Film promocyjny nie może zawierać zdjęć Street View.
- Film promocyjny nie może trwać dłużej niż 30 sekund.
- Film promocyjny musi dotyczyć możliwości Twoich aplikacji.
- Film promocyjny musi być wyraźnie oznaczony „tylko w celach promocyjnych” i musi być zgodny z wytycznymi dotyczącymi atrybucji w zasadach dotyczących interfejsu Map Tiles API.
- Film promocyjny nie może być odsprzedawany oddzielnie ani jako część oprogramowania, aplikacji lub funkcji dla użytkownika.
- Usunięcie filmu: masz obowiązek przestrzegać wszystkich żądań usunięcia filmu promocyjnego, w tym żądań od osób trzecich.
Pobieranie informacji o uznaniu autorstwa i prawach autorskich
W zależności od używanej usługi uzyskaj informacje o autorze i prawach autorskich z pola copyright
w odpowiedziach następujących wywołań interfejsu API:
Kafelki 2D
Kafelki z mapą, satelitą i terenem
Informacje o prawach autorskich i atrybucji znajdziesz w odpowiedzi z informacjami o widocznym obszarze, jak pokazano w tym przykładzie.
{
"copyright": "Map data ©2023",
"maxZoomRects": [
{
"maxZoom": 19,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
...
]
}
Kafelki Street View
Informacje o prawach autorskich i pochodzeniu danych są dostępne w odpowiedzi na temat metadanych Street View. Na przykład:
{
"panoId": "Zzl28rqGJgaL2IdkUleP8A",
"lat": 50.059138596550696,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"copyright": "From the Owner, Photo by: Google",
…
}
Identyfikator panoramy, używany do jednoznacznego identyfikowania panoramy Street View, nie jest objęty ograniczeniem zapisywania w pamięci podręcznej. Dlatego wartości można przechowywać
w nieskończoność. Wartości identyfikatora panoramy są zwracane w polu panoId
w odpowiedziach statycznego interfejsu API Street View.
fotorealistyczne kafelki 3D
W przypadku fotorealistycznych kafelków 3D dane atrybucji są zwracane w każdym żądaniu kafelka.
Musisz agregować, sortować i wyświetlać w wierszu wszystkie informacje o atrybucji wyświetlanych kafelków, zwykle u dołu renderowania. Na przykład atrybucje danych możesz znaleźć w kafelku glTF w sekcjach asset
, copyright
.
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
CesiumJS
Jeśli używasz CesiumJS jako mechanizmu renderowania, to, aby wyświetlać atrybucje, musisz włączyć showCreditsOnScreen
w renderowanym kodzie HTML.
// Add Photorealistic 3D Tiles tileset.
const tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
// This property is needed to appropriately display attributions
// as required.
showCreditsOnScreen: true,
}));
Cez
Jeśli używasz Cesium for Unreal jako mechanizmu renderowania, to, aby wyświetlać atrybucje, musisz włączyć pole Pokaż punkty na ekranie w World Outliner.
Cez dla Unity
Jeśli używasz Cesium dla Unity jako mechanizmu renderowania, to, aby wyświetlać atrybucje, musisz włączyć pole Pokaż punkty na ekranie w konsoli inspekcji.
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;