Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

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

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

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

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

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

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

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

เพิ่ม Consumer SDK ลงในแอป

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

ในตัวอย่างต่อไปนี้ ให้แทนที่ 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: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

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

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