Wprowadzenie do narzędzia 3D Area Explorer

obraz

Przegląd

Rozwiązanie 3D Area Explorer 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 do tworzenia atrakcyjnych, interaktywnych środowisk 3D.

Eksplorator obszaru 3D ma wiele zastosowań:

  • Ulepszone odkrywanie obszaru: użytkownicy mogą wirtualnie odkrywać okolice z wysokim poziomem szczegółowości wizualnej, uzyskując informacje o lokalnych obiektach i punktach orientacyjnych.

  • Promowanie narracji związanych z lokalizacją: możliwość uwzględniania ciekawych miejsc ze szczegółowymi opisami pozwala tworzyć narracje, które edukują i informują użytkowników o konkretnych lokalizacjach.

  • Inspirowanie rozwoju dzięki możliwościom 3D Map Google: pokazuje potencjał danych mapowania 3D Google w tworzeniu immersyjnych, interaktywnych map.

Pierwsze kroki

Włącz

Kluczowe technologie

To rozwiązanie wykorzystuje 2 główne technologie:

Interfejsy API Google Maps Platform

Aby utworzyć tę funkcję, używamy kilku interfejsów API z Google Maps Platform, które pozwalają nam uzyskać mapę podstawową i dane:

  • Fotorealistyczne kafelki 3D w Mapach Google: modele 3D budynków i terenu w wysokiej rozdzielczości zapewniają realistyczne i atrakcyjne wizualnie odwzorowanie środowiska miejskiego.
  • Places API: aplikacja może identyfikować i wyświetlać szczegółowe informacje o ciekawych miejscach na danym obszarze, wzbogacając wrażenia użytkownika o wiedzę o lokalnych atrakcjach.
  • Autouzupełnianie pomaga użytkownikom wyszukiwać konkretne lokalizacje lub obszary zainteresowania.

CesiumJS

CesiumJS odpowiada za renderowanie i wyświetlanie globusa 3D w wysokiej rozdzielczości. Zajmuje się wczytywaniem 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 kontrolowania pozycji, orientacji i ruchu kamery. Obejmuje to m.in.:

  • ustawienie początkowego punktu widzenia, aby po wczytaniu aplikacji skupić się na określonej okolicy;
  • wdrażanie dynamicznych ruchów kamery, takich jak automatyczne animacje orbity, które ułatwiają eksplorację;
  • obsługę 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 renderowaniem kafelków 3D.

Kluczowe elementy

Aplikacja jest podzielona na 2 różne aplikacje:

  • Aplikacja administratora
  • Aplikacja demonstracyjna

Ten diagram przedstawia różnice i zależności między tymi 2 aplikacjami:

obraz

Warto dokładniej zbadać każdą aplikację:

Aplikacja administratora

Ta aplikacja ma przyjazny dla użytkownika interfejs, który umożliwia dostosowanie widoku 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 szybkość ruchu kamery i typ orbity, aby uzyskać wybrany efekt.

  • Miejsca (ciekawe miejsca): określ gęstość, promień wyszukiwania i typy ciekawych miejsc (np. restauracje, kawiarnie, zabytki), które chcesz wyróżnić.

Użyj tej aplikacji, aby dostosować sposób korzystania z usługi przez użytkowników.

Szczegółowy opis wszystkich opcji dostosowywania znajdziesz w artykule Dostosowywanie Eksploratora obszaru 3D.

Aplikacja demonstracyjna

Jest to aplikacja dla użytkowników, która wczytuje konfigurację utworzoną w aplikacji administratora. W tym immersyjnym środowisku 3D użytkownicy będą mogli odkrywać wybrane obszary i 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

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ą spersonalizować sposób przeglądania za pomocą ustawień i elementów sterujących (jeśli korzystają z aplikacji administratora).

  5. Automatyczne obracanie jest włączone, co pozwala kamerze automatycznie obracać się wokół środka wybranego obszaru.

Wymagania wstępne

  1. Klucz interfejsu API Map Google: potrzebujesz prawidłowego klucza interfejsu API z włączonymi tymi interfejsami API:

  2. Serwer WWW: aplikację możesz udostępniać z:

    • Lokalny serwer WWW (np. korzystający z Node.js, http-server)
    • statyczna usługa hostingu WWW (aplikacja zawiera plik Dockerfile),

Szczegółowy opis opcji wdrażania znajdziesz w sekcji readme projektu GitHub.

Wdrożenie

Możesz wdrożyć aplikację jako aplikację węzła lub kontener Dockera w dowolnym środowisku kontenerów, 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 Artifact Registry.
  • Na koniec wdraża najnowszy stabilny obraz z Artifact Registry w Cloud Run.
  • Mamy też kilka kontroli stanu i monitorowanie, które sprawdzają stan wdrożonych aplikacji.

Informacje rozliczeniowe

Rozwiązanie 3D Area Explorer korzysta z usług Google Maps Platform, aby zapewniać dynamiczne i realistyczne wrażenia. Z niektórymi interfejsami mogą wiązać się opłaty. Oto przegląd interfejsów API i linki do cen.

Google Maps Platform – 3D Tiles API

Rozwiązanie 3D Area Explorer wykorzystuje interfejs 3D Tiles API, aby ulepszyć wrażenia wizualne dzięki danym geoprzestrzennym. Szczegółowe informacje o cenach interfejsu 3D Tiles API znajdziesz w artykule Ceny interfejsu 3D Tiles API na stronie Google Maps Platform.

Google Maps Platform – Places API

Interfejs Places API jest używany do uzyskiwania danych o lokalizacji, co wzbogaca informacje dostępne w Eksploratorze obszaru 3D. 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 - Autocomplete API

Funkcja autouzupełniania ułatwia interakcję z użytkownikiem. Szczegółowe informacje o cenach interfejsu Google Maps Autocomplete API znajdziesz na stronie Ceny autouzupełniania miejsc w Google Maps Platform.

CesiumJS

CesiumJS służy do wizualizacji kuli ziemskiej w 3D. CesiumJS jest oprogramowaniem open source, ale dodatkowe funkcje lub usługi mogą wiązać się z kosztami. Informacje o ofertach premium znajdziesz w dokumentacji CesiumJS.

Ważne jest, aby sprawdzić szczegóły cen poszczególnych interfejsów API, ponieważ opłaty są ustalane indywidualnie na podstawie wykorzystania. Pamiętaj, że Google Maps Platform oferuje poziom bezpłatny z określoną ilością wykorzystania bez opłat, a szczegóły cenowe 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 cennikami. Aby skutecznie zarządzać powiązanymi wydatkami i je rozumieć, upewnij się, że przestrzegasz warunków określonych przez te usługi.

Podsumowanie

Ten dokument zawiera omówienie możliwości, komponentów, wygody użytkownika i wymagań technicznych Eksploratora obszaru 3D.

Dzięki wykorzystaniu fotorealistycznych kafelków 3D i interfejsu Places API Google umożliwia wirtualne zwiedzanie dzielnic, odkrywanie ciekawych miejsc i poznawanie lokalnej historii.

Niezależnie od tego, czy chcesz zaprezentować dany obszar, ułatwić jego eksplorację czy promować cyfrowy marketing narracyjny, 3D Area Explorer to platforma, która zapewnia oszałamiające wrażenia wizualne.

Wypróbuj wersję demonstracyjną i dostosuj ją za pomocą aplikacji administratora, aby stworzyć atrakcyjne i pouczające środowisko 3D.