इस पेज का अनुवाद Cloud Translation API से किया गया है.

मार्कर के साथ मैप जोड़ना

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

कोड लोड हो रहा है

GitHub से Google Maps के iOS डेटा स्टोर करने की जगह को क्लोन करें या इसे डाउनलोड करें.

> मैप व्यू कंट्रोलर का Swift कोड दिखाएं/छिपाएं.

/*
 * Copyright 2020 Google Inc. All rights reserved.
 *
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
 * file except in compliance with the License. You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under
 * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
 * ANY KIND, either express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */

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

> मैप व्यू कंट्रोलर के लिए मकसद-सी कोड दिखाएं/छिपाएं.

/*
* Copyright 2020 Google Inc. All rights reserved.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
* file except in compliance with the License. You may obtain a copy of the License at
*
*     http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under
* the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
* ANY KIND, either express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/

#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

डेवलपमेंट प्रोजेक्ट सेट अप करना

iOS के लिए Maps SDK टूल इंस्टॉल करने के लिए, यह तरीका अपनाएं:

Xcode वर्शन 13.0 या बाद का वर्शन डाउनलोड और इंस्टॉल करें.
अगर आपके पास पहले से CocoaPods नहीं है, तो टर्मिनल से यह कमांड चलाकर उसे macOS पर इंस्टॉल करें:
```
sudo gem install cocoapods
```
Google Maps के iOS डेटा स्टोर करने की जगह का क्लोन बनाएं या डाउनलोड करें.
tutorials/map-with-marker डायरेक्ट्री पर जाएं.
pod install निर्देश चलाएं. ऐसा करने से, Podfile में मौजूद एपीआई इंस्टॉल हो जाएंगे. साथ ही, यह उनकी डिपेंडेंसी पर भी लागू हो जाएगा.
इंस्टॉल किए गए पॉड वर्शन की तुलना किसी नए अपडेट से करने के लिए pod outdated चलाएं. अगर नए वर्शन का पता चलता है, तो Podfile को अपडेट करने और SDK टूल का नया वर्शन इंस्टॉल करने के लिए, pod update चलाएं. ज़्यादा जानकारी के लिए, CocoaPods गाइड देखें.
प्रोजेक्ट की map-with-mark.xcworkspace फ़ाइल को खोलने के लिए उसे Xcode में खोलें. इस पर दो बार क्लिक करें. प्रोजेक्ट खोलने के लिए, .xcworkspace फ़ाइल का इस्तेमाल किया जाना चाहिए.

एक एपीआई कुंजी पाना और ज़रूरी एपीआई चालू करना

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

शुरू करें

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

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

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

ध्यान दें कि यह इंपोर्ट स्टेटमेंट फ़ाइल में जोड़ दिया गया है:
```
import GoogleMaps
```
YOUR_API_KEY को अपनी एपीआई कुंजी से बदलने के लिए, अपने application(_:didFinishLaunchingWithOptions:) वाले तरीके की इस लाइन में बदलाव करें:
```
GMSServices.provideAPIKey("YOUR_API_KEY")
```

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

अपने कंप्यूटर से कोई iOS डिवाइस कनेक्ट करें या Xcode स्कीम पॉप-अप मेन्यू से, सिम्युलेटर चुनें.
अगर किसी डिवाइस का इस्तेमाल किया जा रहा है, तो पक्का करें कि जगह की जानकारी की सुविधाएं चालू हों. अगर आप सिम्युलेटर का इस्तेमाल कर रहे हैं, तो सुविधाएं मेन्यू से कोई जगह चुनें.
Xcode में, प्रॉडक्ट/चलाएं मेन्यू के विकल्प (या चलाएं बटन का आइकॉन) पर क्लिक करें.

Xcode ऐप्लिकेशन बनाता है और उसे ऐप्लिकेशन को डिवाइस या सिम्युलेटर पर चलाता है.
आपको ऑस्ट्रेलिया के पूर्वी तट पर सिडनी के बीचो-बीच एक मार्कर वाला मैप दिखना चाहिए, जो इस पेज पर मौजूद इमेज की तरह है.

समस्या का हल:

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

कोड को समझना

मैप बनाएं और इसे loadView() में व्यू के तौर पर सेट करें.

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;

मैप में loadView() के लिए मार्कर जोड़ें.

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 टूल इस्तेमाल करने का तरीका भी सीखा है.

अगले चरण

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