Wprowadzenie do narzędzia 3D Area Explorer

obraz

Przegląd

Rozwiązanie 3D Area Explorer to zupełnie nowy sposób odkrywania i poznawania lokalizacji. Wykorzystuje ono możliwości Google Maps Platform fotorealistycznych kafelków 3D i interfejsu Places API do tworzenia atrakcyjnych, interaktywnych środowisk 3D.

3D Area Explorer ma wiele zastosowań:

  • Ułatwianie poznawania obszarów: użytkownicy mogą wirtualnie zwiedzać dzielnice z dużą ilością szczegółów wizualnych, poznając lokalne atrakcje i punkty orientacyjne.

  • Promowanie narracji opartych na lokalizacji: możliwość dodawania punktów orientacyjnych z bogatymi opisami pozwala tworzyć narracje, które edukują i informują użytkowników o konkretnych lokalizacjach.

  • Inspirowanie do tworzenia aplikacji wykorzystujących możliwości 3D Map Google: rozwiązanie pokazuje potencjał danych map 3D Google do tworzenia immersyjnych, interaktywnych map.

Pierwsze kroki:

Włącz

Kluczowe technologie

To rozwiązanie jest oparte na 2 kluczowych technologiach:

Interfejsy API Google Maps Platform:

Do uzyskania mapy podstawowej i danych potrzebnych do stworzenia tego rozwiązania używamy kilku interfejsów API Google Maps Platform:

  • Fotorealistyczne kafelki 3D Map Google: modele 3D budynków i terenu w wysokiej rozdzielczości zapewniają realistyczne i atrakcyjne wizualnie odwzorowanie środowisk miejskich.
  • Places API: aplikacja może identyfikować i wyświetlać szczegółowe informacje o punktach orientacyjnych w badanym obszarze, wzbogacając wrażenia użytkowników o wiedzę lokalną.
  • Funkcja Autocomplete pomaga użytkownikom wyszukiwać konkretne lokalizacje lub obszary zainteresowań.

CesiumJS

CesiumJS odpowiada za renderowanie i wyświetlanie kuli ziemskiej w 3D w wysokiej rozdzielczości. Obsługuje wczytywanie i wizualizację fotorealistycznych kafelków 3D Google, które zapewniają model siatki 3D budynków i terenu.

Zarządzanie kamerą: CesiumJS udostępnia narzędzia do sterowania położeniem, orientacją i ruchem kamery. Obejmuje to m.in.:

  • Ustawianie początkowego punktu widzenia, aby po wczytaniu aplikacji skupić się na określonej dzielnicy.
  • Implementowanie dynamicznych ruchów kamery, takich jak automatyczne animacje orbit do eksploracji.
  • Obsługa interakcji użytkowników z kulą ziemską, jeśli takie funkcje są dostępne (przesuwanie, powiększanie, obracanie).

Dowiedz się, jak fotorealistyczne kafelki 3D mogą współpracować z rendererem kafelków 3D.

Kluczowe elementy

Aplikacja jest podzielona na 2 różne aplikacje:

  • aplikację administratora
  • aplikację demonstracyjną.

Ten diagram przedstawia różnice i zależności między tymi 2 aplikacjami:

obraz

Warto dokładniej przyjrzeć się każdej aplikacji:

Aplikacja administracyjna

Ta aplikacja udostępnia przyjazny dla użytkownika interfejs, który pozwala dostosować środowisko 3D:

  • Wyszukiwanie lokalizacji : użyj zintegrowanego paska wyszukiwania Autocomplete Google Maps Platform, aby znaleźć obszar, który chcesz zaprezentować. Gdy wybierzesz lokalizację, kamera płynnie przeniesie się do tego obszaru.

  • Kamera: dostosuj prędkość ruchu kamery i typ orbitowania, aby utworzyć wybrane środowisko.

  • Miejsca (punkty orientacyjne): określ gęstość, promień wyszukiwania i typy punktów orientacyjnych (np. restauracje, kawiarnie, zabytki), które chcesz wyróżnić.

Użyj tej aplikacji, aby dostosować środowisko do potrzeb użytkowników.

Szczegółowy opis wszystkich dostosowań 3D Area Explorer.

Aplikacja demonstracyjna

Jest to końcowa aplikacja dla użytkowników, która wczytuje konfigurację utworzoną w aplikacji administratora. W tym immersyjnym środowisku 3D użytkownicy będą mogli poznawać wybrane obszary i odkrywać wyróżnione przez Ciebie miejsca.

Po dostosowaniu wyglądu i stylu za pomocą aplikacji administratora możesz pobrać konfigurację i uruchomić niestandardową aplikację z kodu źródłowego.

Jakość usług

obraz

