ฟีดข้อมูลแบบเลี้ยวต่อเลี้ยวจะให้ข้อมูลการนำทางเท่านั้นแก่อุปกรณ์ที่ไม่ได้ออกแบบมาเพื่อคำแนะนำการนำทางตามแผนที่ โดยจะมีข้อมูลการบังคับเลี้ยวที่กําลังจะเกิดขึ้นพร้อมองค์ประกอบที่คุณระบุไว้ ดังนี้

• ไอคอน (ซ้าย ขวา เลี้ยวกลับ)
• หมายเลขเลี้ยวในวงเวียน
• ชื่อถนน
• ระยะทางและเวลาโดยประมาณในการไปยังจุดหมายถัดไปหรือจุดหมายสุดท้าย

คุณสามารถใช้ฟีดการบอกทางทีละเลี้ยวเพื่อสร้างประสบการณ์การใช้งานที่ UI ของ Navigation SDK แบบสมบูรณ์ไม่เหมาะสม เช่น สำหรับ Android Auto หรือจอแสดงผลขนาดเล็กที่ไม่มีสแต็ก Android แบบสมบูรณ์ เช่น คุณอาจใช้ฟีเจอร์นี้สำหรับผู้ขับขี่ยานพาหนะ 2 ล้อ ซึ่งคุณสามารถฉายคำแนะนำในการนำทางเท่านั้นเพื่อช่วยให้ไปถึงจุดหมายได้เร็วขึ้นและมั่นใจมากขึ้นโดยมีการรบกวนน้อยที่สุด

หากต้องการใช้ SDK คุณจะต้องสร้างบริการและลงทะเบียนบริการนั้นกับ Navigation SDK สำหรับ Android เพื่อให้บริการได้รับข้อมูลการนำทางใหม่แบบเรียลไทม์ (ประมาณ 1 ครั้งต่อวินาทีระหว่างการนำทาง)

เอกสารนี้แสดงวิธีสร้างและลงทะเบียนบริการนำทางที่รับข้อมูลการนำทางจาก SDK และระบุสถานะการนำทางไปยังอุปกรณ์ที่รับ

ภาพรวม

ส่วนนี้จะอธิบายวิธีเพิ่มคลัง TurnByTurn ลงในโปรเจ็กต์และสรุปขั้นตอนระดับสูงในการสร้างฟังก์ชันการนําทางแบบเลี้ยวต่อเลี้ยว

เพิ่มไลบรารี TurnByTurn ลงในโปรเจ็กต์โดยใช้ Maven (แนะนำ)

หากต้องการใช้ไลบรารี TurnByTurn เวอร์ชันสแตนด์อโลน ให้ทำตามขั้นตอนต่อไปนี้

1. ตั้งค่าสภาพแวดล้อมเพื่อเข้าถึงที่เก็บ Maven ของโฮสต์ โดยทำดังนี้

   Maven

   เพิ่มโค้ดต่อไปนี้ในไฟล์ pom.xml

       <project>
         ...
         <repositories>
           <repository>
             <id>google-maven-repository</id>
             <url>https://maven.google.com</url>
           </repository>
         </repositories>
         ...
       </project>
       
       

   Gradle

   เพิ่มโค้ดต่อไปนี้ในไฟล์ build.gradle

   repositories {
       ...
       google()
   }
       

2. เพิ่ม Dependency ต่อไปนี้ในการกําหนดค่า Maven หรือ Gradle

   Maven

   <dependencies>
     ...
     <dependency>
       <groupId>com.google.android.maps</groupId>
       <artifactId>google_turnbyturn</artifactId>
       <version>1.0.0</version>
     </dependency>
   </dependencies>
       
       

   Gradle

   dependencies {
     ...
     implementation 'com.google.android.maps:google_turnbyturn:1.0.0'
   }
       

เพิ่มไลบรารี TurnByTurn ลงในโปรเจ็กต์โดยใช้ไฟล์ JAR ที่ดาวน์โหลดมา (วิธีอื่น)

ไลบรารี TurnByTurn มีให้บริการเป็นไฟล์ JAR ในโฟลเดอร์ SDK นี้ หากไม่มีสิทธิ์เข้าถึง โปรดติดต่อตัวแทน

