Pierwsze kroki z funkcją 3D Area Explorer

obraz

Przegląd

Eksplorator obszarów 3D oferuje całkowicie nowy sposób odkrywania i poznawania lokalizacji. To rozwiązanie wykorzystuje możliwości Realistycznych kafelków 3D w Google Maps Platform oraz interfejsu Places API do tworzenia atrakcyjnych, interaktywnych środowisk 3D.

Eksplorator obszarów 3D służy do różnych celów:

  • Ulepszona eksploracja obszaru: użytkownicy mogą wirtualnie zwiedzać okolice z dużą ilością szczegółów wizualnych, uzyskując informacje o lokalnych obiektach i punktach orientacyjnych.

  • Promowanie treści związanych z lokalizacją: możliwość umieszczania ciekawych miejsc w rozbudowanych opisach umożliwia tworzenie treści opartych na narracji, które uczą i informują użytkowników o konkretnych lokalizacjach.

  • Inspirowanie do programowania z wykorzystaniem funkcji 3D Map Google: ukazuje potencjał danych map 3D od Google do tworzenia wciągających, interaktywnych map.

Pierwsze kroki:

Włącz

Kluczowe technologie

W tym rozwiązaniu wykorzystano 2 kluczowe technologie:

Interfejsy API Google Maps Platform:

Aby wygenerować mapę podstawową i dane do utworzenia tego środowiska, używamy kilku interfejsów API z Google Maps Platform:

  • Realistyczne kafelki 3D w Mapach Google: modele 3D budynków i terenu w wysokiej rozdzielczości nadają realistyczny i atrakcyjny wizualnie obraz miejskich obiektów.
  • Places API: aplikacja może rozpoznawać i wyświetlać szczegółowe informacje o ciekawych miejscach na badanym obszarze, wzbogacając wrażenia użytkowników o informacje o okolicy.
  • Autouzupełnianie pomaga użytkownikom wyszukiwać określone lokalizacje lub interesujące ich obszary.

CesiumJS

CesiumJS odpowiada za renderowanie i wyświetlanie kuli ziemskiej w 3D w wysokiej rozdzielczości. Zajmuje się wczytywaniem i wizualizacją udostępnionych przez Google fotorealistycznych kart 3D, które zapewniają siatkowy model 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 podczas ładowania aplikacji skupić się na określonej okolicy.
  • Zastosowanie dynamicznych ruchów kamery, na przykład animacji automatycznych orbit, których celem jest eksploracja.
  • obsługi interakcji użytkownika z kulą ziemską, jeśli dostępne są takie funkcje (przesuwanie, powiększanie, obracanie);

Dowiedz się, jak kafelki 3D ze zdjęciami 3D mogą działać z wykorzystaniem funkcji renderowania kafelków 3D.

Najważniejsze elementy

Aplikacja jest podzielona na dwie różne aplikacje:

  • Aplikacja administratora
  • Aplikacja w wersji demonstracyjnej

Ten diagram przedstawia przegląd różnic i korelacji między tymi 2 aplikacjami:

obraz

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

Aplikacja administratora

Ma ona łatwy w użyciu interfejs, który umożliwia dostosowanie wyglądu 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 poleci do tego miejsca.

  • Kamera:dostosuj prędkość ruchu kamery i typ orbity, by utworzyć wybrany obraz.

  • Miejsca (POI): określ gęstość, promień wyszukiwania i rodzaje ciekawych miejsc (np. restauracji, kawiarni, punktów orientacyjnych).

Za pomocą tej aplikacji możesz dostosować sposób obsługi do potrzeb użytkowników.

Opis wszystkich dostosowań znajdziesz dostosowania Eksploratora obszarów 3D.

Aplikacja w wersji demonstracyjnej

Jest to ostatnia aplikacja widoczna dla użytkowników, która wczytuje konfigurację utworzoną przez Ciebie w tej aplikacji. To immersyjne środowisko 3D pozwala użytkownikom przeglądać wybrane obszary i odkrywać miejsca, które zostały przez Ciebie oznaczone.

Po dostosowaniu wyglądu i stylu za pomocą aplikacji Admin możesz pobrać konfigurację i uruchomić aplikację niestandardową z kodu źródłowego.

Zadowolenie użytkowników

obraz

