Thiết lập và minh hoạ

Chọn nền tảng: Android iOS

Trang này mô tả cách thiết lập thư viện tiện ích cho SDK Bản đồ dành cho iOS.

Để dùng thử các tiện ích này, bạn có thể:

• Cài đặt thư viện tiện ích vào một dự án Xcode hiện có. Thêm các tiện ích này vào dự án của riêng bạn.
• Cài đặt và chạy ứng dụng minh hoạ. Ứng dụng minh hoạ là một dự án độc lập chứa tất cả mã cần thiết để thử các tiện ích.

Thêm SDK Bản đồ cho Thư viện tiện ích iOS vào dự án Xcode

Làm theo các bước sau để thêm thư viện tiện ích vào không gian làm việc Xcode:

Sử dụng Trình quản lý gói Swift

1. Nếu bạn chưa có dự án Xcode, hãy tạo một dự án ngay và lưu dự án đó vào máy cục bộ. (Nếu bạn mới bắt đầu phát triển iOS, hãy tạo một dự án mới rồi chọn mẫu Ứng dụng iOS. Trên Xcode 11.7 trở xuống, hãy tạo một Single View Application (Ứng dụng một chế độ xem).)
2. Thêm SDK Bản đồ dành cho iOS làm phần phụ thuộc. Hãy xem phần Cài đặt SDK để biết các tuỳ chọn.
3. Trong dự án Xcode, hãy chuyển đến File (Tệp) -> Swift Packages (Gói Swift) -> Add Package Dependency (Thêm phần phụ thuộc gói).
4. Trong cửa sổ hiển thị, hãy nhập URL kho lưu trữ Thư viện tiện ích SDK Maps cho iOS https://github.com/googlemaps/google-maps-ios-utils rồi chọn Tiếp theo.
• Tại thời điểm này, bạn có thể được nhắc xác thực bằng tài khoản GitHub. Làm theo hướng dẫn để tạo mã thông báo truy cập cá nhân trên GitHub nhằm tiếp tục quy trình.
5. Trong cửa sổ tiếp theo, hãy chọn tuỳ chọn Phiên bản, chọn Tới phiên bản chính tiếp theo trong danh sách thả xuống rồi nhập phiên bản mới nhất của SDK Maps cho Thư viện tiện ích iOS (ví dụ: "6.0.0").
6. Nhấp vào trình đơn thả xuống bên cạnh Thêm vào dự án, chọn dự án của bạn rồi chọn Thêm gói.

Sử dụng CocoaPods

1. Nếu bạn chưa có dự án Xcode, hãy tạo một dự án ngay và lưu dự án đó vào máy cục bộ. (Nếu bạn mới làm quen với việc phát triển iOS, hãy tạo một Ứng dụng có một thành phần hiển thị.)
2. Nếu bạn chưa có tệp pod cho dự án, hãy tạo một tệp có tên là Podfile trong thư mục dự án. Tệp này xác định các phần phụ thuộc của dự án.
3. Chỉnh sửa tệp pod của dự án và thêm phần phụ thuộc vào pod Google-Maps-iOS-Utils. Dưới đây là một ví dụ bao gồm các phần phụ thuộc bạn cần cho SDK Bản đồ dành cho iOS và thư viện tiện ích:

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '9.0.0'
     pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version
   end

4. Chạy pod install.
5. Đóng Xcode, sau đó mở (nhấp đúp) tệp .xcworkspace của dự án để chạy Xcode. Từ thời điểm này trở đi, bạn phải sử dụng tệp .xcworkspace để mở dự án.

Lưu ý: Tiện ích cụm điểm đánh dấu phụ thuộc vào cây 4 chiều, nhưng bạn có thể sử dụng cây 4 chiều mà không cần cụm điểm đánh dấu. Nếu chỉ muốn sử dụng tiện ích quadtree, bạn có thể thay đổi pod 'Google-Maps-iOS-Utils' thành 'Google-Maps-iOS-Utils/QuadTree' trong tệp pod.

