Thiết lập và minh hoạ

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 bây giờ và lưu vào máy cục bộ của bạn. (Nếu bạn mới phát triển iOS, hãy tạo dự án mới và chọn Ứng dụng iOS mẫu. Trên Xcode 11.7 trở xuống, hãy tạo một Ứng dụng chế độ xem duy nhất.)
2. Thêm SDK Maps dành cho iOS làm phần phụ thuộc. Xem Cài đặt SDK để biết các lựa chọn.
3. Trong dự án Xcode của bạn, hãy chuyển đến Tệp -> Gói Swift -> Thêm phần phụ thuộc gói.
4. Trong cửa sổ hiện ra, hãy nhập URL kho lưu trữ Thư viện tiện ích 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 với tài khoản GitHub của mình. Làm theo để tạo một GitHub mã truy cập cá nhân để tiếp tục quy trình.
5. Trong cửa sổ tiếp theo, hãy chọn tuỳ chọn Version (Phiên bản), chọn Up to Next Major Version (Lên đến phiên bản lớn tiếp theo) từ danh sách thả xuống rồi nhập phiên bản mới nhất của SDK Maps dành 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 Add to Project (Thêm vào dự án), chọn dự án của bạn rồi chọn Add Package (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 bây giờ và lưu vào máy cục bộ của bạn. (Nếu bạn mới bắt đầu phát triển iOS, hãy tạo một Một Xem đơn đăng ký.)
2. Nếu bạn chưa có tệp nhóm cho dự án của mình, hãy tạo một tệp có tên Podfile trong thư mục dự án của bạ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 nhóm của dự án và thêm phần phụ thuộc vào Google-Maps-iOS-Utils nhóm. Dưới đây là một trong đó bao gồm các phần phụ thuộc cần thiết 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.0.0' # x-release-please-version
   end

4. Chạy pod install.
5. Đóng Xcode rồi mở (nhấp đúp) .xcworkspace để chạy Xcode. Kể từ thời điểm này trở đi, bạn phải dùng tệp .xcworkspace để mở dự án.

Lưu ý: Tiện ích phân cụm điểm đánh dấu phụ thuộc vào nhưng bạn có thể sử dụng bốn cây mà không cần phân cụm điểm đánh dấu. Nếu bạn muốn 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 nhóm của bạn.

Sử dụng tệp trên GitHub

1. Tải xuống kho lưu trữ mã mẫu từ GitHub và giải nén tệp 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à xem chi tiết 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 Target-C, hãy chạy cd google-maps-ios-utils-master/samples/ObjCDemoApp
3. Chạy lệnh sau:
   

   pod install

4. Đóng Xcode rồi mở (nhấp đúp) .xcworkspace để chạy Xcode. Kể từ thời điểm này trở đi, bạn phải dùng tệp .xcworkspace để mở dự án.

Sử dụng CocoaPods v1.6.1

1. Mở cửa sổ dòng lệnh và cài đặt phiên bản 1.6.1:

   sudo gem install cocoapods -v1.6.1

2. Tìm nạp các tệp Google Maps bằng Cocoapods:

   pod try Google-Maps-iOS-Utils

   Chọn Swift hoặc Object-C khi được nhắc. CocoaPods cập nhật kho lưu trữ thông số kỹ thuật của bạn, sau đó mở bản minh hoạ trong một dự án Xcode tạm thời có tên là SwiftDemoApp.xcodeproj hoặc ObjCDemoApp.xcodeproj.

Swift

Thêm khoá API vào AppDelegate.swift của bạn 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 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 của bạn 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 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 = @"";