1. ดาวน์โหลดและแตกไฟล์ google_turnbyturn_*.jar
2. คัดลอกไฟล์ JAR ที่ดาวน์โหลดลงในไดเรกทอรี app/libs ของโปรเจ็กต์

3. เพิ่มข้อมูลต่อไปนี้ลงใน build.gradle เพื่อรวม JAR ไว้ในบิลด์

   dependencies {
       ...
       api fileTree(include: ['*.jar'], dir: 'libs')
   }
   

การใช้ไลบรารี TurnByTurn

ขั้นตอนระดับสูงในการเปิดใช้ฟังก์ชันการบอกทางแบบเลี้ยวต่อเลี้ยวมีดังนี้ ส่วนต่อไปนี้จะให้รายละเอียดเกี่ยวกับแต่ละขั้นตอน

1. สร้างบริการเพื่อรับการอัปเดตการนําทาง

2. ลงทะเบียนบริการ

3. ทำความเข้าใจสถานะการนำทาง

สร้างบริการเพื่อรับการอัปเดตการนำทาง

Navigation SDK จะเชื่อมโยงกับบริการ TurnByTurn และส่งการอัปเดตการนำทางผ่าน Android Messenger คุณสามารถสร้างบริการนำทางใหม่สำหรับการอัปเดตเหล่านี้ หรือจะใช้บริการที่มีอยู่ก็ได้

ข้อดีของการใช้บริการเพื่อรับการอัปเดตการนำทางคือบริการดังกล่าวสามารถทำงานในกระบวนการเบื้องหลังแยกต่างหาก

บริการในตัวอย่างต่อไปนี้จะรับข้อมูลการนำทางและใช้ TurnByTurnManager เพื่อแปลงข้อมูลให้เป็นออบเจ็กต์ NavInfo ที่มีรายละเอียดการนำทาง

/**
 *   Receives turn-by-turn navigation information forwarded from NavSDK.
 */
public class NavInfoReceivingService extends Service {
  /** The messenger used by the service to receive nav step updates. */
  private Messenger incomingMessenger;
  private TurnByTurnManager turnByTurnManager;

  private final class IncomingNavStepHandler extends Handler {
    public IncomingNavStepHandler(Looper looper) {
      super(looper);
    }

    @Override
    public void handleMessage(Message msg) {
      // Identify the message through the msg.what field.
      if (TurnByTurnManager.MSG_NAV_INFO == msg.what) {
        // Extract the NavInfo object using the TurnByTurnManager.
        NavInfo navInfo = turnByTurnManager
          .readNavInfoFromBundle(msg.getData()));
      // Do something with the NavInfo
    }
  }
}

@Nullable
@Override
public IBinder onBind(Intent intent) {
  return incomingMessenger.getBinder();
}

@Override
public void onCreate() {
  turnByTurnManager = TurnByTurnManager.createInstance();
  HandlerThread thread =
    new HandlerThread("NavInfoReceivingService",
      Process.THREAD_PRIORITY_DEFAULT);
  thread.start();
  incomingMessenger = new Messenger(
    new IncomingNavStepHandler(thread.getLooper()));
}

รหัสข้อความ

ข้อความ NavInfo จะระบุผ่านช่อง Message.what ของคลาส Message ซึ่งตั้งค่าเป็นค่าของ TurnByTurnManager.MSG_NAV_INFO

การลงทะเบียนบริการสำหรับการอัปเดตการนำทาง

ข้อมูลโค้ดต่อไปนี้จะลงทะเบียนบริการนำทาง

boolean isNavInfoReceivingServiceRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(), NavInfoReceivingService.class.getName(), numNextStepsToPreview);

การเริ่มและหยุดบริการ

บริการนำทางจะทำงานอยู่ตราบใดที่ Navigation SDK เชื่อมโยงกับบริการดังกล่าว คุณสามารถเรียกใช้ startService() และ stopService() ด้วยตนเองเพื่อควบคุมวงจรชีวิตของบริการนำทางได้ แต่เมื่อลงทะเบียนบริการกับ Navigation SDK แล้ว บริการจะเริ่มต้นโดยอัตโนมัติและจะหยุดก็ต่อเมื่อคุณยกเลิกการลงทะเบียนเท่านั้น คุณอาจต้องพิจารณาเริ่มบริการที่ทำงานอยู่เบื้องหน้าตามที่อธิบายไว้ในภาพรวมบริการของเอกสารประกอบ Android ทั้งนี้ขึ้นอยู่กับวิธีตั้งค่าแอป

