Praca z własnym mechanizmem renderowania kart 3D

Jeśli nie możesz uwzględnić w swojej usłudze renderowania produktu zewnętrznego, być może musisz utworzyć własny renderer mozaiki 3D. Takie podejście wymaga uwzględnienia tych ważnych czynników:

Adresy URL treści

Podczas obsługi fotorealistycznych kafelków 3D interfejs Map Tiles API zwraca identyfikatory URI podrzędnych zestawów kafelków. Te identyfikatory URI nie są zwykłymi adresami URL. Zawierają tylko ścieżkę i parametry. Nie zawierają one 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 pakietu danych:

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

Przykładowy identyfikator URI odpowiedzi dla zestawu płytek:

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

Przykładowe adresy URL żądań płytek używanych 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ń płytek należy dołączyć wszystkie parametry, które pojawiają się w identyfikatorze URI zestawu płytek, wraz z kluczem interfejsu API. Interfejs 3D Tiles API udostępnia te 2 parametry:

session
Wbudowany identyfikator sesji wczytywania 3D. Jest on generowany automatycznie przez interfejs API. Musi być dołączony przez renderera podczas tworzenia kolejnych żądań kafelków.
key
Klucz API użyty do uzyskania dostępu do usługi 3D Tiles. Musisz go załączyć do wszystkich kolejnych próśb o płytkę.

Wyświetlanie atrybucji

Atrybucja oznacza wskazanie źródła kafelków mapy i jest wymagana do korzystania z tego interfejsu API. Obejmuje atrybucję marki Google (logo) oraz atrybucję danych. Logo Google jest dostępne na stronie Zasady interfejsu Map Tiles API. Informacje o przypisaniu danych są zwracane w każdej odpowiedzi na kafelek. Znajdziesz go na płytce glTF w sekcji asset, copyright.

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

Musisz zebrać, posortować i wyświetlić te informacje w wierszu tekstu, zazwyczaj u dołu renderowania. Aby to zrobić, wykonaj te czynności:

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

  2. Oddziel różne źródła praw autorskich za pomocą średnika.

  3. Posortuj informacje według liczby wystąpień.

  4. Wyświetlanie na ekranie źródeł praw autorskich w kolejności od najczęściej do najmniej często występujących, podobnie jak w przypadku Google Earth.