หน้านี้ได้รับการแปลโดย Cloud Translation API

กำหนดค่าโปรเจ็กต์ Google Cloud Console

วิธีตั้งค่าและกำหนดค่า Google Cloud Console เพื่อใช้ SDK ของผู้บริโภคสำหรับ Android ให้ทำตามขั้นตอนต่อไปนี้

ตั้งค่าโครงการพัฒนา
เพิ่ม Consumer SDK ลงในแอป
เพิ่มคีย์ API ลงในแอป
ระบุแหล่งที่มาที่จำเป็นในแอป

โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับแต่ละขั้นตอนในส่วนต่อไปนี้

ตั้งค่าโปรเจ็กต์การพัฒนา

หากคุณไม่มีโปรเจ็กต์การพัฒนาคอนโซล Google Cloud และคีย์ API สำหรับ คุณต้องจัดทำโปรเจ็กต์ระบบเคลื่อนที่ขึ้น โปรดดูรายละเอียดที่หัวข้อ สร้างโปรเจ็กต์ในคู่มือ Fleet Engine

เมื่อคุณเลือกโปรเจ็กต์การพัฒนาสำหรับ SDK ของผู้บริโภค ให้เลือก โปรเจ็กต์ Google Cloud Console และคีย์ API เดียวกับที่คุณใช้สำหรับ Fleet Engine

เพิ่ม SDK ของผู้บริโภคลงในแอปของคุณ

Consumer SDK พร้อมให้ใช้งานจากที่เก็บส่วนตัวของ Maven ที่เก็บ มีไฟล์ Project Object Model (.pom) ของ SDK และ Javadocs วิธีเพิ่มปุ่ม SDK สำหรับผู้บริโภคในแอปของคุณ โปรดทำตามขั้นตอนต่อไปนี้

ตั้งค่าสภาพแวดล้อมของคุณเพื่อเข้าถึงที่เก็บของ Maven ของโฮสต์ตามที่อธิบายไว้ใน ขั้นตอนที่ 2 ของคู่มือนี้
เพิ่มทรัพยากร Dependency ของ Consumer SDK และ Maps SDK ลงใน Gradle หรือ Maven ของคุณ การกำหนดค่า

หมายเหตุ: SDK ของผู้บริโภคจะขึ้นอยู่กับ Maps SDK ตั้งค่าการอ้างอิงเป็น Maps SDK เวอร์ชันที่กำหนดไว้อย่างชัดแจ้งดังที่แสดงในตัวอย่างนี้ มิฉะนั้น Consumer SDK จะใช้ Maps เวอร์ชันขั้นต่ำที่จำเป็น SDK ซึ่งอาจทําให้เกิดปัญหาหากแอปของคุณต้องใช้ฟีเจอร์ที่มีให้ใช้งานใน Maps SDK เวอร์ชันต่อๆ ไป

ในตัวอย่างต่อไปนี้ ให้ใส่ค่าที่ต้องระบุแทน VERSION_NUMBER เวอร์ชัน Consumer SDK ดังนี้
Gradle
เพิ่มสิ่งต่อไปนี้ใน build.gradle
```
dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
implementation "com.google.android.gms:play-services-maps:VERSION_NUMBER"
}
```
Maven
เพิ่มสิ่งต่อไปนี้ใน 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 ของโปรเจ็กต์ที่คุณได้รับเมื่อคุณตั้งค่าโปรเจ็กต์การพัฒนา สำหรับ ดูรายละเอียดเพิ่มเติมได้ที่ตั้งค่าโปรเจ็กต์การพัฒนาในขั้นตอนที่ 3 ของคู่มือนี้

ส่วนนี้จะอธิบายวิธีจัดเก็บคีย์ API เพื่อให้ปลอดภัยยิ่งขึ้น ที่แอปของคุณอ้างอิง ดูข้อมูลเพิ่มเติมเกี่ยวกับแนวทางปฏิบัติแนะนำด้านความปลอดภัยสำหรับคีย์ API ดูบทความ Google Maps Platform เกี่ยวกับแนวทางปฏิบัติแนะนำด้านความปลอดภัยของ API

หากต้องการเพิ่มประสิทธิภาพงานนี้ คุณสามารถใช้เอกสาร Secrets Gradle ของ GitHub ปลั๊กอินสำหรับ Android

วิธีติดตั้งปลั๊กอินและจัดเก็บคีย์ API

เปิดไฟล์ build.gradle ระดับรากและเพิ่มโค้ดต่อไปนี้ลงในส่วน dependencies องค์ประกอบภายใต้ buildscript

ดึงดูด

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

Kotlin

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

เปิดไฟล์ build.gradle ระดับแอปและเพิ่มโค้ดต่อไปนี้ลงใน องค์ประกอบ plugins
ดึงดูด
```
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
```
Kotlin
```
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
```
หากใช้ Android Studio ให้ซิงค์โปรเจ็กต์กับ Gradle โปรดดูรายละเอียดที่หัวข้อ ซิงค์โปรเจ็กต์กับ Gradle ในเอกสารประกอบของ Android
เปิด local.properties ในไดเรกทอรีระดับโปรเจ็กต์แล้วเพิ่ม รหัสต่อไปนี้ แทนที่ YOUR_API_KEY ด้วยคีย์ API

MAPS_API_KEY=YOUR_API_KEY
ในไฟล์ 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 ที่สมบูรณ์สำหรับแอปตัวอย่าง

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

ใส่การระบุแหล่งที่มาที่จำเป็นในแอปของคุณ

หากใช้ SDK ของผู้บริโภคในแอป คุณต้องใส่ข้อความระบุแหล่งที่มาและ ใบอนุญาตโอเพนซอร์สเป็นส่วนหนึ่งของส่วนประกาศทางกฎหมายของแอป คุณควร ระบุแหล่งที่มาเป็นรายการในเมนูอิสระหรือเป็นส่วนหนึ่งของเกี่ยวกับ รายการในเมนู

คุณดูข้อมูลใบอนุญาตได้ใน "third_party_licenses.txt" ไฟล์ใน ไฟล์ AAR ที่ยกเลิกการเก็บ

ดูวิธีทำสิ่งต่างๆ ใน https://developers.google.com/android/guides/opensource รวมประกาศโอเพนซอร์ส

ขั้นตอนถัดไป

รับโทเค็นการตรวจสอบสิทธิ์