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. To rozwiązanie wykorzystuje możliwości fotorealistycznych kafelków 3D Google Maps Platforminterfejsu Places API do tworzenia atrakcyjnych, interaktywnych środowisk 3D.

Eksplorator obszarów 3D ma wiele zastosowań:

  • Ułatwianie odkrywania obszarów: użytkownicy mogą wirtualnie zwiedzać okolice z dużą ilością szczegółów wizualnych, uzyskując informacje o lokalnych atrakcjach i punktach orientacyjnych.

  • Promowanie narracji opartych na lokalizacji: możliwość uwzględniania punktów POI (Points of Interest) z bogatymi opisami umożliwia tworzenie narracji, które edukują użytkowników i dostarczają im informacji o konkretnych lokalizacjach.

  • Inspiruj do tworzenia aplikacji za pomocą funkcji Map Google 3D: pokazuje potencjał danych mapowania 3D Google w zakresie tworzenia immersyjnych, interaktywnych map.

Pierwsze kroki:

Włącz

Kluczowe technologie

To rozwiązanie jest oparte na 2 kluczowych technologiach:

Interfejsy API Google Maps Platform:

Aby uzyskać mapę podstawową i dane potrzebne do utworzenia tej funkcji, korzystamy z kilku interfejsów API Google Maps Platform:

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

CesiumJS

Za renderowanie i wyświetlanie trójwymiarowego globu w wysokiej rozdzielczości odpowiada CesiumJS. Biblioteka ta obsługuje wczytywanie i wizualizację fotorealistycznych kafelków 3D Google, które zawierają model siatkowy 3D budynków i terenu.

Zarządzanie kamerą: CesiumJS udostępnia narzędzia do sterowania pozycją, orientacją i ruchem kamery. Obejmuje to m.in.:

  • Ustawienie początkowego punktu widzenia, aby po wczytaniu aplikacji skupić się na określonej okolicy.
  • Wprowadzanie dynamicznych ruchów kamery, takich jak automatyczne animacje orbitowania, które ułatwiają eksplorację.
  • obsługi interakcji użytkownika z globusem, jeśli takie funkcje są dostępne (panoramowanie, powiększanie, obracanie);

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

Kluczowe komponenty

Aplikacja jest podzielona na 2 różne aplikacje:

  • Aplikacja administratora
  • Aplikacja 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 administratora

Ta aplikacja ma przyjazny interfejs, który umożliwia dostosowywanie wrażeń 3D:

  • Wyszukiwanie lokalizacji : użyj zintegrowanego paska wyszukiwania Autouzupełnianie w Google Maps Platform, aby znaleźć obszar, który chcesz zaprezentować. Po wybraniu lokalizacji kamera płynnie przeleci w to miejsce.

  • Kamera: dostosuj szybkość ruchu kamery i typ orbity, aby uzyskać wybrane wrażenia wizualne.

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

Użyj tej aplikacji, aby dostosować interfejs dla użytkowników.

Szczegółowy opis wszystkich dostosowań znajdziesz w sekcji Dostosowania Eksploratora obszaru 3D.

Aplikacja w wersji demonstracyjnej

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

Po dostosowaniu wyglądu i stylu za pomocą aplikacji administratora, możesz pobrać konfigurację i uruchomić aplikację niestandardową 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, punkty orientacyjne 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 opisy związane z tą lokalizacją.

  4. Deweloperzy mogą personalizować eksplorowanie za pomocą ustawień i elementów sterujących (jeśli korzystają z aplikacji administratora).

  5. Automatyczne obracanie jest włączone, co umożliwia automatyczne obracanie kamery wokół środka wybranego obszaru.

Wymagania wstępne

  1. Klucz interfejsu API Map Google: musisz mieć prawidłowy klucz interfejsu API z włączonymi tymi interfejsami API:

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

    • Lokalny serwer WWW (np. z użyciem Node.js, http-server)
    • statyczna usługa hostingu WWW (aplikacja jest dostarczana z plikiem Dockerfile);

Szczegółowy opis opcji wdrażania znajdziesz w sekcji readme projektu GitHub.

Wdrożenie

Aplikację możesz wdrożyć jako aplikację węzła 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 gałęzi głównej i uruchamia operację kompilacji.
  • W ramach kompilacji wstrzykuje klucz interfejsu API i tworzy obraz, który jest następnie przechowywany w rejestrze artefaktów.
  • Na koniec wdraża najnowszy stabilny obraz z Artifact Registry w Cloud Run.
  • Uruchamiamy też kontrole stanu i monitorowanie, aby sprawdzać stan wdrożonych aplikacji.

Informacje rozliczeniowe

Rozwiązanie 3D Area Explorer korzysta z usług Google Maps Platform, aby zapewnić dynamiczne i realistyczne wrażenia. Niektóre interfejsy API mogą wiązać się z opłatami. Poniżej znajdziesz omówienie interfejsów API i linki do informacji o cenach.

Google Maps Platform – 3D Tiles API:

Rozwiązanie Storytelling wykorzystuje interfejs 3D Tiles API, aby wzbogacać wizualizacje danymi geoprzestrzennymi. Szczegółowe informacje o cenach interfejsu 3D Tiles API znajdziesz w sekcji Google Maps Platform – cennik interfejsu 3D Tiles API.

Google Maps Platform – Places API:

Interfejs Places API jest używany do danych opartych na lokalizacji, co wzbogaca narrację. Aby dowiedzieć się więcej o kosztach związanych z interfejsem Miejsca API Google,odwiedź stronę Google Maps Platform – cennik interfejsu Miejsca API.

Google Maps Platform – interfejs API autouzupełniania:

Funkcja autouzupełniania zwiększa interaktywność. Szczegółowe informacje o cenach interfejsu Autocomplete API Map Google znajdziesz na stronie Google Maps Platform – cennik autouzupełniania miejsc.

CesiumJS:

Do wizualizacji kuli ziemskiej w 3D używamy CesiumJS. Sam CesiumJS jest oprogramowaniem typu open source, ale dodatkowe funkcje lub usługi mogą wiązać się z opłatami. Więcej informacji o ofertach premium znajdziesz w dokumentacji CesiumJS.

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

Najdokładniejsze i najbardziej aktualne informacje o kosztach korzystania z Google Maps Platform i CesiumJS znajdziesz zawsze na oficjalnych stronach z cennikiem. Zapewnij zgodność z warunkami określonymi przez te usługi, aby skutecznie zarządzać powiązanymi wydatkami i je rozumieć.

Podsumowanie

Ten dokument zawiera omówienie funkcji, komponentów, wrażeń użytkownika i wymagań technicznych eksploratora obszaru 3D.

Dzięki wykorzystaniu fotorealistycznych kafelków 3D Google i interfejsu Places API umożliwia wirtualne zwiedzanie dzielnic, odkrywanie ciekawych miejsc i poznawanie lokalnej historii.

Niezależnie od tego, czy chcesz zaprezentować obszar, ułatwić eksplorację czy promować cyfrowe opowiadanie historii, Eksplorator obszarów 3D to platforma, która zachwyca wizualnie.

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