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:
Wyodrębnij wszystkie informacje o prawach autorskich ze wszystkich widocznych kafelków.
Poszczególne źródła praw autorskich rozdziel średnikami.
Posortuj informacje według liczby wystąpień.
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.