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. Skonfiguruj projekt

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 90 dniach 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:

Krok 2. Włącz interfejsy API lub pakiety SDK

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:

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. Uzyskaj klucz interfejsu API

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ć nowy klucz lub dodać interfejs API bądź pakiet SDK do istniejącego klucza, wykonaj te instrukcje.

Konsola

  1. Otwórz stronę Google Maps Platform > Klucze i dane logowania.

    Otwórz stronę Klucze i dane uwierzytelniające

  2. Jeśli pojawi się taka prośba, wybierz projekt.

  3. Wykonaj jedną z tych czynności:

    • Utwórz nowy klucz:

      1. Kliknij Utwórz dane logowania > Klucz interfejsu API.
      2. W panelu Utwórz klucz interfejsu API otwórz listę Wybierz ograniczenia interfejsu API.
      3. Odznacz wszystkie interfejsy API, których ten klucz nie potrzebuje, i upewnij się, że interfejsy API, których planujesz używać, pozostaną zaznaczone.
      4. Kliknij Utwórz. W panelu pojawi się nowy klucz interfejsu API.

    • Użyj istniejącego klucza:

      1. Kliknij nazwę klucza.
      2. Na liście Wybierz ograniczenia interfejsu API wybierz interfejsy API, których chcesz używać.
      3. Kliknij Zapisz.

    Wybranie interfejsu API w tym miejscu nie powoduje jego włączenia. Upewnij się, że każdy wybrany interfejs API jest włączony w bibliotece interfejsów API.

  4. Aby później wyświetlić ciąg klucza, otwórz stronę Klucze i dane uwierzytelniające i kliknij Pokaż klucz.

Jeśli konsola wygląda inaczej niż w tych krokach, zapoznaj się z artykułami Tworzenie klucza interfejsu API i Dodawanie ograniczeń interfejsu API w dokumentacji Google Cloud.

Pakiet SDK Cloud

W poniższych poleceniach zastąp PROJECT_ID identyfikatorem swojego projektu.

  • Utwórz nowy klucz: uruchom to polecenie i zastąp DISPLAY_NAME nazwą klucza. Zastąp SERVICE_NAME nazwą usługi interfejsu API, którego chcesz używać, np. places.googleapis.com. Aby zezwolić na więcej interfejsów API, powtórz flagę --api-target.

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

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

  • Użyj istniejącego klucza: uruchom to polecenie i zastąp KEY_ID identyfikatorem klucza. Zastąp SERVICE_NAME nazwą usługi interfejsu API, który chcesz dodać. Flaga --append zachowuje interfejsy API, które klucz już dopuszcza. Bez niego polecenie zastępuje je.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=SERVICE_NAME

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

    Identyfikator klucza nie jest ciągiem klucza ani wyświetlaną nazwą. Aby go znaleźć, uruchom gcloud services api-keys list --project="PROJECT_ID". Identyfikator to ostatnia część pola name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Aby zobaczyć ciąg klucza, uruchom gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

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)
  }
}

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

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.