
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 Platform i interfejsu Places API, aby tworzyć atrakcyjne, interaktywne środowiska 3D.
Eksplorator obszarów 3D ma wiele zastosowań:
Ułatwianie poznawania okolicy: użytkownicy mogą wirtualnie poznawać dzielnice z dużą ilością szczegółów wizualnych, uzyskując informacje o lokalnych atrakcjach i charakterystycznych miejscach.
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 Google Maps 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ę 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 odwzorowanie ś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 atrakcjach.
- Funkcja autouzupełniania pomaga użytkownikom wyszukiwać określone 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 umożliwiające kontrolowanie położenia, orientacji i ruchu 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:

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żywaj tej aplikacji, aby dostosowywać usługi do potrzeb użytkowników.
Odkryj biuro Google w Chicago, korzystając z powolnej ścieżki kamery.
Zobacz gęsty widok atrakcji turystycznych w okolicach Las Vegas Strip.
Teraz zwiedzaj Las Vegas, korzystając z szybkiej sinusoidalnej trasy 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ż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

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 administracyjnej).
Automatyczne obracanie jest włączone, co umożliwia automatyczne obracanie kamery wokół środka wybranego obszaru.
Wymagania wstępne
Klucz interfejsu API Google Maps: musisz mieć prawidłowy klucz interfejsu API z włączonymi tymi interfejsami API:
Serwer WWW: możesz udostępniać aplikację z jednego z tych źródeł:
- Lokalny serwer WWW (np.z użyciem Node.js lub 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:

- 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.
- Podczas kompilacji wstrzykuje klucz API i tworzy obraz, który jest następnie zapisywany 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 korzysta z interfejsu 3D Tiles API, aby wzbogacać wizualizacje danymi geoprzestrzennymi. Szczegółowe informacje o cenach interfejsu 3D Tiles API znajdziesz w sekcji Cennik interfejsu 3D Tiles API na stronie Google Maps Platform.
Google Maps Platform – Places API:
Interfejs Places API jest używany w przypadku danych opartych na lokalizacji, co pozwala wzbogacać opowiadane historie. Aby dowiedzieć się więcej o kosztach związanych z interfejsem Google Places API,odwiedź stronę Google Maps Platform – cennik interfejsu Places API.
Google Maps Platform – interfejs Autocomplete API:
Funkcja autouzupełniania zwiększa interaktywność. Szczegóły dotyczące cen usługi Google Maps Autocomplete API znajdziesz na platformie Google Maps w sekcji Cennik usługi Places Autocomplete.
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ć 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.