ไปยังส่วนต่างๆ

ทำตามคู่มือนี้เพื่อวางเส้นทางภายในแอปไปยังปลายทางเดียวโดยใช้ Navigation SDK สำหรับ iOS

ภาพรวม

  1. ผสานรวม Navigation SDK เข้ากับแอปตามที่อธิบายไว้ในส่วนตั้งค่าโปรเจ็กต์
  2. กำหนดค่า GMSMapView
  3. แจ้งให้ผู้ใช้ยอมรับข้อกำหนดและเงื่อนไข รวมถึงให้สิทธิ์บริการตำแหน่งและการแจ้งเตือนในเบื้องหลัง
  4. สร้างอาร์เรย์ที่มีปลายทางอย่างน้อย 1 รายการ
  5. กำหนด GMSNavigator เพื่อควบคุมการนำทางแบบเลี้ยวต่อเลี้ยว

    • เพิ่มปลายทางโดยใช้ setDestinations
    • ตั้งค่า isGuidanceActive เป็น true เพื่อเริ่มการนำทาง
    • ใช้ simulateLocationsAlongExistingRoute เพื่อจำลองความคืบหน้าของยานพาหนะตามเส้นทางสำหรับการทดสอบ การแก้ไขข้อบกพร่อง และการแสดงแอป

ดูรหัส

แจ้งให้ผู้ใช้ให้สิทธิ์ที่จำเป็น

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

ให้สิทธิ์บริการตำแหน่ง

Navigation SDK ใช้บริการตำแหน่ง ซึ่งต้องได้รับสิทธิ์จากผู้ใช้ หากต้องการเปิดใช้บริการตำแหน่งและแสดงกล่องโต้ตอบการให้สิทธิ์ ให้ทำตามขั้นตอนต่อไปนี้

  1. เพิ่มคีย์ NSLocationAlwaysUsageDescription ลงใน Info.plist
  2. สำหรับค่า ให้เพิ่มคำอธิบายสั้นๆ ว่าเหตุใดแอปของคุณจึงต้องใช้บริการตำแหน่ง เช่น "แอปนี้ต้องมีสิทธิ์ใช้บริการหาตำแหน่งเพื่อนำทางแบบเลี้ยวต่อเลี้ยว"

  3. หากต้องการแสดงกล่องโต้ตอบการให้สิทธิ์ ให้เรียกใช้ requestAlwaysAuthorization() ของอินสแตนซ์ตัวจัดการตำแหน่ง

Swift

self.locationManager.requestAlwaysAuthorization()

Objective-C

[_locationManager requestAlwaysAuthorization];

ให้สิทธิ์การแจ้งเตือนสำหรับการแนะนำในเบื้องหลัง

Navigation SDK ต้องการสิทธิ์ของผู้ใช้เพื่อให้การแจ้งเตือนเมื่อแอปทำงานอยู่เบื้องหลัง เพิ่มโค้ดต่อไปนี้เพื่อแจ้งให้ผู้ใช้ขอสิทธิ์แสดงการแจ้งเตือนเหล่านี้

Swift

UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
  granted, error in
    // Handle denied authorization to display notifications.
    if !granted || error != nil {
      print("User rejected request to display notifications.")
    }
}

Objective-C

// Request authorization for alert notifications.
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
UNAuthorizationOptions options = UNAuthorizationOptionAlert;
[center requestAuthorizationWithOptions:options
                      completionHandler:
 ^(
   BOOL granted,
   NSError *_Nullable error) {
     if (!error && granted) {
       NSLog(@"iOS Notification Permission: newly Granted");
     } else {
       NSLog(@"iOS Notification Permission: Failed or Denied");
     }
   }];

ยอมรับข้อกำหนดและเงื่อนไข

ใช้โค้ดต่อไปนี้เพื่อแสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไข และเปิดใช้การไปยังส่วนต่างๆ เมื่อผู้ใช้ยอมรับข้อกำหนด โปรดทราบว่าตัวอย่างนี้รวมรหัสสําหรับบริการตําแหน่งและการแจ้งเตือนคําแนะนํา (แสดงก่อนหน้านี้)

Swift

  let termsAndConditionsOptions = GMSNavigationTermsAndConditionsOptions(companyName: "Ride Sharing Co.")

  GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(
    with: termsAndConditionsOptions) { termsAccepted in
    if termsAccepted {
      // Enable navigation if the user accepts the terms.
      self.mapView.isNavigationEnabled = true
      self.mapView.settings.compassButton = true

      // Request authorization to use location services.
      self.locationManager.requestAlwaysAuthorization()

      // Request authorization for alert notifications which deliver guidance instructions
      // in the background.
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
      granted, error in
        // Handle rejection of notification authorization.
        if !granted || error != nil {
          print("Authorization to deliver notifications was rejected.")
        }
      }
    } else {
      // Handle rejection of terms and conditions.
    }
  }

Objective-C

GMSNavigationTermsAndConditionsOptions *termsAndConditionsOptions = [[GMSNavigationTermsAndConditionsOptions alloc] initWithCompanyName:@"Ride Sharing Co."];

