Praca z własnym mechanizmem renderowania kart 3D

Jeśli nie możesz uwzględnić w swojej aplikacji produktu do renderowania firmy zewnętrznej, być może musisz utworzyć własny mechanizm renderowania płytek 3D. Takie podejście wymaga uwzględnienia tych ważnych czynników:

Adresy URL treści

W przypadku udostępniania kafelków fotorealistycznych 3D interfejs Map Tiles API zwraca identyfikatory URI zestawów elementów podrzędnych. 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 kart 3D.

Żądania i odpowiedzi

Oto kilka przykładów żądań i odpowiedzi dotyczących zdjęć realistycznych kafelków 3D. Można 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 kafelka:

 /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ń kafelka musisz dołączyć wszystkie parametry pojawiające się w identyfikatorze URI kafelka 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 zostać dołączony przez mechanizm renderowania podczas tworzenia kolejnych żądań kafelków.
key
Klucz API użyty do uzyskania dostępu do usługi 3D Tiles. Musisz go dołączać do wszystkich kolejnych żądań kafelków.

Atrybucje w sieci reklamowej

Atrybucja oznacza potwierdzenie źródła fragmentów mapy i jest wymagane do korzystania z tego interfejsu API – obejmuje to 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. Obejmuje to te kroki:

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

  2. Poszczególne źródła praw autorskich rozdziel średnikami.

  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.