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 z użyciem pakietu Maps 3D SDK na Androida, 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

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 wygasa 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. Anuluj 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ń:

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

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, 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

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 opisach tych poleceń:

gcloud services api-keys create

Aby włączyć pakiet SDK, zapoznaj się ze stroną Pakiet SDK Map 3D 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 do używania z pakietem 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 w systemie 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`