یک پروژه کنسول Google Cloud را پیکربندی کنید

برای تنظیم و پیکربندی کنسول Google Cloud برای استفاده از Consumer SDK برای اندروید، این مراحل را دنبال کنید.

  1. پروژه توسعه خود را تنظیم کنید .
  2. SDK مربوط به Consumer را به برنامه خود اضافه کنید .
  3. کلید API را به برنامه خود اضافه کنید .
  4. ویژگی‌های مورد نیاز را در برنامه خود لحاظ کنید .

برای جزئیات بیشتر در مورد هر مرحله، به بخش‌های بعدی مراجعه کنید.

پروژه توسعه خود را تنظیم کنید

اگر پروژه توسعه کنسول گوگل کلود و کلید API برای پروژه تحرک‌پذیری خود ندارید، باید یکی تنظیم کنید. برای جزئیات بیشتر، به بخش «ایجاد پروژه» در راهنمای Fleet Engine مراجعه کنید.

هنگام انتخاب پروژه توسعه خود برای Consumer SDK، همان پروژه کنسول Google Cloud و کلید API را که برای Fleet Engine استفاده می‌کنید، انتخاب کنید.

SDK مصرف‌کننده را به برنامه خود اضافه کنید

SDK مربوط به Consumer از مخزن Google Maven قابل دسترسی است. این مخزن شامل فایل‌های Project Object Model (.pom) و Javadocs مربوط به SDK است. برای افزودن Consumer SDK به برنامه خود، وابستگی‌های Consumer SDK و Maps SDK را به پیکربندی Gradle یا Maven خود اضافه کنید.

در مثال‌های زیر، VERSION_NUMBER با نسخه مورد نیاز Consumer SDK جایگزین کنید:

گرادل

موارد زیر را به build.gradle خود اضافه کنید:

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

ماون

موارد زیر را به pom.xml خود اضافه کنید:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

کلید API را به برنامه خود اضافه کنید

پس از افزودن Consumer SDK به برنامه خود، کلید API را اضافه کنید. شما باید از کلید API پروژه که هنگام راه‌اندازی پروژه توسعه خود دریافت کرده‌اید، استفاده کنید. برای جزئیات بیشتر، به بخش «راه‌اندازی پروژه توسعه خود» در مرحله ۳ این راهنما مراجعه کنید.

این بخش نحوه ذخیره کلید API شما را شرح می‌دهد تا برنامه شما بتواند با امنیت بیشتری به آن مراجعه کند. برای اطلاعات بیشتر در مورد بهترین شیوه‌های امنیت کلید API، به مقاله پلتفرم نقشه‌های گوگل در مورد بهترین شیوه‌های امنیت API مراجعه کنید.

برای ساده‌سازی این کار، می‌توانید از مستندات گیت‌هاب با عنوان Secrets Gradle Plugin for Android استفاده کنید.

برای نصب افزونه و ذخیره کلید API خود:

  1. فایل build.gradle سطح ریشه خود را باز کنید و کد زیر را به عنصر dependencies در زیر buildscript اضافه کنید.

    گرووی 

    buildscript {
      dependencies {
          // ...
          classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0"
      }
}

    کاتلین 

    buildscript {
    dependencies {
        // ...
        classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0")
    }
}

  2. فایل build.gradle سطح برنامه خود را باز کنید و کد زیر را به عنصر plugins اضافه کنید.

    گرووی 

    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'

    کاتلین 

    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")

  3. اگر از اندروید استودیو استفاده می‌کنید، پروژه خود را با Gradle همگام‌سازی کنید. برای جزئیات بیشتر، به بخش «همگام‌سازی پروژه با Gradle» در مستندات اندروید مراجعه کنید.

  4. local.properties را در دایرکتوری سطح پروژه خود باز کنید و سپس کد زیر را اضافه کنید. به جای YOUR_API_KEY ، کلید API خود را قرار دهید.

    کلید API نقشه = YOUR_API_KEY

  5. در فایل AndroidManifest.xml خود، به مسیر com.google.android.geo.API_KEY بروید و ویژگی android:value به صورت زیر به‌روزرسانی کنید: 

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

مثال زیر یک مانیفست کامل برای یک برنامه نمونه را نشان می‌دهد:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.consumerapidemo">
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:supportsRtl="true"
            android:theme="@style/_AppTheme">

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

            <activity android:name=".MainActivity">
                <intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>
            </activity>
        </application>
    </manifest>

ویژگی‌های مورد نیاز را در برنامه خود بگنجانید

اگر از Consumer SDK در برنامه خود استفاده می‌کنید، باید متن مربوط به انتساب و مجوزهای متن‌باز را به عنوان بخشی از بخش اطلاعیه‌های قانونی برنامه خود درج کنید. بهتر است انتساب‌ها را به عنوان یک آیتم مستقل از منو یا به عنوان بخشی از یک آیتم منوی «درباره» درج کنید.

می‌توانید اطلاعات مجوز را در فایل "third_party_licenses.txt" در فایل AAR بایگانی نشده پیدا کنید.

برای اطلاع از نحوه‌ی گنجاندن اطلاعیه‌های متن‌باز، به https://developers.google.com/android/guides/opensource مراجعه کنید.

قدم بعدی چیست؟

دریافت توکن‌های احراز هویت