Thêm bản đồ bằng điểm đánh dấu

Hướng dẫn này chỉ cho bạn cách thêm bản đồ Google đơn giản bằng điểm đánh dấu vào iOS của bạn . Phiên bản này phù hợp với những người có kiến thức sơ cấp hoặc trung cấp về Swift hoặc Mục tiêu-C cùng với kiến thức chung về Xcode. Để xem hướng dẫn nâng cao về tạo bản đồ, đọc thông tin hướng dẫn của nhà phát triển của chúng tôi.

Bạn sẽ tạo bản đồ dưới đây bằng hướng dẫn này. Điểm đánh dấu được đặt ở Sydney, Úc.

Lấy mã

Sao chép hoặc tải xuống Kho lưu trữ mẫu Google Maps dành cho iOS trên GitHub.

Hoặc, nhấp vào nút sau để tải xuống mã nguồn:

Đưa mã cho tôi

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
      

Bắt đầu

Nhận khoá API và bật các API cần thiết

Để hoàn tất hướng dẫn này, bạn cần có khoá API của Google được phép hãy sử dụng SDK Bản đồ dành cho iOS. Nhấp vào nút sau đây để tải một khoá và kích hoạt API đó.

Để biết thêm thông tin, hãy xem Tải khoá API.

Thêm khoá API vào ứng dụng của bạn

Thêm khoá API vào AppDelegate.swift của bạn như sau:

1. Lưu ý rằng câu lệnh nhập sau đã được thêm vào tệp:

   import GoogleMaps

2. Chỉnh sửa dòng sau trong application(_:didFinishLaunchingWithOptions:) của bạn thay thế YOUR_API_KEY bằng khoá API:

   GMSServices.provideAPIKey("YOUR_API_KEY")

Tạo và chạy ứng dụng

1. Kết nối thiết bị iOS với máy tính của bạn hoặc chọn một trình mô phỏng từ trình đơn lược đồ Xcode.
2. Nếu bạn đang sử dụng một thiết bị, hãy đảm bảo rằng dịch vụ vị trí đã được bật. Nếu bạn đang sử dụng trình mô phỏng, hãy chọn một vị trí trong phần Các tính năng .
3. Trong Xcode, hãy nhấp vào tuỳ chọn trình đơn Product/Run (Sản phẩm/Chạy) (hoặc phát biểu tượng nút).
• Xcode sẽ tạo ứng dụng, sau đó chạy ứng dụng trên thiết bị hoặc trên trình mô phỏng.
• Bạn sẽ thấy một bản đồ có một điểm đánh dấu ở giữa Sydney trên bờ biển phía đông của Úc, tương tự như hình ảnh trên trang này.

Gỡ rối:

• Nếu bạn không thấy bản đồ, hãy kiểm tra xem bạn đã lấy được khoá API và đã thêm cho ứng dụng, như mô tả trước đó. Séc Bảng điều khiển gỡ lỗi của Xcode để xem các thông báo lỗi về khoá API.
• Nếu bạn đã hạn chế khoá API theo mã nhận dạng gói iOS, hãy chỉnh sửa để thêm giá trị nhận dạng gói cho ứng dụng: com.google.examples.map-with-marker.
• Đảm bảo rằng bạn có kết nối Wi-Fi hoặc GPS tốt.
• Sử dụng công cụ gỡ lỗi Xcode để xem nhật ký và gỡ lỗi ứng dụng.

Tìm hiểu mã nguồn

1. Tạo bản đồ rồi đặt làm chế độ xem trong 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. Thêm một điểm đánh dấu vào bản đồ trong 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;
         

Theo mặc định, SDK bản đồ dành cho iOS hiển thị nội dung của thông tin khi người dùng nhấn vào một điểm đánh dấu. Bạn không cần thêm trình nghe lượt nhấp cho điểm đánh dấu nếu bạn muốn sử dụng chế độ mặc định.

Xin chúc mừng! Bạn đã xây dựng một ứng dụng iOS hiển thị bản đồ Google với điểm đánh dấu để chỉ báo một vị trí cụ thể. Bạn cũng tìm hiểu cách sử dụng SDK Bản đồ dành cho iOS.

Các bước tiếp theo

Tìm hiểu thêm về đối tượng bản đồ và những gì bạn có thể làm với điểm đánh dấu.