Najważniejsze funkcje aplikacji to:

  1. Użytkownicy mogą interaktywnie eksplorować obszar w 3D, w tym budynki, punkty orientacyjne i ukształtowanie terenu.
  2. Użytkownicy mogą wyszukiwać i odkrywać miejsca w pobliżu (np. muzea, parki, restauracje).
  3. Po wybraniu miejsca użytkownik może zobaczyć szczegółowe informacje na jego temat lub powiązane z nim historie.

  4. Deweloperzy mogą dostosować eksplorację do swoich potrzeb za pomocą ustawień i opcji (jeśli korzystają z aplikacji Administracja).

  5. Autoobracanie jest włączone, dzięki czemu aparat automatycznie obraca się wokół środka wybranego obszaru.

Wymagania wstępne

  1. Klucz interfejsu API Map Google: będziesz potrzebować prawidłowego klucza interfejsu API z włączonymi następującymi interfejsami API:

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

    • Lokalny serwer WWW (np. Node.js lub http-server)
    • Statyczna usługa hostingu WWW (do aplikacji jest dołączony plik Dockerfile).

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

Wdrożenie

Możesz ją wdrożyć jako aplikację węzła lub kontener Dockera w dowolnym środowisku kontenera, 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 wypychaniu do serwera głównego i uruchamia operację kompilacji.
  • W ramach kompilacji wstrzykiuje się klucz interfejsu API i tworzy obraz, który jest następnie zapisywany w Artifact Registry.
  • Na koniec wdraża w Cloud Run najnowszy stabilny obraz z Artifact Registry.
  • Przeprowadzamy też kontrole stanu i monitorujemy stan wdrożonych aplikacji.

Informacje rozliczeniowe

Eksplorator obszarów 3D korzysta z usług Google Maps Platform, aby zapewnić realistyczne i dynamiczne wrażenia. Za niektóre interfejsy API mogą być naliczane opłaty. Oto omówienie interfejsów API i linki do cen.

Google Maps Platform – 3D Tiles API:

Rozwiązanie Storytelling wykorzystuje interfejs 3D Tiles API, aby poprawić wrażenia wizualne za pomocą danych geoprzestrzennych. Szczegółowe informacje o cenach interfejsu 3D Tiles API znajdziesz w cenniku interfejsu 3D Tiles API w Google Maps Platform.

Google Maps Platform – Places API:

Interfejs Places API stosuje się w przypadku danych opartych na lokalizacji, co pozwala wzbogacać historie o atrakcyjne elementy. Aby poznać koszty związane z interfejsem Google Places API,zapoznaj się z cennikiem interfejsu Places API w Google Maps Platform.

Google Maps Platform – Autocomplete API:

Funkcja autouzupełniania ułatwia interakcję użytkowników. Cennik interfejsu API autouzupełniania w Mapach Google znajdziesz na stronie Google Maps Platform z cennikiem autouzupełniania w Miejscach.

CesiumJS:

CesiumJS służy do wizualizacji kuli ziemskiej w 3D. CesiumJS to system open source, jednak związane z nimi 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 dotyczące cen każdego interfejsu API, ponieważ opłaty są ustalane indywidualnie na podstawie wykorzystania. Pamiętaj, że Google Maps Platform oferuje poziom bezpłatny z pewną wartością użytkowania i pewną ilością danych, a ceny mogą się różnić w zależności od czynników, takich jak liczba żądań i region użytkowania.

Najbardziej dokładne i aktualne informacje o kosztach korzystania z Google Maps Platform i CesiumJS zawsze znajdziesz na oficjalnych stronach z cenami. Zadbaj o przestrzeganie warunków korzystania z usług określonych przez te usługi, aby móc skutecznie zarządzać powiązanymi wydatkami i je analizować.

Podsumowanie

Niniejszy dokument zawiera omówienie możliwości i komponentów eksploratora obszaru 3D, jego wygody oraz wymagań technicznych.

Dzięki wykorzystaniu funkcji Photorealistycznych kafelków 3D Google i interfejsu Places API umożliwia wirtualne eksplorowanie okolic, odkrywanie ciekawych miejsc i poznawanie historii lokalnej.

Niezależnie od tego, czy prezentujesz okolicę, poszerzasz eksplorację, czy promujesz cyfrowe opowiadanie historii, 3D Area Explorer oferuje niesamowitą wizualnie platformę.

Wypróbuj wersję demonstracyjną i dostosuj ją za pomocą aplikacji Admin, aby tworzyć ciekawe i wartościowe funkcje 3D.