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 ลงในแอป

Consumer SDK พร้อมใช้งานจากที่เก็บ Maven ของ Google ที่เก็บนี้มีไฟล์ Project Object Model (.pom) และ Javadocs ของ 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

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

วิธีติดตั้งปลั๊กอินและจัดเก็บคีย์ 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

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

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