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 pierwszą mapę 3D do swojej aplikacji.

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, aby używać ich z tym pakietem. Aby to zrobić, wykonaj te czynności:

Krok 1

Konsola

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

    Otwórz stronę selektora projektu

  2. Sprawdź, czy w projekcie w chmurze włączone są płatności. Potwierdź, że w projekcie włączone są płatności.

    Google Cloud oferuje bezpłatny okres próbny. Okres próbny wygasa po 90 dniach lub po naliczeniu na koncie opłat w wysokości 300 USD – zależnie od tego, co nastąpi wcześniej. Anuluj kiedy chcesz. Więcej informacji znajdziesz w artykułach Środki na koncie rozliczeniowym i Rozliczenia.

Pakiet SDK Cloud

gcloud projects create "PROJECT"

Więcej informacji o pakiecie Google Cloud SDK , instalacji pakietu SDK Cloud i tych poleceniach znajdziesz w tych artykułach:

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 eksploratora funkcji 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. Interfejsy API i pakiety SDK Google Maps Platform, które możesz włączyć, znajdziesz na stronie Biblioteka interfejsów API Map Google w konsoli Cloud:

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

  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 jest 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. (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 o pakiecie Google Cloud SDK , instalacji pakietu SDK Cloud i tych poleceniach znajdziesz w tych artykułach:

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 Używanie 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 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 Google Cloud SDK , instalacji pakietu SDK Cloud i tych poleceniach znajdziesz w tych artykułach:

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 Maps 3D SDK na iOS.

Gdy włączysz płatności i utworzysz klucz 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 Maps 3D SDK na iOS można zainstalować za pomocą Swift Package Manager.

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

  • Otwórz project lub workspace Xcode, a następnie kliknij Plik > Dodaj zależności pakietu.
  • Jako adres URL wpisz https://github.com/googlemaps/ios-maps-3d-sdk, naciśnij Enter, aby pobrać pakiet, a następnie kliknij „Dodaj pakiet”.
  • W oknie Wybierz produkty pakietu sprawdź, czy pakiet GoogleMaps3D zostanie dodany do wyznaczonego głównego celu. Gdy skończysz, kliknij Dodaj pakiet.
  • Aby sprawdzić instalację, otwórz panel Ogólne celu. W sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone) powinny być widoczne zainstalowane pakiety. Aby sprawdzić pakiet i jego wersję, możesz też otworzyć sekcję Package Dependencies (Zależności pakietu) w Project Navigator (Nawigatorze projektu).

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 ten sposób.

  1. Dodaj to stwierdzenie importu: 
    import GoogleMaps3D
  2. Dodaj tę metodę. Zastąp YOUR_API_KEY 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, aby aplikacje w App Store zawierały szczegółowe informacje o ochronie prywatności.

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

Dalsze kroki

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