मार्कर वाला मैप जोड़ना

इस ट्यूटोरियल में, अपने iOS ऐप्लिकेशन में मार्कर के साथ एक आसान Google मैप जोड़ने का तरीका बताया गया है. यह उन लोगों के लिए है जिनके पास Swift या Objective-C के बारे में शुरुआती या इंटरमीडिएट जानकारी है. साथ ही, उनके पास Xcode के बारे में सामान्य जानकारी भी होनी चाहिए. मैप बनाने के बारे में ज़्यादा जानने के लिए, डेवलपर गाइड पढ़ें.

इस ट्यूटोरियल का इस्तेमाल करके, आपको यह मैप बनाना होगा. मार्कर, ऑस्ट्रेलिया के सिडनी में है.

कोड प्राप्त करें

GitHub पर, Google Maps के iOS सैंपल रिपॉज़िटरी को क्लोन या डाउनलोड करें.

इसके अलावा, सोर्स कोड को डाउनलोड करने के लिए, इस बटन पर क्लिक करें:

मुझे कोड दें

import UIKit
import GoogleMaps

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        // Create a GMSCameraPosition that tells the map to display the
        // coordinate -33.86,151.20 at zoom level 6.
        let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
        let mapView = GMSMapView.map(withFrame: self.view.frame, camera: camera)
        self.view.addSubview(mapView)

        // Creates a marker in the center of the map.
        let marker = GMSMarker()
        marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
        marker.title = "Sydney"
        marker.snippet = "Australia"
        marker.map = mapView
  }
}
      

#import "ViewController.h"
#import <GoogleMaps/GoogleMaps.h>

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
  // Do any additional setup after loading the view.
  // Create a GMSCameraPosition that tells the map to display the
  // coordinate -33.86,151.20 at zoom level 6.
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                          longitude:151.20
                                                               zoom:6];
  GMSMapView *mapView = [GMSMapView mapWithFrame:self.view.frame camera:camera];
  mapView.myLocationEnabled = YES;
  [self.view addSubview:mapView];

  // Creates a marker in the center of the map.
  GMSMarker *marker = [[GMSMarker alloc] init];
  marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
  marker.title = @"Sydney";
  marker.snippet = @"Australia";
  marker.map = mapView;
}

@end
      

अपनी प्रोफ़ाइल बनाना शुरू करें

एपीआई पासकोड पाना और ज़रूरी एपीआई चालू करना

इस ट्यूटोरियल को पूरा करने के लिए, आपके पास ऐसी Google API कुंजी होनी चाहिए जिसे iOS के लिए Maps SDK टूल का इस्तेमाल करने की अनुमति मिली हो. पासकोड पाने और एपीआई को चालू करने के लिए, नीचे दिए गए बटन पर क्लिक करें.

ज़्यादा जानकारी के लिए, एपीआई पासकोड पाना देखें.

अपने ऐप्लिकेशन में एपीआई पासकोड जोड़ना

AppDelegate.swift में अपनी एपीआई कुंजी इस तरह जोड़ें:

1. ध्यान दें कि फ़ाइल में इंपोर्ट स्टेटमेंट जोड़ा गया है:

   import GoogleMaps

2. अपने application(_:didFinishLaunchingWithOptions:) तरीके में दी गई इस लाइन में बदलाव करें. इसके लिए, YOUR_API_KEY को अपने एपीआई पासकोड से बदलें:

   GMSServices.provideAPIKey("YOUR_API_KEY")

अपना ऐप्लिकेशन बनाना और चलाना

1. अपने कंप्यूटर से कोई iOS डिवाइस कनेक्ट करें या Xcode स्कीम मेन्यू से कोई सिम्युलेटर चुनें.
2. अगर किसी डिवाइस का इस्तेमाल किया जा रहा है, तो पक्का करें कि जगह की जानकारी की सेटिंग चालू हो. अगर सिम्युलेटर का इस्तेमाल किया जा रहा है, तो सुविधाएं मेन्यू से कोई जगह चुनें.
3. Xcode में, प्रॉडक्ट/रन मेन्यू विकल्प (या प्ले बटन आइकॉन) पर क्लिक करें.
• Xcode, ऐप्लिकेशन को बनाता है और फिर उसे डिवाइस या सिम्युलेटर पर चलाता है.
• आपको एक मैप दिखेगा, जिसमें ऑस्ट्रेलिया के पूर्वी तट पर सिडनी के बीच में मार्कर होगा. यह मैप, इस पेज पर दी गई इमेज जैसा ही होगा.

समस्या निवारण:

• अगर आपको कोई मैप नहीं दिखता है, तो देखें कि आपने एपीआई पासकोड हासिल किया है या नहीं. साथ ही, यह भी देखें कि आपने जैसा कि पहले बताया गया है, उसे ऐप्लिकेशन में जोड़ा है या नहीं. एपीआई पासकोड से जुड़ी गड़बड़ियों के मैसेज के लिए, Xcode के डीबगिंग कंसोल को देखें.
• अगर आपने iOS बंडल आइडेंटिफ़ायर के हिसाब से एपीआई कुंजी पर पाबंदी लगाई है, तो ऐप्लिकेशन के लिए बंडल आइडेंटिफ़ायर जोड़ने के लिए, कुंजी में बदलाव करें: com.google.examples.map-with-marker.
• पक्का करें कि आपके पास अच्छा वाई-फ़ाई या जीपीएस कनेक्शन हो.
• लॉग देखने और ऐप्लिकेशन को डीबग करने के लिए, Xcode के डीबगिंग टूल का इस्तेमाल करें.

कोड को समझना

1. कोई मैप बनाएं और उसे viewDidLoad() में व्यू के तौर पर सेट करें.

   Swift

   // Create a GMSCameraPosition that tells the map to display the
   // coordinate -33.86,151.20 at zoom level 6.
   let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
   let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)
   view = mapView
         

   Objective-C

   // Create a GMSCameraPosition that tells the map to display the
   // coordinate -33.86,151.20 at zoom level 6.
   GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                           longitude:151.20
                                                                zoom:6.0];
   GMSMapView *mapView = [[GMSMapView alloc] initWithFrame: CGRectZero camera:camera];
   self.view = mapView;
         

2. viewDidLoad() में मैप पर मार्कर जोड़ें.

   Swift

   // Creates a marker in the center of the map.
   let marker = GMSMarker()
   marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
   marker.title = "Sydney"
   marker.snippet = "Australia"
   marker.map = mapView
         

   Objective-C

   // Creates a marker in the center of the map.
   GMSMarker *marker = [[GMSMarker alloc] init];
   marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
   marker.title = @"Sydney";
   marker.snippet = @"Australia";
   marker.map = mapView;
         

डिफ़ॉल्ट रूप से, iOS के लिए Maps SDK, जानकारी वाली विंडो का कॉन्टेंट तब दिखाता है, जब उपयोगकर्ता किसी मार्कर पर टैप करता है. अगर आपको डिफ़ॉल्ट व्यवहार का इस्तेमाल करना है, तो मार्कर के लिए क्लिक लिसनर जोड़ने की ज़रूरत नहीं है.

बधाई हो! आपने iOS ऐप्लिकेशन बनाया है, जो किसी खास जगह की जानकारी देने के लिए, मार्कर के साथ Google मैप दिखाता है. आपने iOS के लिए Maps SDK का इस्तेमाल करने का तरीका भी जाना है.

अगले चरण

मैप ऑब्जेक्ट के बारे में ज़्यादा जानें. साथ ही, यह भी जानें कि मार्कर का इस्तेमाल करके क्या-क्या किया जा सकता है.