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

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

หากต้องการตั้งค่าและกำหนดค่าคอนโซล Google Cloud เพื่อใช้ Consumer SDK สําหรับ Android ให้ทําตามขั้นตอนต่อไปนี้

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

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

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

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

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

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

Consumer SDK มีให้บริการจากที่เก็บ Maven ของ Google พื้นที่เก็บข้อมูลจะรวมไฟล์ Project Object Model (.pom) และ Javadoc ของ SDK หากต้องการเพิ่ม Consumer SDK ลงในแอป ให้เพิ่มทรัพยากร Dependency ของ Consumer SDK และ Maps SDK ลงในการกำหนดค่า Gradle หรือ Maven

ในตัวอย่างต่อไปนี้ ให้ใช้เวอร์ชันที่จำเป็นของ Consumer SDK แทน VERSION_NUMBER

Gradle

เพิ่มโค้ดต่อไปนี้ใน 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"
}

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

หากต้องการทํางานนี้ให้มีประสิทธิภาพมากขึ้น คุณสามารถใช้เอกสารประกอบของ GitHub เกี่ยวกับปลั๊กอินข้อมูลลับ Gradle สำหรับ 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>

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

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

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

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

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

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