Ten dokument zawiera wymagania dotyczące aplikacji tworzonych za pomocą interfejsu Map Tiles API. Pamiętaj, że korzystanie z interfejsu Map Tiles API podlega Twojej umowie z Google.
Zasady
W tej sekcji opisujemy zasady dotyczące interfejsu Map Tiles API. Zasady zawierają praktyczne wskazówki i wymagania dotyczące wdrażania, które pomogą Ci prawidłowo korzystać z usługi i spełniać oczekiwania Google Maps Platform.
pobieranie z wyprzedzeniem, buforowanie lub przechowywanie treści;
Aplikacje korzystające z interfejsu Map Tiles API podlegają warunkom umowy z Google. Zgodnie z warunkami Umowy nie możesz 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.
W szczególności aplikacje powinny używać interfejsu Map Tiles API do wizualizacji map. Nie możesz używać interfejsu Map Tiles API w przypadkach, które nie dotyczą wizualizacji, takich jak:
- Analiza obrazu
- Interpretacja maszynowa
- wykrywanie lub identyfikowanie obiektów,
- wydobywanie lub odsprzedaż danych geograficznych;
- użycie offline, w tym w przypadkach wymienionych powyżej;
Odpowiedzi interfejsu Map Tiles API mogą zawierać nagłówki Cache-Control, które należy zaimplementować zgodnie z dokumentacją protokołu HTTP. Na przykład klient musi przestrzegać wartości max-age, wartości stale-while-revalidate, dyrektywy must-revalidate i dyrektywy private, gdy są one przekazywane w odpowiedzi.
Odpowiedzi interfejsu Map Tiles API mogą też zawierać nagłówek ETag, który również powinien być zaimplementowany zgodnie z dokumentacją protokołu HTTP podczas wysyłania żądania z ponowną weryfikacją.
Drukuj
Zdjęć Street View nie można używać do druku, jak opisano w zasadach Street View.
Kraje i terytoria Europejskiego Obszaru Gospodarczego
W przypadku klientów, których adres rozliczeniowy znajduje się w Europejskim Obszarze Gospodarczym (EOG), ta usługa ma inne Warunki korzystania z usługi i może mieć inne funkcje. Zanim zaczniesz tworzyć rozwiązania za pomocą Google Maps Platform, zapoznaj się z tymi warunkami i informacjami dotyczącymi Europejskiego Obszaru Gospodarczego:
- Warunki korzystania z usługi Google Maps Platform w Europejskim Obszarze Gospodarczym
- Szczegółowe warunki korzystania z usługi 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:
- Warunki korzystania z usługi Google Maps Platform
- Szczegółowe warunki korzystania z usługi Google Maps Platform
Wyświetlanie informacji o autorstwie w Mapach Google
Gdy wyświetlasz w aplikacji lub witrynie treści z interfejsów API Google Maps Platform, musisz wyraźnie podać informacje o autorstwie Map Google. Jeśli to możliwe, atrybucja powinna mieć formę logo Map Google. W przypadkach, gdy ilość miejsca jest ograniczona, dopuszczalny jest tekst Mapy Google.
Atrybucja logo
Logo Map Google
Używaj oficjalnych logo Map Google podanych poniżej.
Pobierz zasoby dotyczące atrybucji Map Google
Podczas korzystania z logo Map Google postępuj zgodnie z tymi wytycznymi.
- Nie modyfikuj logo w żaden sposób.
- Zachowaj format obrazu logo, aby uniknąć zniekształceń.
- Używaj logo z obramowaniem na szczegółowym tle, np. na mapie lub obrazie.
- Używaj logo bez obramowania na jednolitym tle, np. w jednolitym kolorze lub z delikatnym gradientem.
Specyfikacja rozmiaru logo
Przestrzegaj tych specyfikacji dotyczących rozmiaru logo Map Google:
- Minimalna wysokość logo: 16 dp
- Maksymalna wysokość logo: 19 dp
- Minimalny pusty obszar wokół logo: 10 dp po lewej i prawej stronie oraz u góry, 5 dp u dołu.
Więcej informacji o dp znajdziesz w artykule Gęstość pikseli na stronie Material Design.
Dostępność logo
Przestrzegaj tych wymagań dotyczących ułatwień dostępu w odniesieniu do logo Map Google:
- Zachowaj odpowiedni kontrast między logo a tłem.
- Dołącz etykietę ułatwień dostępu z tekstem Mapy Google.
Wyświetlanie logo Map Google w renderach innych firm
Gdy używasz interfejsu Map Tiles API do wyświetlania Map Google za pomocą renderera innej firmy, nie możesz nakładać na logo Google ani zasłaniać go żadnym innym logo, np. logo renderera. Zachowaj odpowiednią odległość między logo Google a logo innej firmy, aby były widoczne jako niezależne elementy. Żadne logo nie może nakładać się na informacje o autorstwie danych podane w odpowiedzi interfejsu API ani ich zasłaniać.
Wyświetlanie atrybucji danych Google
Dane zwracane przez interfejs Map Tiles API wymagają wyświetlania informacji o autorstwie i prawach autorskich z odpowiednich żądań metadanych lub informacji o wyświetlanym obszarze. Te informacje należy wyświetlać w pełni w odpowiednim miejscu, zwykle w prawym dolnym rogu wyświetlanego zestawu kafelków lub w widoku renderowania 3D. Pamiętaj, że ciągi znaków atrybucji są zmienne i zależą od danych mapy, o które prosi widoczny obszar renderowania.
Jeśli ze względu na rozmiar widocznego obszaru nie można wyświetlić pełnych informacji o autorstwie danych, rozważ dodanie elementu interfejsu, który można kliknąć lub najechać na niego kursorem, o nazwie „Źródła danych”. Po kliknięciu lub najechaniu na niego kursorem w oknie mapy otworzy się okno z informacjami o autorstwie. Zawsze staraj się stosować sprawdzone metody kartograficzne.
Wyświetlanie atrybucji danych pochodzących od innych firm
Niektóre dane i zdjęcia w naszych usługach mapowania pochodzą od dostawców innych niż Google. W przypadku niektórych usług, takich jak Map Tiles API, możemy podać wymagane informacje o autorze, które należy przypisać zewnętrznemu dostawcy danych. W takim przypadku tekst atrybucji musi zawierać nazwę „Mapy Google” i nazwy odpowiednich dostawców danych, np. „Dane mapy: Google, Maxar Technologies”. Gdy Google podaje informacje o źródle, które pochodzi od innej firmy, podanie tylko „Map Google” lub logo Google nie jest prawidłowym podaniem źródła.
Jeśli używasz interfejsu Map Tiles API do wyświetlania danych Map Google jako mapy podstawowej i nakładasz na nie dane geoprzestrzenne innych firm (nie Google), nie możesz w żaden sposób nakładać na siebie ani zasłaniać informacji o autorstwie danych Google informacjami o autorstwie danych innych firm. Atrybucja danych pochodzących od innych firm musi być wyraźnie oddzielona od atrybucji danych Google. Ponadto musi być jasne, że logo Map Google i atrybucja danych Google są powiązane z mapą podstawową i ze sobą nawzajem.
Wyświetlanie logo i informacji o autorach danych w wizualizacjach hybrydowych
Jeśli używasz danych Map Google jako mapy podstawowej, nakładając na nie własne dane mapy, musisz zadbać o to, aby odbiorcy w pełni rozumieli, która część wizualizacji mapy jest przypisana do Google, a która do Twoich własnych danych mapy. Oprócz tego postępuj zgodnie ze wskazówkami podanymi powyżej w sekcji Wyświetlanie atrybucji Map Google.
Możesz na przykład połączyć fotorealistyczne kafelki 3D (jako wypełnienie tła) z własnymi fotorealistycznymi modelami (na pierwszym planie). Użytkownicy mogą mieć trudności z ustaleniem, które komponenty sceny pochodzą z danych Map Google. W takich przypadkach musisz wyraźnie wskazać w ciągu tekstowym atrybucji w interfejsie lub we wzorcu przeglądania, która część sceny pochodzi z danych Map Google. Odpowiadasz za przestrzeganie wszelkich wymagań dotyczących podawania źródła, które mogą mieć zastosowanie do źródeł danych używanych przez Ciebie z danymi Map Google.
Nakładki geodanych z fotorealistycznymi kafelkami 3D
Możesz nakładać własne obiekty 3D na fotorealistyczne kafelki 3D, o ile obiekty 3D nie są wyodrębniane, śledzone ani w żaden inny sposób uzyskiwane ręcznie lub maszynowo z fotorealistycznych kafelków 3D.
Tworzenie filmów za pomocą interfejsu Map Tiles API
- Filmy promocyjne: możesz tworzyć filmy promocyjne zgodnie z warunkami Umowy i poniższymi zasadami:
- Promowany film 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 aplikacji.
- Film promocyjny musi być wyraźnie oznaczony jako „wyłącznie do celów promocyjnych” i musi być zgodny z wytycznymi dotyczącymi wyświetlania atrybucji Map Google.
- Promowanego filmu nie można odsprzedawać osobno ani jako części oprogramowania, aplikacji lub interfejsu.
- Usunięcie: Deweloper jest odpowiedzialny za spełnienie wszystkich żądań usunięcia Filmu promocyjnego, w tym żądań od osób trzecich.
Pobieranie informacji o autorstwie i prawach autorskich
Informacje o autorstwie i prawach autorskich znajdziesz w polu copyright w odpowiedziach na te wywołania interfejsu API, w zależności od używanej usługi:
kafelki 2D,
Kafelki mapy drogowej, satelitarnej i terenu
Informacje o prawach autorskich i atrybucji są dostępne 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 autorstwie są dostępne w odpowiedzi z metadanymi Street View. Na przykład:
{
"panoId": "rZ9KeTyhA11i0VppYNzsSg",
"lat": 37.420864219339165,
"lng": -122.08446528377291,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"heading": 94.35,
"tilt": 88.39652,
"roll": 1.7181772,
"imageryType": "outdoor",
"date": "2023-01",
"copyright": "© 2023 Google",
"reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0",
…
}
Identyfikator panoramy, który służy do jednoznacznej identyfikacji panoramy Street View, nie podlega ograniczeniom dotyczącym buforowania. Dlatego możesz przechowywać wartości identyfikatorów panoram bezterminowo. Wartości identyfikatora panoramy są zwracane w polu panoId w odpowiedziach interfejsu Street View Static API.
W prawym dolnym rogu obrazu musisz wyświetlić hiperlink reportProblemLink, który musi zawierać tekst linku o treści podobnej do „Zgłoś problem z tym obrazem”.
Fotorealistyczne kafelki 3D
W przypadku fotorealistycznych kafelków 3D dane o atrybucji są zwracane w każdym żądaniu kafelka.
Musisz zagregować, posortować i wyświetlić w jednym wierszu wszystkie atrybucje wyświetlanych kafelków, zwykle u dołu renderowania. Na przykład atrybucje danych w kafelku glTF znajdziesz w sekcji asset, copyright.
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
CesiumJS
Jeśli jako mechanizmu renderowania używasz CesiumJS, 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,
}));
Cesium for Unreal
Jeśli jako mechanizmu renderowania używasz Cesium for Unreal, aby wyświetlać atrybucje, musisz włączyć pole Show Credits On Screen (Pokaż informacje o autorach na ekranie) w World Outliner.
Cesium for Unity
Jeśli jako renderera używasz Cesium for Unity, aby wyświetlać atrybucje, musisz włączyć pole Show Credits On Screen (Pokaż informacje o autorach na ekranie) w konsoli Inspector.