Thêm khoá API vào ứng dụng

Hãy xem phần Thiết lập dự án Xcode để biết hướng dẫn tạo khoá API và thêm khoá đó vào dự án Xcode.

Tạo bản dựng và chạy dự án

Sau khi thêm khoá API, hãy tạo và chạy dự án.

Sử dụng tiện ích trong ứng dụng

Hãy xem tài liệu về từng tiện ích để biết thêm thông tin về cách sử dụng tiện ích đó trong ứng dụng:

• Nhóm điểm đánh dấu
• Quadtree
• Kết xuất KML
• Kết xuất GeoJSON
• Bản đồ nhiệt

Cài đặt và chạy ứng dụng minh hoạ

Thư viện tiện ích bao gồm một ứng dụng minh hoạ mà bạn có thể cài đặt rồi dùng thử từng tiện ích.

Cài đặt ứng dụng minh hoạ:

Sử dụng tệp từ GitHub

1. Tải xuống bản lưu trữ mẫu mã từ GitHub rồi giải nén bản lưu trữ.
2. Mở cửa sổ dòng lệnh, chuyển đến thư mục mà bạn đã mở rộng các tệp mẫu và đi sâu vào thư mục mẫu thích hợp cho ngôn ngữ bạn muốn sử dụng:
   • Đối với Swift, hãy chạy cd google-maps-ios-utils-master/samples/SwiftDemoApp
   • Đối với Objective-C, hãy chạy cd google-maps-ios-utils-master/samples/ObjCDemoApp
3. Chạy lệnh sau:
   

   pod install

4. Đóng Xcode, sau đó mở (nhấp đúp) tệp .xcworkspace của dự án để chạy Xcode. Từ thời điểm này trở đi, bạn phải sử dụng tệp .xcworkspace để mở dự án.

Thêm khoá API vào ứng dụng minh hoạ

Trong phần Tạo khoá API, bạn sẽ tạo một khoá API cho ứng dụng của mình. Bây giờ, hãy thêm khoá đó vào dự án Xcode cho ứng dụng minh hoạ.

Lưu ý: Nếu khoá API của bạn sử dụng Hạn chế ứng dụng, hãy đảm bảo rằng bạn thêm giá trị nhận dạng gói của ứng dụng vào khoá. Ví dụ: nếu bạn đang chạy ứng dụng minh hoạ, thì giá trị nhận dạng gói sẽ là com.google.gmsutils.DemoApp. Hãy xem bài viết Lấy khoá API để biết thêm thông tin về việc hạn chế khoá.

Swift

Thêm khoá API vào AppDelegate.swift như sau:

1. Thêm câu lệnh nhập sau:

   import GoogleMaps

2. Chỉnh sửa dòng sau để thêm khoá API của bạn vào giữa dấu ngoặc kép:

   // Change this key to a valid key registered with the demo app bundle id.
   let mapsAPIKey = ""

Objective-C

Thêm khoá API vào AppDelegate.m như sau:

1. Thêm câu lệnh nhập sau:

   @import GoogleMaps;

2. Chỉnh sửa dòng sau để thêm khoá API của bạn vào giữa dấu ngoặc kép:

   // Change this key to a valid key registered with the demo app bundle id.
   static NSString *const kMapsAPIKey = @"";

Tạo bản dựng và chạy ứng dụng minh hoạ

Sau khi bạn thêm khoá API, hãy tạo và chạy dự án:

• Nếu đang chạy phiên bản Swift của bản minh hoạ, bạn có thể chọn tiện ích để xem trong ứng dụng.
• Nếu đang chạy phiên bản Objective-C của bản minh hoạ, bạn sẽ thấy bản minh hoạ về tiện ích cụm điểm đánh dấu. Sau đó, bạn có thể chỉnh sửa phiên bản Objective-C của bản minh hoạ để thử từng tiện ích. Hãy xem phần Thêm tiện ích vào ứng dụng ở bên dưới để biết thêm thông tin.