รายละเอียดเกี่ยวกับฟีดข้อมูลแบบเลี้ยวต่อเลี้ยว

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

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

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

องค์ประกอบการแสดงผลการนำทางที่สำคัญ

หน้าจอมือถือที่แสดงการเลี้ยวขวาในอีก 15 เมตรไปยังถนนเชิร์ช ที่ด้านล่างของหน้าจอ เวลาที่เหลือจนถึงจุดหมายคือ 13 นาที และระยะทางที่เหลือคือ 2.1 ไมล์

ช่องหลักสำหรับขั้นตอนการนำทางแต่ละขั้นตอนคือชื่อถนนแบบเต็ม การเลี้ยว และระยะทางทั้งหมดของขั้นตอน ซึ่งมีอยู่ใน GMSNavigationStepInfo

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

ตั้งค่า Listener เหตุการณ์

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

หากต้องการใช้เครื่องจัดการเหตุการณ์ ตัวควบคุมมุมมองของแผนที่ต้องใช้ GMSNavigatorListener โปรโตคอล ดูข้อมูลโดยละเอียดเกี่ยวกับการจัดการเหตุการณ์ใน Navigation SDK สำหรับ iOS ได้ที่หัวข้อ Listen for navigation events

การจัดการเหตุการณ์ didChangeNavInfo

สร้าง Listener สำหรับเหตุการณ์ didChangeNavInfo เพื่อเพิ่มการรองรับแบบเลี้ยวต่อเลี้ยวลงในแอป ใน Listener เหตุการณ์ ให้ใช้คลาสและ Enum ต่อไปนี้เพื่อควบคุมการนำทางแบบเลี้ยวต่อเลี้ยว

  • GMSNavigationNavInfo \- คลาสที่กำหนดข้อมูลเกี่ยวกับสถานะการนำทาง

  • GMSNavigationStepInfo \- คลาสที่กำหนดข้อมูลเกี่ยวกับขั้นตอนเดียวตามเส้นทางการนำทาง

  • GMSNavigationNavState \- Enum ที่กำหนดสถานะปัจจุบันของการนำทาง เช่น กำลังเดินทาง เปลี่ยนเส้นทาง หรือหยุด

  • GMSNavigationDrivingSide \- Enum ที่กำหนดว่าขั้นตอนนี้อยู่ในเส้นทางขับชิดขวาหรือขับชิดซ้าย

  • GMSNavigationManeuver \- Enum ที่กำหนดการดำเนินการนำทางที่จะทำ เช่น เลี้ยวซ้ายหรือเลี้ยวขวา

ด้านล่างนี้คือตัวอย่าง Listener เหตุการณ์สำหรับเหตุการณ์ didChangeNavInfo

Swift

  // ViewController.swift
  class SomeViewController: UIViewController {
    ...
    mapView.navigator?.add(self);
    ...
  }

  extension SomeViewController: GMSNavigatorListener {
    func navigator(_ navigator: GMSNavigator,
                   didUpdateNavInfo navInfo: GMSNavigationNavInfo) {

      // Get the current step information
      if navInfo.navState == .enroute {
        if let currentStep = navInfo.currentStep {
          ...
          roadNameLabel.text = currentStep.simpleRoadName
          ...
        }
      }
    }
  }

Objective-C

  // ViewController.h
  @interface SomeViewController () <GMSNavigatorListener>

  @end

  // ViewController.m
  @implementation SomeViewController
  // Some initialization code.
  ... {
    ...
    [_mapView.navigator addListener:self];
    ...
  }

  #pragma mark GMSNavigatorListener
  - (void)navigator:(GMSNavigator *)navigator didUpdateNavInfo:(GMSNavigationNavInfo *)navInfo {
    // Get the current step information
    if (navInfo.navState == GMSNavigationNavStateEnroute) {
      GMSNavigationStepInfo *currentStep = navInfo.currentStep;
      if (currentStep) {
        ...
        roadNameLabel.text = currentStep.simpleRoadName;
        ...
      }
    }
    ...
  }

ใช้พร็อพเพอร์ตี้ navState ของ GMSNavigationNavInfo เพื่อดูสถานะปัจจุบันของการนำทาง ซึ่งจะเป็นสถานะใดสถานะหนึ่งต่อไปนี้

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

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

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

คำแนะนำช่องทาง

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

ระบบจะทำเครื่องหมายทิศทางที่แนะนำให้ผู้ขับขี่ใช้ในช่องทางโดยใช้ช่อง recommended

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

ข้อมูลโค้ดต่อไปนี้แสดงการแสดงข้อมูลของช่องทางที่แสดงในภาพหน้าจอก่อนหน้า

// Lane 1
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 2
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 3
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false}]