ยกเลิกการลงทะเบียนบริการ

หากต้องการหยุดรับการอัปเดตการนำทาง ให้ยกเลิกการลงทะเบียนบริการจาก Navigation SDK

navigator.unregisterServiceForNavUpdates();

ทําความเข้าใจสถานะการนําทาง

ใช้ NavInfo.getNavState() เพื่อดูสถานะการนําทางปัจจุบัน ซึ่งเป็นหนึ่งในสถานะต่อไปนี้

• อยู่ระหว่างทาง - สถานะ ENROUTE หมายความว่าการนำทางแบบมีคำแนะนำทำงานอยู่และผู้ใช้อยู่ในเส้นทางที่ระบุ ข้อมูลเกี่ยวกับขั้นตอนปัจจุบันและขั้นตอนการดำเนินการที่กำลังจะเกิดขึ้นจะแสดงอยู่

• กำลังเปลี่ยนเส้นทาง - REROUTING หมายความว่าระบบกำลังนำทางอยู่ แต่ระบบนำทางกำลังมองหาเส้นทางใหม่ ขั้นตอนการเปลี่ยนเลนข้างหน้าจะใช้งานไม่ได้เนื่องจากยังไม่มีเส้นทางใหม่ ในแอปตัวอย่าง ข้อความ "กำลังเปลี่ยนเส้นทาง..." จะปรากฏในจอแสดงข้อมูลการนำทาง เมื่อพบเส้นทาง ระบบจะส่งข้อความ NavInfo พร้อมสถานะ ENROUTE

• หยุดแล้ว - STOPPED หมายความว่าการนำทางสิ้นสุดแล้ว เช่น การนำทางจะหยุดเมื่อผู้ใช้ออกจากการนำทางในแอป ในแอปตัวอย่าง สถานะ STOPPED จะล้างการแสดงข้อมูลการนำทางเพื่อป้องกันไม่ให้แสดงวิธีการแบบทีละขั้นตอนค้างไว้

ป้อนข้อมูลในการแสดงผลฟีด

เมื่อตั้งค่าบริการบอกทางแบบเลี้ยวต่อเลี้ยวแล้ว ส่วนนี้จะอธิบายองค์ประกอบภาพและข้อความที่คุณสามารถใช้เพื่อป้อนข้อมูลลงในการ์ดคำแนะนำสำหรับฟีดการบอกทางแบบเลี้ยวต่อเลี้ยว

ช่องข้อมูลการ์ดการนำทาง

เมื่อผู้ใช้เข้าสู่การนำทางแบบมีคําแนะนํา การ์ดการนําทางจะปรากฏที่ด้านบน ซึ่งมีข้อมูลการนําทางที่สร้างขึ้นจาก Navigation SDK รูปภาพที่เกี่ยวข้องแสดงตัวอย่างองค์ประกอบการนําทางที่สําคัญเหล่านี้

ตารางนี้แสดงช่องสําหรับข้อมูลการนําทางและตําแหน่งที่จะพบ

ช่องสําหรับการนําทางแต่ละขั้นตอน	ช่องสำหรับการเดินทางโดยรวม
พบใน StepInfo	พบใน NavInfo
ชื่อถนนแบบเต็ม	เวลาที่เหลือ
ไอคอนการบังคับ	ระยะทางไปยังจุดหมาย
ระยะทางไปยังขั้นตอนถัดไป
ช่องคำแนะนำช่องทาง

คำแนะนำเลน

Navigation SDK จะแสดงเลนในการ์ดเลี้ยวของการนำทางเป็นออบเจ็กต์ข้อมูล Lane และ LaneDirection ออบเจ็กต์ Lane แสดงเลนเฉพาะระหว่างการนําทาง และมีรายการออบเจ็กต์ LaneDirection ที่อธิบายการเลี้ยวทั้งหมดที่ทำได้จากเลนนี้

