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

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

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

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

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

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

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

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

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

  1. ตั้งค่าสภาพแวดล้อมของคุณเพื่อเข้าถึงที่เก็บของ Maven ของโฮสต์ตามที่อธิบายไว้ใน ขั้นตอนที่ 2 ของคู่มือนี้

  2. เพิ่มทรัพยากร 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: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

  1. เปิดไฟล์ 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")
        }
    }
    
  2. เปิดไฟล์ build.gradle ระดับแอปและเพิ่มโค้ดต่อไปนี้ลงใน องค์ประกอบ plugins

    ดึงดูด

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

    Kotlin

    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
    
  3. หากใช้ Android Studio ให้ซิงค์โปรเจ็กต์กับ Gradle โปรดดูรายละเอียดที่หัวข้อ ซิงค์โปรเจ็กต์กับ Gradle ในเอกสารประกอบของ Android

  4. เปิด local.properties ในไดเรกทอรีระดับโปรเจ็กต์แล้วเพิ่ม รหัสต่อไปนี้ แทนที่ YOUR_API_KEY ด้วยคีย์ API

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

    <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 รวมประกาศโอเพนซอร์ส

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

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