SDK bản đồ dành cho mã mẫu iOS

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

Kho lưu trữ SDK Bản đồ dành cho iOS trên GitHub chứa các mẫu minh hoạ cách sử dụng SDK Bản đồ dành cho iOS trong ứng dụng iOS của bạn. Ứng dụng mẫu này chứa mã cho các điểm nổi bật về tính năng của SDK, và có thể được dùng làm điểm xuất phát cho ứng dụng của bạn.

Khắc phục sự cố: Nếu ứng dụng mẫu chạy thành công nhưng bạn không thấy bản đồ, hãy kiểm tra để đảm bảo rằng bạn đã thêm khoá API vào tệp kê khai của ứng dụng, như mô tả trong phần Sử dụng khoá API.

Danh sách mẫu SDK Bản đồ dành cho iOS

Các hoạt động mẫu chính trong ứng dụng minh họa được liệt kê bên dưới và được sao chép trên các trang được liên kết để bạn tham khảo nhanh. Hãy xem thư mục mẫu trên GitHub để biết danh sách đầy đủ các mẫu hiện có.

• Hiển thị bản đồ cơ bản
• Hiển thị cửa sổ thông tin cho một điểm đánh dấu
• Thêm điểm đánh dấu vào bản đồ
• Mã hoá địa lý ngược một vị trí
• Bật và tắt cử chỉ trên bản đồ
• Xử lý sự kiện điểm đánh dấu
• Bật nút Vị trí của tôi
• Vẽ đa giác trên bản đồ
• Vẽ đường nhiều đoạn trên bản đồ

Chạy ứng dụng mẫu đầy đủ ở chế độ cục bộ

Ứng dụng mẫu SDK Bản đồ dành cho iOS có sẵn dưới dạng tệp lưu trữ có thể tải xuống trên GitHub. Hãy làm theo các bước sau để cài đặt và dùng thử ứng dụng mẫu SDK Bản đồ dành cho iOS.

Quan trọng: Bạn phải xoá mọi phần phụ thuộc hiện có được thêm bằng CocoaPods hoặc theo cách thủ công. Hãy xem Bước 2 của phần Thiết lập dự án Xcode để biết hướng dẫn.

1. Chạy git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git để sao chép kho lưu trữ mẫu vào một thư mục cục bộ.

2. Mở cửa sổ dòng lệnh, chuyển đến thư mục mà bạn đã sao chép các tệp mẫu rồi đi sâu vào thư mục GoogleMaps:

   Swift

   cd maps-sdk-for-ios-samples/GoogleMaps-Swift
   open GoogleMapsSwiftXCFrameworkDemos.xcodeproj

   Objective-C

   cd maps-sdk-for-ios-samples-main/GoogleMaps
   open GoogleMapsDemos.xcodeproj

3. Trong dự án Xcode, hãy chuyển đến File (Tệp) > Add Package Dependencies (Thêm phần phụ thuộc của gói). Nhập https://github.com/googlemaps/ios-maps-sdk làm URL, nhấn Enter để kéo gói vào rồi nhấp vào Add Package (Thêm gói).
4. Trong Xcode, hãy nhấn vào nút biên dịch để tạo ứng dụng bằng lược đồ hiện tại. Bản dựng sẽ tạo ra lỗi, nhắc bạn nhập khoá API vào tệp SDKConstants.swift cho Swift hoặcSDKDemoAPIKey.h tệp cho Objective-C.
5. Lấy khoá API từ dự án của bạn khi bật SDK Bản đồ dành cho iOS.
6. Chỉnh sửa tệp SDKConstants.swift cho Swift hoặc tệp SDKDemoAPIKey.h cho Objective-C rồi dán khoá API vào định nghĩa của hằng số apiKey hoặc kAPIKey. Ví dụ:

   Swift

   static let apiKey = "YOUR_API_KEY"

   Objective-C

   static NSString *const kAPIKey = @"YOUR_API_KEY";

7. Trong tệp SDKConstants.swift (Swift) hoặcSDKDemoAPIKey.h (Objective-C), hãy xoá dòng sau vì dòng này được dùng để đăng ký vấn đề do người dùng xác định:

   Swift

   #error (Register for API Key and insert here. Then delete this line.)

   Objective-C

   #error Register for API Key and insert here.

8. Tạo bản dựng và chạy dự án. Cửa sổ trình mô phỏng iOS sẽ xuất hiện, cho thấy danh sách Maps SDK Demos (Bản minh hoạ SDK Bản đồ).
9. Chọn một trong các lựa chọn được hiển thị để thử nghiệm một tính năng của SDK Bản đồ dành cho iOS.
10. Nếu được nhắc cho phép GoogleMapsDemos truy cập vào vị trí của bạn, hãy chọn Allow (Cho phép).