
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:

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.
Poznaj biuro Google w Chicago, podążając powolną ścieżką kamery.
Zobacz gęsty widok atrakcji turystycznych wokół Las Vegas Strip.
Teraz poznaj Las Vegas, podążając szybką sinusoidalną ścieżką kamery.
Poznaj Wielki Kanion ze wszystkimi najważniejszymi atrakcjami turystycznymi.
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

Niektóre z najważniejszych funkcji aplikacji:
- Użytkownicy mogą interaktywnie zwiedzać obszar w 3D, w tym budynki, zabytki i teren.
- Użytkownicy mogą wyszukiwać i odkrywać miejsca w pobliżu (np. muzea, parki, restauracje).
Po wybraniu miejsca użytkownicy mogą wyświetlić szczegółowe informacje lub narracje związane z tą lokalizacją.
Deweloperzy mogą personalizować wrażenia z eksploracji za pomocą ustawień i elementów sterujących (jeśli używają aplikacji administratora).
Automatyczna rotacja jest włączona, co pozwala kamerze automatycznie obracać się wokół środka wybranego obszaru.
Wymagania wstępne
Klucz interfejsu API Map Google: potrzebujesz prawidłowego klucza interfejsu API z włączonymi tymi interfejsami:
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:

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