Praca z własnym mechanizmem renderowania kart 3D

Jeśli nie możesz zastosować w swoim rozwiązaniu zewnętrznego produktu renderującego, konieczne może być utworzenie własnego mechanizmu renderowania kafelków 3D. Ta metoda wymaga rozważenia następujących ważnych czynników:

Adresy URL treści

Podczas udostępniania fotorealistycznych kafelków 3D interfejs Map Tiles API zwraca identyfikatory URI dla podrzędnych zbiorów kafelków. Te identyfikatory URI zbioru tileset nie są zwykłymi adresami URL. Obejmują 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 kafelków 3D fotorealistycznych. Możesz je sprawdzić za pomocą Narzędzi dla programistów w Chrome.

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

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

Przykładowy identyfikator URI odpowiedzi tileset:

 /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 z identyfikatora URI tileset razem 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ć ona dołączana przez mechanizm renderowania 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łączać do wszystkich kolejnych próśb o kafelki.

Atrybucje w sieci reklamowej

Atrybucja oznacza potwierdzenie źródła fragmentów mapy i jest wymagane do korzystania z tego interfejsu API – obejmuje to informacje o marce Google (logo) i atrybucję danych. Logo Google jest dostępne na stronie Zasady dotyczące interfejsu API Map Tiles. Informacje o atrybucji danych są zwracane w każdej odpowiedzi kafelka. Poszukaj jej w treści odpowiedzi, w pliku JSON w polu asset.copyright.

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

Te informacje musisz agregować, sortować i wyświetlać w wierszu tekstu, zwykle u dołu renderowania. Aby to zrobić:

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

  2. Poszczególne źródła praw autorskich oddziel średnikiem.

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

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