
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 Platform i interfejsu 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:

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.
Odkryj biuro Google w Chicago, poruszając się powoli po wyznaczonej ścieżce.
Zobacz gęsty widok atrakcji turystycznych w okolicach Las Vegas Strip.
Teraz zwiedzaj Las Vegas, podążając szybką sinusoidalną ścieżką kamery
Zwiedź Wielki Kanion i zobacz wszystkie najważniejsze atrakcje turystyczne.
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

Oto niektóre z najważniejszych funkcji aplikacji:
- Użytkownicy mogą interaktywnie poznawać obszar w 3D, w tym budynki, punkty orientacyjne 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 opisy związane z tą lokalizacją.
Deweloperzy mogą personalizować eksplorowanie za pomocą ustawień i elementów sterujących (jeśli korzystają z aplikacji administratora).
Automatyczne obracanie jest włączone, co umożliwia automatyczne obracanie kamery wokół środka wybranego obszaru.
Wymagania wstępne
Klucz interfejsu API Map Google: musisz mieć prawidłowy klucz interfejsu API z włączonymi tymi interfejsami API:
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:

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