Praca z własnym mechanizmem renderowania kart 3D

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Jeśli nie możesz zintegrować z rozwiązaniem produktu do renderowania innej firmy, być może będziesz musiał utworzyć własny renderer kafelków 3D. W tym przypadku musisz wziąć pod uwagę te ważne czynniki:

Adresy URL treś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 ścieżkę i komponenty 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 zbioru kafelków głównego:

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

Przykładowy identyfikator URI odpowiedzi zbioru kafelków:

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

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

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 zbioru kafelków, oraz klucz interfejsu API. Interfejs 3D Tiles API udostępnia te 2 parametry:

session
Wbudowany identyfikator sesji ładowania 3D. Jest generowany automatycznie przez interfejs API. Renderer musi go dołączyć podczas tworzenia kolejnych żądań kafelków.
key
Klucz interfejsu API użyty do uzyskania dostępu do usługi kafelków 3D. Musisz go dołączyć do wszystkich kolejnych żądań kafelków.

Atrybucje wyświetlane

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 jest dostępne na stronie Zasady dotyczące interfejsu Map Tiles API. Informacje o atrybucji danych są zwracane w każdej odpowiedzi dotyczącej kafelka. Znajdziesz je 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 agregować, sortować i wyświetlać te informacje w wierszu tekstu, zwykle u dołu renderowania. Wymaga to wykonania tych czynności:

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

  2. Oddziel poszczególne źródła praw autorskich średnikami.

  3. Posortuj informacje na podstawie liczby wystąpień.

  4. Wyświetl źródła praw autorskich na ekranie w kolejności od największej do najmniejszej liczby wystąpień, podobnie jak w Google Earth robi to.