Ta strona została przetłumaczona przez Cloud Translation API.

Konfiguracja

Na tej stronie znajdziesz informacje o tym, co musisz zrobić, aby zacząć tworzyć aplikacje za pomocą pakietu Maps 3D SDK na Androida. Proces konfiguracji obejmuje skonfigurowanie projektu Google Cloud i interfejsu API do używania z pakietem SDK, a następnie skonfigurowanie projektu Android Studio. 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 Maps 3D SDK na Androida, musisz skonfigurować projekt Google Cloud i klucz interfejsu API, aby używać ich z pakietem Maps 3D SDK na Androida. Aby to zrobić, wykonaj te czynności:

Krok 1

Konsola

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
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 kończy się 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ć subskrypcję 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 informacjach o tych poleceniach:

gcloud projects create

Krok 2

Aby korzystać z Google Maps Platform, musisz włączyć interfejsy API lub pakiety SDK, których zamierzasz używać w swoim 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 narzędzia Capabilities Explorer 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

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.
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 Google, Trasy i Miejsca:

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 informacjach o 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

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

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

Otwórz stronę Dane logowania
Na stronie Dane logowania kliknij Utwórz dane logowania > Klucz interfejsu API.
W oknie Utworzono klucz API pojawi się nowo utworzony klucz.
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 informacjach o tych poleceniach:

gcloud services api-keys create

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

Konfigurowanie projektu Android Studio

W tej sekcji dowiesz się, jak utworzyć i skonfigurować projekt Android Studio na potrzeby korzystania z pakietu Maps 3D SDK na Androida.

Część 1. Konfigurowanie projektu i Gradle

Utwórz nowy projekt Android Studio, korzystając z szablonu Empty Views Activity.
Jeśli do kontroli źródła używasz Git, zmodyfikuj plik projektu .gitignore, aby zapobiec zatwierdzeniu pliku z danymi logowania do kontroli wersji:
- W głównym katalogu projektu otwórz plik .gitignore.
- Dodaj ten wiersz:
```
secrets.properties
```

Zaktualizuj plik build.gradle.kts na poziomie projektu:

W głównym katalogu projektu otwórz plik build.gradle.kts.
W bloku plugins dodaj wtyczkę Gradle obiektów tajnych:

plugins {
  alias(libs.plugins.android.application) apply false
  alias(libs.plugins.kotlin.android) apply false
  alias(libs.plugins.secrets.gradle.plugin) apply false // Add this line
}

Zaktualizuj plik gradle/libs.versions.toml: – otwórz plik gradle/libs.versions.toml, który zwykle znajduje się w katalogu gradle w katalogu głównym projektu. – W sekcji wersji dodaj wersje pakietu SDK i wtyczki Gradle Secrets:

maps3dSdk = "0.0.1" # Update this value to match the SDK version to include
secretsGradlePlugin = "2.0.1"

-   In the library section, add the SDK library:

play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }

-   In the plugin section, add the Secrets Gradle plugin:

secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }

Zaktualizuj plik app/build.gradle.kts na poziomie modułu: – otwórz plik build.gradle.kts na poziomie modułu, który zwykle znajduje się w katalogu app. – U góry pliku dodaj wtyczkę Gradle obiektów tajnych do bloku plugins:

plugins {
  alias(libs.plugins.android.application)
  alias(libs.plugins.kotlin.android)
  alias(libs.plugins.secrets.gradle.plugin) // Add this line
}

-   In the `dependencies` block, add the SDK:

dependencies {
  // ... other dependencies
  implementation(libs.play.services.maps3d) // Add this line
}

-   At the end of the file, outside of the `android` and `dependencies`
    blocks, add the secrets configuration:

secrets {
  // Optionally specify a different filename containing your secrets.
  // The plugin defaults to "local.properties"
  propertiesFileName = "secrets.properties"

  // A properties file containing default secret values. This file can be
  // checked in version control.
  defaultPropertiesFileName = "local.defaults.properties"
}

Część 2. Dodawanie klucza interfejsu API do projektu

Utwórz plik secrets.properties:

W katalogu głównym modułu aplikacji (zwykle katalog app) utwórz nowy plik o nazwie secrets.properties.
Dodaj klucz interfejsu API do pliku:

MAPS3D_API_KEY=YOUR_API_KEY_HERE
``` Note: Make sure you
    replace `YOUR_API_KEY_HERE` with the API key that you configured for use
with the Maps 3D SDK for Android.

Utwórz plik local.defaults.properties: w katalogu głównym modułu aplikacji utwórz nowy plik o nazwie secrets.properties. – Dodaj do pliku domyślny lub zastępczy klucz interfejsu API. Ten plik można zarejestrować w systemie kontroli wersji:
```
MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
```

Część 3. Aktualizowanie pliku `AndroidManifest.xml`

Otwórz plik app/src/main/AndroidManifest.xml.
W tagu <application>, przed tagiem <activity>, dodaj ten element <meta-data>, aby zadeklarować klucz interfejsu API:
```
<application
  ...>

  <meta-data
      android:name="com.google.android.geo.maps3d.API_KEY"
      android:value="${MAPS3D_API_KEY}" />

  <activity
      ...>
  </activity>
</application>
```
Podczas procesu kompilacji wtyczka Gradle obiektów tajnych zastąpi obiekt zastępczy ${MAPS3D_API_KEY} kluczem z pliku secrets.properties.

Dalsze kroki

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

Konfiguracja Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Konfigurowanie projektu Google Cloud i klucza interfejsu API

Krok 1

Konsola

Pakiet SDK Cloud

Krok 2

Konsola

Pakiet SDK Cloud

Krok 3

Konsola

Pakiet SDK Cloud

Konfigurowanie projektu Android Studio

Część 1. Konfigurowanie projektu i Gradle

Część 2. Dodawanie klucza interfejsu API do projektu

Część 3. Aktualizowanie pliku AndroidManifest.xml

Dalsze kroki

Konfiguracja

Część 3. Aktualizowanie pliku `AndroidManifest.xml`