
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:

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.
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 z najważniejszymi atrakcjami turystycznymi.
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

Oto niektóre z najważniejszych funkcji aplikacji:
- Użytkownicy mogą interaktywnie poznawać 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ć swoje 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 API:
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:

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