// Lane 4
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false},
{/*GMSNavigationLaneShape=*/ GMSNavigationLaneShapeNormalRight, /*recommended=*/ false}]

รูปภาพคำแนะนำช่องทาง

Navigation SDK รองรับการสร้างรูปภาพช่องทางสำหรับขั้นตอนการนำทางแต่ละขั้นตอนตามที่ระบุโดย GMSNavigationStepInfo ไอคอนเหล่านี้เหมาะกับคำแนะนำการปรับขนาดรูปภาพของ CarPlay

Swift

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)

Objective-C

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];

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

ไอคอนสำหรับการเลี้ยว

Enum GMSNavigationManeuverกำหนดการเลี้ยวที่เป็นไปได้แต่ละรายการที่อาจเกิดขึ้นขณะนำทาง และคุณ สามารถดูการเลี้ยวสำหรับขั้นตอนที่กำหนดได้จากพร็อพเพอร์ตี้ maneuver ของ GMSNavigationStepInfo

คุณต้องสร้างไอคอนการเลี้ยวและจับคู่กับรายการการเลี้ยวที่เกี่ยวข้อง สำหรับการเลี้ยวบางรายการ คุณสามารถตั้งค่าการแมปแบบหนึ่งต่อหนึ่งกับไอคอนได้ เช่น GMSNavigationManeuverDestinationLeft และ GMSNavigationManeuverDestinationRight อย่างไรก็ตาม เนื่องจากรายการการเลี้ยวบางรายการมีลักษณะเหมือนกับรายการการเลี้ยวอื่นๆ คุณจึงอาจต้องการแมปรายการการเลี้ยวมากกว่า 1 รายการกับไอคอนเดียว เช่น GMSNavigationManeuverTurnLeft และ GMSNavigationManeuverOnRampLeft อาจแมปกับไอคอนเลี้ยวซ้ายได้ทั้งคู่

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

ขยายเพื่อดูตัวอย่างไอคอนสำหรับการเลี้ยวต่างๆ

ไอคอนตัวอย่าง การเลี้ยวแบบเลี้ยวต่อเลี้ยว
DEPART
UNKNOWN
STRAIGHT
ON_RAMP_UNSPECIFIED
OFF_RAMP_UNSPECIFIED
NAME_CHANGE
TURN_RIGHT
ON_RAMP_RIGHT
TURN_LEFT
ON_RAMP_LEFT
TURN_SLIGHT_RIGHT
ON_RAMP_SLIGHT_RIGHT
OFF_RAMP_SLIGHT_RIGHT
TURN_SLIGHT_LEFT
ON_RAMP_SLIGHT_LEFT
OFF_RAMP_SLIGHT_LEFT
TURN_SHARP_RIGHT
ON_RAMP_SHARP_RIGHT
OFF_RAMP_SHARP_RIGHT
TURN_SHARP_LEFT
ON_RAMP_SHARP_LEFT
OFF_RAMP_SHARP_LEFT
TURN_U_TURN_COUNTERCLOCKWISE
ON_RAMP_U_TURN_COUNTERCLOCKWISE
OFF_RAMP_U_TURN_COUNTERCLOCKWISE
TURN_U_TURN_CLOCKWISE
ON_RAMP_U_TURN_CLOCKWISE
OFF_RAMP_U_TURN_CLOCKWISE
ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_RIGHT_CLOCKWISE
ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
ROUNDABOUT_STRAIGHT_CLOCKWISE
ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
ROUNDABOUT_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_LEFT_CLOCKWISE
ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_SHARP_LEFT_CLOCKWISE
ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
ROUNDABOUT_U_TURN_CLOCKWISE
ROUNDABOUT_COUNTERCLOCKWISE
ROUNDABOUT_CLOCKWISE
ROUNDABOUT_EXIT_COUNTERCLOCKWISE
ROUNDABOUT_EXIT_CLOCKWISE
MERGE_RIGHT
OFF_RAMP_RIGHT
MERGE_LEFT
OFF_RAMP_LEFT
FORK_RIGHT
TURN_KEEP_RIGHT
ON_RAMP_KEEP_RIGHT
OFF_RAMP_KEEP_RIGHT
FORK_LEFT
TURN_KEEP_LEFT
ON_RAMP_KEEP_LEFT
OFF_RAMP_KEEP_LEFT
MERGE_UNSPECIFIED
DESTINATION
DESTINATION_RIGHT
DESTINATION_LEFT
FERRY_BOAT
FERRY_TRAIN

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

Navigation SDK รองรับการสร้างไอคอนการเลี้ยวสำหรับ GMSNavigationStepInfo ที่กำหนด ไอคอนเหล่านี้เหมาะกับคำแนะนำการปรับขนาดรูปภาพของ CarPlay

Swift

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)

Objective-C

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];