Konfiguracja

Na tej stronie dowiesz się, co musisz zrobić, aby rozpocząć tworzenie aplikacji za pomocą pakietu Maps 3D SDK na iOS. Proces konfiguracji obejmuje skonfigurowanie projektu Google Cloud i interfejsu API do użycia z pakietem SDK, a następnie skonfigurowanie projektu Xcode. Wykonaj te czynności, zanim dodasz do aplikacji pierwszą mapę 3D.

Wymagania wstępne

Aby korzystać z pakietu Maps 3D SDK na iOS, Twój projekt i urządzenia docelowe muszą spełniać te wymagania:

• Minimalna wersja iOS: docelowa wersja iOS to 16.0 lub nowsza.
• Xcode: Xcode w wersji 16.0 lub nowszej.

Konfigurowanie projektu w chmurze Google Cloud i klucza interfejsu API

Zanim zaczniesz tworzyć aplikacje za pomocą pakietu Maps 3D SDK na iOS, musisz skonfigurować projekt w chmurze Google Cloud i klucz interfejsu API do użycia z tym pakietem. Aby to zrobić, wykonaj te czynności:

Krok 1

Konsola

1. W konsoli Google Cloud na stronie selektora projektów kliknij Utwórz projekt, aby rozpocząć tworzenie nowego projektu Cloud.

   Otwórz stronę selektora projektów

2. Sprawdź, czy w projekcie Cloud włączone są płatności. Sprawdź, czy w projekcie są włączone płatności.

   Google Cloud oferuje bezpłatny okres próbny. Okres próbny kończy się po upływie 90 dni lub po naliczeniu na koncie opłat w wysokości 300 USD (w zależności od tego, co nastąpi wcześniej). Możesz zrezygnować w każdej chwili. Więcej informacji znajdziesz w artykułach o środkach na koncie rozliczeniowym i rozliczeniach.

Pakiet SDK Cloud

gcloud projects create "PROJECT"

Więcej informacji o pakiecie SDK Google Cloud, instalacji pakietu SDK Cloud i tych poleceniach:

• gcloud projects create

Uwaga: jeśli zasoby utworzone podczas wykonywania ćwiczenia nie będą Ci później potrzebne, nie wybieraj istniejącego projektu, tylko utwórz nowy. Po jej zakończeniu możesz usunąć projekt wraz ze wszystkimi zasobami, które są z nim powiązane.

Krok 2

Aby korzystać z Google Maps Platform, musisz włączyć interfejsy API lub pakiety SDK, których chcesz używać w projekcie.

Pamiętaj, że niektóre integracje wymagają włączenia wielu interfejsów API lub pakietów SDK. Jeśli nie wiesz, które interfejsy API lub pakiety SDK włączyć, użyj Eksploratora możliwości lub zapoznaj się z dokumentacją interfejsu API lub pakietu SDK, którego chcesz użyć.

Aby włączyć co najmniej 1 interfejs API lub pakiet SDK:

Konsola

1. Aby zobaczyć interfejsy API i pakiety SDK Google Maps Platform, które możesz włączyć, otwórz stronę Biblioteka interfejsów API Map Google w konsoli Cloud:

   Otwórz stronę Biblioteka interfejsów API Map Google.

2. Kliknij interfejs API lub pakiet SDK, który chcesz włączyć.
   • Jeśli na przycisku jest napis WŁĄCZ, kliknij go, aby włączyć interfejs API lub pakiet SDK.
   • Jeśli na przycisku widnieje napis ZARZĄDZAJ, interfejs API lub pakiet SDK jest już włączony i nie musisz nic robić.
   • Kliknięcie dowolnego przycisku spowoduje wyświetlenie panelu interfejsu API lub pakietu SDK. (Kliknij przycisk WYŁĄCZ, aby usunąć interfejs API lub pakiet SDK z tego projektu).

Pakiet SDK Cloud

To polecenie włącza wszystkie interfejsy API Map, Tras i Miejsc:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Więcej informacji o pakiecie SDK Google Cloud, instalacji pakietu SDK Cloud i tych poleceniach:

• gcloud services enable
• gcloud services disable

Aby włączyć interfejsy API środowiska, użyj tego polecenia:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

Uwaga: włączenie Places API powoduje też włączenie biblioteki Miejsc, Maps JavaScript API, Places SDK na Androida i Places SDK na iOS.

Krok 3

Ten krok dotyczy tylko procesu tworzenia klucza interfejsu API. Jeśli używasz klucza interfejsu API w środowisku produkcyjnym, zdecydowanie zalecamy jego ograniczenie. Więcej informacji znajdziesz na stronie Korzystanie z kluczy interfejsu API dotyczącej konkretnej usługi.

