किसी रास्ते पर नेविगेट करें

अपने ऐप्लिकेशन में एक डेस्टिनेशन पर रूट बनाने के लिए, इस गाइड का पालन करें, का उपयोग करके iOS के लिए नेविगेशन SDK का उपयोग कर सकते हैं.

खास जानकारी

  1. बताए गए तरीके से नेविगेशन SDK को अपने ऐप्लिकेशन में इंटिग्रेट करें अपना प्रोजेक्ट सेट अप करें सेक्शन में जाएं.
  2. GMSMapView को कॉन्फ़िगर करें.
  3. उपयोगकर्ता को नियम और शर्तें स्वीकार करने का निर्देश दें और जगह की जानकारी की अनुमति दें बैकग्राउंड में मिलने वाली सूचनाओं को ऐक्सेस करने की सुविधा मिलती है.
  4. एक या उससे ज़्यादा डेस्टिनेशन वाला कोई कलेक्शन बनाएं.
  5. GMSNavigator के बारे में बताएं मोड़-दर-मोड़ नेविगेशन कंट्रोल करने के लिए.

    • setDestinations का इस्तेमाल करके डेस्टिनेशन जोड़ें.
    • सेट करें isGuidanceActive नेविगेशन शुरू करने के लिए, true पर जाएं.
    • simulateLocationsAlongExistingRoute का इस्तेमाल करें टेस्टिंग के लिए, रास्ते में गाड़ी की प्रोग्रेस को सिम्युलेट करने के लिए, डीबग करना और आपके ऐप्लिकेशन को दिखाना.

कोड देखें

इससे उपयोगकर्ता को ज़रूरी अनुमतियां देने का निर्देश मिलता है

नेविगेशन SDK टूल का इस्तेमाल करने से पहले, उपयोगकर्ता को के नियमों और शर्तों को शामिल करने के अलावा, नेविगेशन के लिए ज़रूरी है. अगर आपका ऐप्लिकेशन बैकग्राउंड में चलता है, तो उसे भी उपयोगकर्ता को दिशा-निर्देश से जुड़ी चेतावनी की सूचनाएं देने का प्रॉम्प्ट मिलेगा. इस सेक्शन में अनुमति वाले ज़रूरी प्रॉम्प्ट दिखाने का तरीका क्या है.

जगह की जानकारी को अनुमति दें

नेविगेशन SDK टूल, जगह की जानकारी का इस्तेमाल करता है. इसके लिए ज़रूरी है उपयोगकर्ता की अनुमति. जगह की जानकारी की सुविधा चालू करने और अनुमति दिखाने के लिए तो यह तरीका अपनाएं:

  1. NSLocationAlwaysUsageDescription कुंजी को Info.plist में जोड़ें.
  2. वैल्यू के लिए, कम शब्दों में यह बताएं कि आपके ऐप्लिकेशन को जगह की जानकारी की ज़रूरत क्यों है सेवाओं. उदाहरण के लिए: "इस ऐप्लिकेशन को इन कामों के लिए, जगह की जानकारी का इस्तेमाल करने की अनुमति चाहिए मोड़-दर-मोड़ नेविगेशन पाएं."

  3. अनुमति देने वाला डायलॉग दिखाने के लिए, इसके requestAlwaysAuthorization() को कॉल करें लोकेशन मैनेजर इंस्टेंस.

Swift

self.locationManager.requestAlwaysAuthorization()

Objective-C

[_locationManager requestAlwaysAuthorization];

बैकग्राउंड में दिशा-निर्देश देने के लिए, सूचनाएं पाने की सुविधा चालू करें

चेतावनी देने के लिए, नेविगेशन 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() तरीके को कलेक्शन के साथ कॉल करें जिसमें एक या ज़्यादा गंतव्य (GMSNavigationWaypoint) शामिल हैं. अगर सफलतापूर्वक की गणना की जाती है, तो मार्ग को मैप पर दिखाया गया है. रास्ते के दिशा-निर्देश शुरू करने के लिए, पहले डेस्टिनेशन से शुरू करते हुए, isGuidanceActive को true पर सेट करें कॉलबैक.

यह उदाहरण दिखाता है:

  • दो गंतव्यों के साथ एक नया रास्ता बनाया जा रहा है.
  • दिशा-निर्देश शुरू किए जा रहे हैं.
  • बैकग्राउंड में दिशा-निर्देश की सूचनाएं पाने की सुविधा चालू की जा रही है.
  • रास्ते के साथ-साथ यात्रा को सिम्युलेट करना (ज़रूरी नहीं).
  • कैमरा मोड को "फ़ॉलो करें" पर सेट करना (ज़रूरी नहीं).

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;
                             }];
}

जगह के आईडी के बारे में जानने के लिए, कृपया जगह के आईडी देखें.

यात्रा का साधन सेट करें

यात्रा मोड से तय होता है कि किस तरह के रास्ते को फ़ेच किया जाएगा और उपयोगकर्ता का कोर्स तय होता है. आप चार में से एक मोड सेट कर सकते है मार्ग: ड्राइविंग, साइकिलिंग, पैदल चलना, और टैक्सी. ड्राइविंग और टैक्सी मोड में, उपयोगकर्ता का कोर्स यात्रा की दिशा के आधार पर; वॉकिंग और साइकलिंग मोड में है, तो जिसे डिवाइस की दिशा में दिखाया जाता है.

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 Finder का इस्तेमाल कर सकते हैं का इस्तेमाल करें. GMSNavigationWaypoint वाले placeID से मंज़िल जोड़ें.

फ़्लोटिंग टेक्स्ट

आप अपने ऐप्लिकेशन में कहीं भी फ़्लोटिंग टेक्स्ट जोड़ सकते हैं. हालांकि, इसके लिए Google एट्रिब्यूशन शामिल नहीं है. नेविगेशन SDK टूल, मैप पर अक्षांश/देशांतर के लिए टेक्स्ट लिखें. ज़्यादा जानकारी के लिए, जानकारी विंडो देखें.