Konfiguracja

Z tej strony dowiesz się, co musisz zrobić, aby rozpocząć tworzenie aplikacji za pomocą pakietu Maps 3D SDK na Androida. Proces konfiguracji obejmuje skonfigurowanie projektu Google Cloud i interfejsu API do użycia z pakietem SDK, a następnie skonfigurowanie projektu Android Studio. 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 Androida, musisz skonfigurować projekt Google Cloud i klucz interfejsu API do użycia 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. Upewnij się, ż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 – w zależności od tego, co nastąpi wcześniej. Można zrezygnować. 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 o pakiecie Google Cloud SDK , instalacji pakietu SDK Cloud i tych poleceniach:

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. Zobacz interfejsy API i pakiety SDK Google Maps Platform, które możesz włączyć, otwierając stronę 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, 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 o pakiecie Google Cloud SDK , 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

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:

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

Część 1. Konfigurowanie projektu i Gradle

  1. Utwórz nowy projekt Android Studio, używając szablonu Empty Views Activity.

  2. Jeśli do kontroli źródła używasz Gita, zmodyfikuj plik .gitignore projektu, aby zapobiec zatwierdzeniu pliku z danymi tajnymi w systemie kontroli wersji:

    • W katalogu głównym projektu otwórz plik .gitignore.
    • Dodaj ten wiersz:
    secrets.properties

  3. Zaktualizuj plik build.gradle.kts na poziomie projektu:

    • W katalogu głównym 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
}

  4. 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 [versions] dodaj wersje pakietu SDK i wtyczki Gradle obiektów tajnych:
    # See https://developers.google.com/android/guides/setup?device=phone-tablet for available releases
maps3dSdk = "0.2.2"
# See https://github.com/google/secrets-gradle-plugin/releases for available releases
secretsGradlePlugin = "2.0.1"
    • W sekcji [library] dodaj bibliotekę pakietu SDK:
    play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }
    • W sekcji [plugins] dodaj wtyczkę Gradle obiektów tajnych:
    secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }

  5. 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
}
    • W bloku dependencies dodaj pakiet SDK:
    dependencies {
    // ... other dependencies
    implementation(libs.play.services.maps3d) // Add this line
}
    • Na końcu pliku, poza blokami android i dependencies, dodaj konfigurację obiektów tajnych:
    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

  1. Utwórz plik secrets.properties:

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

  2. 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 sprawdzić w systemie kontroli wersji:

    MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER

Część 3. Aktualizowanie pliku AndroidManifest.xml

  1. Otwórz plik app/src/main/AndroidManifest.xml.

  2. 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 symbol zastępczy ${MAPS3D_API_KEY} kluczem z pliku secrets.properties.

Programowe inicjowanie widoku (opcjonalnie)

Jeśli wolisz inicjować widok mapy programowo, a nie w układach XML layouts, użyj Map3DInitConfig.

import com.google.android.gms.maps3d.Map3DInitConfig
import com.google.android.gms.maps3d.Map3DView
import com.google.android.gms.maps3d.model.Map3DMode

// Set configuration options using the factory method
val config = Map3DInitConfig.create(
    mapMode = Map3DMode.HYBRID,
    centerLat = 38.544012,
    centerLng = -107.670428
)

val map3DView = Map3DView(context, config)

Dalsze kroki

Teraz, gdy masz już skonfigurowany projekt Google Cloud, klucz interfejsu API i projekt Android Studio do użycia z pakietem Maps 3D SDK na Androida, możesz dodać do swojej aplikacji mapę 3D.