Hướng dẫn nhanh về không gian địa lý cho Android

Hướng dẫn nhanh về API Không gian địa lý ARCore hướng dẫn bạn cách chạy ứng dụng mẫu trong Android Studio để minh hoạ API Không gian địa lý.

Để biết hướng dẫn phát triển ứng dụng của riêng bạn bằng API không gian địa lý, hãy xem Hướng dẫn dành cho nhà phát triển không gian địa lý cho Android (Kotlin/Java) hoặc Hướng dẫn dành cho nhà phát triển không gian địa lý cho Android NDK (C).

Xem Giới thiệu về API Không gian địa lý ARCore để biết thêm thông tin thông tin về API không gian địa lý.

Nếu bạn mới phát triển bằng ARCore, hãy xem phần Bắt đầu.

Yêu cầu

Hỗ trợ về thiết bị

Hãy xem phần Thiết bị được hỗ trợ để biết danh sách đầy đủ các thiết bị đã được chứng nhận là tương thích với ARCore. Đối với API không gian địa lý, một trong những phần cứng chính cần có là máy đo từ trường đáp ứng thông số kỹ thuật của API không gian địa lý. Một số từ kế không đáp ứng các thông số kỹ thuật; thiết bị có tính năng này không hỗ trợ từ kế không đúng thông số kỹ thuật.

Phần mềm

Mở và thiết lập ứng dụng mẫu

Dự án geospatial_java đi kèm với SDK ARCore cho Android mô tả mã gọi API không gian địa lý.

  1. Trong Android Studio, trên trình đơn File (Tệp), hãy nhấp vào Open (Mở).

  2. Chuyển đến thư mục dự án cho arcore-android-sdk.

  3. Mở thư mục samples, chọn thư mục geospatial_java rồi nhấp vào Mở.

Thiết lập một dự án trên Google Cloud

Để sử dụng Hệ thống định vị hình ảnh (VPS), ứng dụng của bạn cần phải được liên kết với một Dự án Google Cloud được bật cho API ARCore. Xem Sử dụng API ARCore trên Google Cloud để thiết lập lệnh uỷ quyền. Bạn có thể chọn uỷ quyền không dùng khoá hoặc Khoá API.

Chạy ứng dụng mẫu

Trong Android Studio, hãy chạy ứng dụng mẫu.

Bạn sẽ thấy được chế độ xem camera, cùng với thông tin gỡ lỗi mô tả tư thế Không gian địa lý hiện tại của thiết bị của bạn. Khi bạn quét môi trường xung quanh, hãy chú ý rằng các giá trị tin cậy về độ chính xác của vị trí có thể thay đổi khi bạn di chuyển xung quanh, nếu bạn ở khu vực được bản địa hoá VPS hỗ trợ.

Khi ARCore tự tin về vị trí và hướng của thiết bị, bạn có thể đặt một Điểm neo tại vị trí hiện tại bằng cách sử dụng tư thế Địa không gian.

Độ chính xác của định vị có thể quá thấp nếu không có thông tin về VPS. Chiến lược phát hành đĩa đơn ứng dụng phải có kết nối Internet và vị trí phải biết được vị trí. Để có kết quả tốt nhất, hãy chạy ứng dụng mẫu ở ngoài trời (không phải trong nhà) vào ban ngày.

Ngoài ra, nếu bạn đang ở trong khu vực không hỗ trợ VPS hoặc nếu tín hiệu GPS không phải là đủ, bạn có thể cần phải điều chỉnh ngưỡng tin cậy trong ứng dụng theo thứ tự để đặt quảng cáo cố định.

Cách điều chỉnh ngưỡng:

  1. Trong Android Studio, hãy mở GeospatialActivity rồi duyệt đến phần sau:

    // The thresholds that are required for horizontal and heading accuracies before entering into the
// LOCALIZED state. Once the accuracies are equal or less than these values, the app will
// allow the user to place anchors.
private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10;
private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;

  2. Hãy điều chỉnh các giá trị này nếu cần. Giá trị càng cao thì độ chính xác càng thấp.

    Việc giảm độ chính xác cho phép ứng dụng có nhiều tự do hơn trong việc đặt neo. Xem Điều chỉnh để đảm bảo tư thế chính xác để biết thêm thông tin.

Các bước tiếp theo