Wprowadzenie do narzędzia 3D Area Explorer

obraz

Przegląd

Rozwiązanie Eksplorator obszarów 3D daje 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 poznawać 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 3D Map Google: pokazuje potencjał danych map 3D Google w zakresie tworzenia realistycznych, interaktywnych map.

Pierwsze kroki:

Włącz

Kluczowe technologie

To rozwiązanie jest oparte na 2 głównych technologiach:

Interfejsy API Google Maps Platform:

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

  • Fotorealistyczne kafelki 3D w Mapach Google: modele 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 wiedzę użytkownika o lokalnych informacjach.
  • 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 dzielnicy.
  • Wprowadzenie 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 (przesuwanie, 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 środowiska 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 jej okolice.

  • 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żytkowników, która wczytuje konfigurację utworzoną w aplikacji administracyjnej. 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 administracyjnej możesz pobrać konfigurację i uruchomić aplikację niestandardową z kodu źródłowego.

Wygoda użytkowników

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 administracyjnej).

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

Wymagania wstępne

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

  2. Serwer WWW: możesz udostępniać aplikację z jednego z tych źródeł:

    • Lokalny serwer WWW (np. z użyciem Node.js, http-server)
    • statycznego 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ć wizualizację danych geoprzestrzennych. Szczegółowe informacje o cenach interfejsu 3D Tiles API znajdziesz w artykule 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 opowiadaną historię. 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 Autocomplete API:

Funkcja autouzupełniania zwiększa interaktywność. Szczegółowe informacje o cenach interfejsu Autocomplete API Map Google znajdziesz na stronie Google Maps Platform – Ceny 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 każdego interfejsu API, ponieważ opłaty są ustalane indywidualnie na podstawie użytkowania. Pamiętaj, że Google Maps Platform oferuje poziom bezpłatny, który pozwala na korzystanie z określonej ilości zasobów bezpłatnie. Szczegóły cen mogą się różnić w zależności od czynników takich jak liczba żądań i region użytkowania.

Najdokładniejsze i najbardziej aktualne informacje o kosztach korzystania z Google Maps Platform i CesiumJS znajdziesz na oficjalnych stronach z cennikiem. Aby skutecznie zarządzać powiązanymi wydatkami i je rozumieć, musisz przestrzegać warunków określonych przez te usługi.

Podsumowanie

Ten dokument zawiera omówienie możliwości, komponentów, interfejsu 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ć jakiś 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 administracyjnej, aby stworzyć atrakcyjne i informacyjne środowisko 3D.