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 chứa mã cho các tính năng nổi bật 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 hoạ được liệt kê dưới đây và được tái hiện tại các trang được liên kết để bạn tham khảo nhanh. 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 đ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 đánh dấu
• Bật nút Vị trí của tôi
• Vẽ đa giác trên bản đồ
• Vẽ hình nhiều đường trên bản đồ

Chạy ứng dụng mẫu hoàn chỉnh trên máy cục bộ

Ứng dụng mẫu SDK bản đồ dành cho iOS được cung cấp dưới dạng bản 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. 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 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 và xem chi tiết trong 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 phím Enter để lấy gói và 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ặc tệpSDKDemoAPIKey.h cho Objective-C.
5. Lấy khoá API từ dự án của bạn khi SDK bản đồ dành cho iOS được bật.
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ặc tệp SDKDemoAPIKey.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 Bản minh hoạ SDK Maps.
9. Chọn một trong các lựa chọn 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 thông tin vị trí của bạn, hãy chọn Cho phép.