ทิศทางที่แนะนําซึ่งผู้ใช้ควรใช้เลนจะระบุด้วยช่อง isRecommended

ตัวอย่างคำแนะนำช่องทาง

ข้อมูลโค้ดต่อไปนี้แสดงการนําเสนอข้อมูลของเลนที่แสดงอยู่ด้านบน

// Lane 1
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false},
                  {/*laneShape=*/ SLIGHT_LEFT, /*isRecommended=*/ true}]

// Lane 2
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false}]

สร้างไอคอนสำหรับการเคลื่อนไหว

อนุกรมManeuver กำหนดการหลบหลีกแต่ละครั้งที่อาจเกิดขึ้นขณะนำทาง และคุณรับการหลบหลีกสำหรับขั้นตอนหนึ่งๆ ได้จากเมธอด StepInfo.getManeuver()

คุณต้องสร้างไอคอนของกลยุทธ์และจับคู่กับกลยุทธ์ที่เกี่ยวข้อง สำหรับการเคลื่อนไหวบางอย่าง คุณสามารถตั้งค่าการแมปแบบ 1:1 กับไอคอนได้ เช่น DESTINATION_LEFT และ DESTINATION_RIGHT อย่างไรก็ตาม เนื่องจากการเคลื่อนไหวบางอย่างคล้ายกัน คุณจึงอาจต้องแมปการเคลื่อนไหวมากกว่า 1 รายการกับไอคอนเดียว ตัวอย่างเช่น TURN_LEFT และ ON_RAMP_LEFT อาจแมปกับไอคอนเลี้ยวซ้ายทั้งคู่

การเคลื่อนไหวบางอย่างมีป้ายกำกับ clockwise หรือ counterclockwise เพิ่มเติม ซึ่ง SDK จะกำหนดตามด้านที่ขับรถของประเทศ ตัวอย่างเช่น ในประเทศที่ขับรถเลนซ้าย ผู้ขับขี่จะเลี้ยวซ้ายหรือกลับรถตามเข็มนาฬิกา ส่วนประเทศที่ขับรถเลนขวาจะเลี้ยวขวาตามเข็มนาฬิกา Navigation SDK จะตรวจจับว่าการดำเนินการเปลี่ยนเลนเกิดขึ้นเมื่อมีการจราจรทางด้านซ้ายหรือขวา และแสดงผลการดำเนินการเปลี่ยนเลนที่เหมาะสม ดังนั้น ไอคอนการบังคับเลี้ยวของคุณจึงอาจแตกต่างกันไปสำหรับการบังคับเลี้ยวตามเข็มนาฬิกากับการบังคับเลี้ยวทวนเข็มนาฬิกา

ใช้ไอคอนที่สร้างขึ้น

Navigation SDK รองรับการสร้างไอคอนคำแนะนำในการเลี้ยวและเลนเพื่ออำนวยความสะดวกใน Use Case ของ Android Auto ไอคอนเหล่านี้เป็นไปตามคำแนะนำการปรับขนาดรูปภาพของไลบรารีแอป Android Auto Car ซึ่งแนะนำให้กำหนดเป้าหมายไปยังกล่องขอบเขตขนาด 500 x 74 dp ดูรายละเอียดได้ใน setsLaneImage และ CarIcon ในเอกสารอ้างอิง Android

ตัวอย่างการสร้างไอคอน

NavigationUpdatesOptions options =
  NavigationUpdatesOptions.builder()
             .setNumNextStepsToPreview(numNextStepsToPreview)
             .setGeneratedStepImagesType(GeneratedStepImagesType.BITMAP)
             .setDisplayMetrics(getResources().getDisplayMetrics())
             .build();
boolean isRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(),
              NavInfoReceivingService.class.getName(),
              options);

หลังจากเปิดใช้การสร้างไอคอนแล้ว ออบเจ็กต์ TurnbyTurn StepInfo จะสร้างช่อง maneuverBitmap และ lanesBitmap ด้วยไอคอน

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

• สำหรับแอป Android Auto
  • วาดแผนที่และเปิดใช้การนําทาง