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 Photorealistic 3D Tiles i Places API do tworzenia wciągających, interaktywnych środowisk 3D.

3D Area Explorer ma wiele zastosowań:

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

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

  • Inspirowanie do tworzenia aplikacji z wykorzystaniem 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 Google Maps: 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 POI w badanym obszarze, wzbogacając wrażenia użytkowników o lokalną wiedzę.
  • Autouzupełnianie 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 pozycją, 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żytkownika 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 komponenty

Aplikacja jest podzielona na 2 różne aplikacje:

  • aplikację administratora
  • aplikację w wersji demonstracyjnej.

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ć wrażenia 3D:

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

  • Kamera: dostosuj prędkość ruchu kamery i typ orbitowania, aby stworzyć wybrane wrażenia wizualne.

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

Użyj tej aplikacji, aby dostosować wrażenia użytkowników.

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

Aplikacja w wersji demonstracyjnej

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

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

Jakość usług

obraz

Niektóre z najważniejszych funkcji aplikacji:

  1. Użytkownicy mogą interaktywnie zwiedzać 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ć 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:

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

    • lokalnego serwera WWW (np. za pomocą Node.js, http-server);
    • statycznej usługi hostingu stron internetowych (aplikacja jest dostarczana z plikiem 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 lub 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łównego repozytorium i uruchamia operację kompilacji.
  • W ramach kompilacji wstawia 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 linki do cenników.

Google Maps Platform – 3D Tiles API:

Rozwiązanie Storytelling wykorzystuje interfejs 3D Tiles API do wzbogacania wrażeń wizualnych 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 obsługi danych opartych na lokalizacji, co pozwala dodawać bogate informacje do 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 autouzupełniania zwiększa interaktywność. Szczegółowe informacje o cenach interfejsu Google Maps Autocomplete API znajdziesz na stronie Cennik Google Maps Platform - Places Autocomplete Pricing.

CesiumJS:

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

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

Aby uzyskać najdokładniejsze i najbardziej aktualne informacje o kosztach korzystania z Google Maps Platform i CesiumJS, zawsze sprawdzaj oficjalne strony z cennikami. 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 zwiedzanie dzielnic, odkrywanie ciekawych miejsc 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 administratora, aby stworzyć wciągające i informacyjne wrażenia 3D.