Oto niektóre z najważniejszych funkcji aplikacji:

  1. Użytkownicy mogą interaktywnie poznawać obszar w 3D, w tym budynki, zabytki i teren.
  2. Użytkownicy mogą wyszukiwać i odkrywać miejsca w pobliżu (np. muzea, parki, restauracje).
  3. Po wybraniu miejsca użytkownicy mogą wyświetlić szczegółowe informacje lub narracje związane z tą lokalizacją.

  4. Deweloperzy mogą personalizować swoje wrażenia z eksploracji za pomocą ustawień i elementów sterujących (jeśli używają aplikacji administratora).

  5. Automatyczna rotacja jest włączona, co pozwala kamerze automatycznie obracać się wokół środka wybranego obszaru.

Wymagania wstępne

  1. Klucz interfejsu API Map Google: potrzebujesz prawidłowego klucza interfejsu API z włączonymi tymi interfejsami API:

  2. Serwer WWW: aplikację możesz udostępniać z:

    • lokalnego serwera WWW (np. za pomocą Node.js, http-server),
    • statycznej usługi hostingu WWW (aplikacja zawiera plik Dockerfile).

Szczegółowy opis opcji wdrożenia znajdziesz w sekcji readme projektu GitHub.

Wdrożenie

Aplikację możesz wdrożyć jako aplikację Node.js lub kontener Dockera w dowolnym środowisku kontenerowym, takim jak GKE czy GAE. Hostowana wersja demonstracyjna korzysta z tej architektury:

obraz

  • W tej architekturze kod znajduje się w projekcie GitHub.
  • Cloud Build pobiera kod przy każdym wypchnięciu do głównej gałęzi i uruchamia operację kompilacji.
  • W ramach kompilacji wstrzykuje klucz interfejsu API i tworzy obraz, który jest następnie przechowywany w Artifact Registry.
  • Na koniec wdraża najnowszy stabilny obraz z Artifact Registry w Cloud Run.
  • Mamy też kilka testów stanu i monitorowania, które sprawdzają stan wdrożonych aplikacji.

Informacje rozliczeniowe

Rozwiązanie 3D Area Explorer korzysta z usług Google Maps Platform, aby zapewnić immersyjne, dynamiczne wrażenia. Korzystanie z niektórych interfejsów API może wiązać się z opłatami. Oto przegląd interfejsów API i linków do cennika.

Google Maps Platform – 3D Tiles API:

Rozwiązanie Storytelling wykorzystuje interfejs 3D Tiles API, aby wzbogacić wrażenia wizualne o dane geoprzestrzenne. Szczegółowe informacje o cenach interfejsu 3D Tiles API znajdziesz w cenniku Google Maps Platform – 3D Tiles API Pricing.

Google Maps Platform – Places API:

Interfejs Places API jest używany do danych opartych na lokalizacji, co pozwala wzbogacić wrażenia z narracji. Aby dowiedzieć się więcej o kosztach związanych z interfejsem Google Places API,odwiedź stronę Google Maps Platform – Places API Pricing.

Google Maps Platform – Autocomplete API:

Funkcja Autocomplete zwiększa interakcję z użytkownikiem. Szczegółowe informacje o cenach interfejsu API Autouzupełniania miejsc w Mapach Google znajdziesz na stronie Cennik Google Maps Platform - Places Autocomplete Pricing.

CesiumJS:

CesiumJS służy do wizualizacji kuli ziemskiej w 3D. Sam CesiumJS jest oprogramowaniem open source, ale dodatkowe funkcje lub usługi mogą wiązać się z opłatami. Informacje o ofertach premium znajdziesz w dokumentacji CesiumJS.

Koniecznie zapoznaj się ze szczegółami cen każdego interfejsu API, ponieważ opłaty są naliczane indywidualnie na podstawie wykorzystania. Pamiętaj, że Google Maps Platform oferuje poziom bezpłatny z określoną ilością bezpłatnego wykorzystania, a szczegóły cen mogą się różnić w zależności od takich czynników jak liczba żądań i region użytkowania.

Aby uzyskać najdokładniejsze i najbardziej aktualne informacje o kosztach korzystania z Google Maps Platform i CesiumJS, zawsze sprawdzaj oficjalne strony z cennikiem. Aby skutecznie zarządzać powiązanymi wydatkami i je rozumieć, przestrzegaj warunków korzystania z tych usług.

Podsumowanie

W tym dokumencie znajdziesz omówienie możliwości, komponentów, jakości usług i wymagań technicznych 3D Area Explorer.

Dzięki fotorealistycznym kafelkom 3D Google i interfejsowi Places API rozwiązanie umożliwia wirtualne poznawanie dzielnic, odkrywanie punktów orientacyjnych i poznawanie lokalnej historii.

Niezależnie od tego, czy chcesz zaprezentować obszar, ułatwić jego poznawanie czy promować cyfrowe opowiadanie historii, 3D Area Explorer to platforma, która zachwyca wizualnie.

Wypróbuj wersję demonstracyjną i dostosuj ją za pomocą aplikacji administracyjnej, aby stworzyć atrakcyjne i informacyjne środowisko 3D.