[GMSNavigationServices
  showTermsAndConditionsDialogIfNeededWithOptions:termsAndConditionsOptions
  callback:^(BOOL termsAccepted) {
   if (termsAccepted) {
     // Enable navigation if the user accepts the terms.
     _mapView.navigationEnabled = YES;
     _mapView.settings.compassButton = YES;

     // Request authorization to use the current device location.
     [_locationManager requestAlwaysAuthorization];

     // Request authorization for alert notifications which deliver guidance instructions
     // in the background.
     UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
     UNAuthorizationOptions options = UNAuthorizationOptionAlert;
     [center requestAuthorizationWithOptions:options
                           completionHandler:
     ^(
       BOOL granted,
       NSError *_Nullable error) {
         if (!error && granted) {
           NSLog(@"iOS Notification Permission: newly Granted");
         } else {
           NSLog(@"iOS Notification Permission: Failed or Denied");
         }
       }];
   } else {
     // Handle rejection of the terms and conditions.
   }
 }];

สร้างเส้นทางและเริ่มคำแนะนำ

หากต้องการวางแผนเส้นทาง ให้เรียกใช้เมธอด setDestinations() ของ Navigator ด้วยอาร์เรย์ที่มีปลายทาง (GMSNavigationWaypoint) อย่างน้อย 1 แห่งที่จะไป หากคำนวณสำเร็จ เส้นทางจะแสดงบนแผนที่ หากต้องการเริ่มคําแนะนําตลอดเส้นทาง โดยเริ่มจากจุดหมายแรก ให้ตั้งค่า isGuidanceActive เป็น true ใน callback

ตัวอย่างต่อไปนี้แสดงข้อมูลต่อไปนี้

  • การสร้างเส้นทางใหม่ที่มีปลายทาง 2 แห่ง
  • คำแนะนำในการเริ่มต้น
  • การเปิดใช้การแจ้งเตือนคำแนะนำขณะอยู่เบื้องหลัง
  • การจําลองการเดินทางไปตามเส้นทาง (ไม่บังคับ)
  • การตั้งค่าโหมดกล้องเป็น "ติดตาม" (ไม่บังคับ)

Swift

func startNav() {
  var destinations = [GMSNavigationWaypoint]()
  destinations.append(GMSNavigationWaypoint.init(placeID: "ChIJnUYTpNASkFQR_gSty5kyoUk",
                                                 title: "PCC Natural Market")!)
  destinations.append(GMSNavigationWaypoint.init(placeID:"ChIJJ326ROcSkFQRBfUzOL2DSbo",
                                                 title:"Marina Park")!)

  mapView.navigator?.setDestinations(destinations) { routeStatus in
    self.mapView.navigator?.isGuidanceActive = true
    self.mapView.locationSimulator?.simulateLocationsAlongExistingRoute()
    self.mapView.cameraMode = .following
  }
}

Objective-C

- (void)startNav {
  NSArray<GMSNavigationWaypoint *> *destinations =
  @[[[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJnUYTpNASkFQR_gSty5kyoUk"
                                             title:@"PCC Natural Market"],
    [[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJJ326ROcSkFQRBfUzOL2DSbo"
                                             title:@"Marina Park"]];

  [_mapView.navigator setDestinations:destinations
                             callback:^(GMSRouteStatus routeStatus){
                               [_mapView.locationSimulator simulateLocationsAlongExistingRoute];
                               _mapView.navigator.guidanceActive = YES;
                               _mapView.cameraMode = GMSNavigationCameraModeFollowing;
                             }];
}

ดูข้อมูลเกี่ยวกับรหัสสถานที่ได้ที่รหัสสถานที่

ตั้งค่าโหมดการเดินทาง

โหมดการเดินทางจะกำหนดประเภทเส้นทางที่จะดึงข้อมูล และวิธีกำหนดเส้นทางของผู้ใช้ คุณตั้งค่าโหมดการเดินทางได้ 1 ใน 4 โหมดสำหรับเส้นทาง ได้แก่ ขับรถ ปั่นจักรยาน เดิน และแท็กซี่ ในโหมดขับรถและแท็กซี่ เส้นทางของผู้ใช้จะอิงตามทิศทางการเดินทาง ส่วนในโหมดปั่นจักรยานและเดิน เส้นทางจะแสดงตามทิศทางที่อุปกรณ์หันไป

ตั้งค่าพร็อพเพอร์ตี้ travelMode ของมุมมองแผนที่ ดังที่แสดงในตัวอย่างต่อไปนี้

Swift

self.mapView.travelMode = .cycling

Objective-C

_mapView.travelMode = GMSNavigationTravelModeCycling;

ตั้งค่าถนนที่จะหลีกเลี่ยง

ใช้พร็อพเพอร์ตี้ avoidsHighways และ avoidsTolls BOOL เพื่อหลีกเลี่ยงทางหลวงและ/หรือถนนที่เก็บค่าผ่านทางตลอดเส้นทาง

Swift

self.mapView.navigator?.avoidsTolls = true

Objective-C

_mapView.navigator.avoidsTolls = YES;

เครื่องมือค้นหารหัสสถานที่

คุณสามารถใช้เครื่องมือค้นหารหัสสถานที่เพื่อค้นหารหัสสถานที่ที่จะใช้เป็นปลายทางของเส้นทาง เพิ่มปลายทางจาก placeID ด้วย GMSNavigationWaypoint

ข้อความที่ลอยอยู่

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