Praca z własnym mechanizmem renderowania kart 3D

Deweloperzy z Europejskiego Obszaru Gospodarczego

Jeśli nie możesz włączyć do swojego rozwiązania usługi renderowania innej firmy, być może musisz utworzyć własny mechanizm renderowania kafelków 3D. To podejście wymaga uwzględnienia tych ważnych czynników:

Adresy URL zawartości

Podczas wyświetlania fotorealistycznych kafelków 3D interfejs Map Tiles API zwraca identyfikatory URI podrzędnych zbiorów kafelków. Te identyfikatory URI zbiorów kafelków nie są zwykłymi adresami URL. Zawierają tylko komponent ścieżki i parametrów. Nie zawierają klucza interfejsu API, który jest wymagany do autoryzacji żądania. Więcej informacji znajdziesz w specyfikacji kafelków 3D.

Żądania i odpowiedzi

Oto kilka przykładów żądań i odpowiedzi dotyczących fotorealistycznych kafelków 3D. Możesz je sprawdzić za pomocą Narzędzi deweloperskich w Chrome.

Przykładowe żądanie dotyczące głównego zbioru kafelków:

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

Przykładowy identyfikator URI odpowiedzi dotyczącej zbioru kafelków:

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

Przykładowe adresy URL żądań kafelków używane przez mechanizmy renderowania:

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY
https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

Podczas tworzenia kolejnych żądań kafelków należy dołączyć wszystkie parametry, które pojawiają się w identyfikatorze URI zestawu kafelków, wraz z kluczem interfejsu API. Interfejs 3D Tiles API udostępnia te 2 parametry:

session
Wbudowany identyfikator sesji wczytywania modelu 3D. Jest on generowany automatycznie przez interfejs API. Musi on zostać dołączony przez mechanizm renderowania podczas tworzenia kolejnych żądań kafelków.
key
Klucz interfejsu API użyty do uzyskania dostępu do usługi kafli 3D. Musisz dołączyć go do wszystkich kolejnych żądań kafelków.

Wyświetlanie atrybucji

Atrybucja oznacza podanie źródła kafelków mapy i jest wymagana do korzystania z tego interfejsu API. Obejmuje to atrybucję marki Google (logo) oraz atrybucję danych. Logo Google znajdziesz na stronie Zasady dotyczące interfejsu Map Tiles API. Informacje o atrybucji danych są zwracane w każdej odpowiedzi dotyczącej kafelka. Znajdziesz go w kafelku glTF w sekcji asset, copyright.

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

Musisz zagregować, posortować i wyświetlić te informacje w jednym wierszu tekstu, zwykle u dołu renderowania. Obejmuje to te kroki:

  1. Wyodrębnij wszystkie informacje o prawach autorskich ze wszystkich widocznych kafelków.

  2. Wiele źródeł praw autorskich rozdziel średnikami.

  3. Sortowanie informacji na podstawie liczby wystąpień.

  4. Wyświetlaj źródła praw autorskich na ekranie, uporządkowane od najczęściej do najrzadziej występujących, podobnie jak robi to Google Earth.