Klucz interfejsu API to unikalny identyfikator używany do uwierzytelniania żądań powiązanych z projektem na potrzeby wykorzystania i płatności. Z projektem musi być powiązany co najmniej 1 klucz interfejsu API.

Aby utworzyć klucz interfejsu API:

Konsola

1. Otwórz stronę Google Maps Platform > Dane logowania.

   Otwórz stronę Dane logowania

2. Na stronie Dane logowania kliknij Utwórz dane logowania > Klucz interfejsu API.
   W oknie Utworzono klucz interfejsu API pojawi się nowo utworzony klucz interfejsu API.
3. Kliknij Zamknij.
   Nowy klucz interfejsu API pojawi się na stronie Dane logowania w sekcji Klucze interfejsu API.
   (Pamiętaj, aby ograniczyć klucz interfejsu API przed użyciem go w środowisku produkcyjnym).

Pakiet SDK Cloud

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Więcej informacji o pakiecie SDK Google Cloud, instalacji pakietu SDK Cloud i tych poleceniach:

• gcloud services api-keys create

Aby włączyć pakiet SDK, otwórz stronę Maps 3D SDK na iOS w konsoli Google Cloud. Więcej informacji o wykonywaniu tych czynności znajdziesz w artykule Pierwsze kroki z Google Maps Platform.

Konfigurowanie projektu Xcode

W tej sekcji dowiesz się, jak utworzyć i skonfigurować projekt Xcode do użycia z pakietem SDK Map 3D na iOS.

Po włączeniu płatności i utworzeniu klucza interfejsu API możesz skonfigurować projekt Xcode, którego używasz do tworzenia aplikacji.

Krok 1. Zainstaluj wymagane oprogramowanie

Aby utworzyć projekt za pomocą pakietu Maps 3D SDK na iOS, musisz pobrać i zainstalować:

• Xcode w wersji 16.0 lub nowszej

Krok 2. Utwórz projekt Xcode i zainstaluj pakiet SDK Map 3D na iOS

Swift Package Manager

Pakiet Maps 3D SDK na iOS można zainstalować za pomocą menedżera pakietów Swift.

Aby dodać pakiet SDK do nowego lub istniejącego projektu, wykonaj te czynności:

• Otwórz plik project lub workspace w Xcode, a następnie kliknij File (Plik) > Add Package Dependencies (Dodaj zależności pakietu).
• Wpisz https://github.com/googlemaps/ios-maps-3d-sdk jako adres URL, naciśnij Enter, aby pobrać pakiet, i kliknij „Add Package” (Dodaj pakiet).
• W oknie Wybierz produkty w pakiecie sprawdź, czy usługa GoogleMaps3D zostanie dodana do wyznaczonego głównego celu. Gdy skończysz, kliknij Dodaj pakiet.
• Aby sprawdzić instalację, otwórz panel General (Ogólne) celu. Zainstalowane pakiety powinny być widoczne w sekcji Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i treści umieszczone). Możesz też wyświetlić sekcję Zależności pakietu w Nawigatorze projektu, aby sprawdzić pakiet i jego wersję.

Krok 3. Dodaj klucz interfejsu API do aplikacji

Swift Package Manager

Dodaj klucz interfejsu API do głównego punktu wejścia aplikacji (lub w dowolnym momencie przed wczytaniem mapy) w następujący sposób.

1. Dodaj tę instrukcję importu:

   import GoogleMaps3D

2. Dodaj tę metodę. Zastąp YOUR_API_KEY swoim kluczem interfejsu API.

   struct ContentView: View {
     init () {
       Map.apiKey = "YOUR_API_KEY"
     }
   
     var body: some View {
       Map(mode: .hybrid)
     }
   }
       

Klucz interfejsu API może pojawić się w punkcie wejścia aplikacji lub osobno dla każdego widoku mapy. Jeśli jednak klucz interfejsu API jest określony zarówno w punkcie wejścia, jak i w widokach mapy, konsola wyświetli błąd.

Krok 4 (opcjonalny). Sprawdź plik Apple Privacy Manifest

Uwaga: poniższe informacje dotyczą wdrażania aplikacji w sklepie internetowym.

Apple wymaga podawania informacji o prywatności w przypadku aplikacji w App Store.

Plik Apple Privacy Manifest jest dołączony do pakietu zasobów pakietu SDK. Aby sprawdzić, czy plik manifestu prywatności został dołączony, i zobaczyć jego zawartość, utwórz archiwum aplikacji i wygeneruj z niego raport dotyczący prywatności.

Dalsze kroki

Gdy masz już projekt w chmurze Google, klucz interfejsu API i projekt Xcode skonfigurowane do użycia z pakietem Maps 3D SDK for iOS, możesz dodać do aplikacji mapę 3D.