Konfiguracja

Na tej stronie znajdziesz informacje o tym, co musisz zrobić, aby zacząć tworzyć aplikacje za pomocą pakietu Maps 3D SDK na iOS. Proces konfiguracji obejmuje skonfigurowanie projektu Google Cloud i interfejsu API do używania z pakietem SDK, a następnie skonfigurowanie projektu Xcode. Wykonaj te czynności, zanim dodasz pierwszą mapę 3D do aplikacji.

Konfigurowanie projektu Google Cloud i klucza interfejsu API

Zanim zaczniesz tworzyć aplikacje za pomocą pakietu SDK Map 3D na iOS, musisz skonfigurować projekt Google Cloud i klucz interfejsu API, aby używać ich z tym pakietem. W tym celu 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 włączone są płatności.

    Google Cloud oferuje okres próbny za 0,00 PLN. Okres próbny wygasa po 90 dniach lub po naliczeniu na koncie opłat o wartości 300 USD, w zależności od tego, co nastąpi wcześniej. Możesz anulować w dowolnym momencie. Więcej informacji znajdziesz w artykułach Środki na koncie rozliczeniowym i Rozliczenia i płatności.

Pakiet SDK Cloud

gcloud projects create "PROJECT"

Więcej informacji znajdziesz w artykułach Google Cloud SDK, instalacja pakietu Cloud SDK oraz w opisach tych poleceń:

Krok 2

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

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

Aby włączyć co najmniej jeden 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 przycisk ma etykietę 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. (Aby usunąć interfejs API lub pakiet SDK z tego projektu, kliknij przycisk WYŁĄCZ).

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 znajdziesz w artykułach Google Cloud SDK, instalacja pakietu Cloud SDK oraz w opisach tych poleceń:

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"

Krok 3

Ten krok obejmuje tylko proces 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 API pojawi się nowo utworzony klucz.
  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 znajdziesz w artykułach Google Cloud SDK, instalacja pakietu Cloud SDK oraz w opisach tych poleceń:

Aby włączyć pakiet SDK, otwórz stronę Maps 3D SDK na iOS w konsoli Google Cloud. Więcej informacji o wykonaniu 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żywania 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 Maps 3D SDK na iOS

Swift Package Manager

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

Aby dodać pakiet SDK do nowego lub istniejącego projektu:

  • Otwórz Xcode project lub workspace, a potem 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, a potem kliknij „Add Package” (Dodaj pakiet).
  • W oknie Wybierz produkty w pakiecie sprawdź, czy produkt GoogleMaps3D zostanie dodany do wyznaczonego głównego celu. Gdy skończysz, kliknij Dodaj pakiet.
  • Aby sprawdzić instalację, otwórz panel Ogólne w przypadku wybranego celu. W sekcji Frameworki, biblioteki i treści osadzone powinny być widoczne zainstalowane pakiety. Możesz też sprawdzić pakiet i jego wersję w sekcji Zależności pakietu w Nawigatorze projektu.

Krok 3. Dodaj klucz interfejsu API do aplikacji

Swift Package Manager

Dodaj klucz interfejsu API do głównego punktu wejściowego aplikacji (lub w dowolnym momencie przed wczytaniem mapy) w ten 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)
  }
}

Krok 4 (opcjonalny). Sprawdź plik manifestu prywatności Apple

Firma Apple wymaga podawania szczegółowych informacji o ochronie prywatności w przypadku aplikacji w App Store.

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

Dalsze kroki

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