Nếu không thể kết hợp sản phẩm kết xuất của bên thứ ba vào giải pháp của mình, thì bạn có thể phải tạo trình kết xuất Thẻ thông tin 3D của riêng mình. Phương pháp này yêu cầu bạn cân nhắc các yếu tố quan trọng sau:
URL nội dung
Khi phân phát Thẻ thông tin 3D ảnh thực tế, Map Tiles API sẽ trả về URI cho các thẻ thông tin con. Các URI tập hợp thẻ thông tin này không phải là URL thông thường. Chúng chỉ bao gồm thành phần đường dẫn và tham số. Các mã này không chứa khoá API (yêu cầu bắt buộc để uỷ quyền cho yêu cầu của bạn). Để biết thêm thông tin, hãy xem Thông số kỹ thuật về Thẻ thông tin 3D.
Yêu cầu và phản hồi
Sau đây là một số ví dụ về yêu cầu và phản hồi của Thẻ thông tin 3D chân thực. Bạn có thể kiểm tra các tệp này bằng cách sử dụng Công cụ cho nhà phát triển Chrome.
Yêu cầu mẫu về tập thẻ thông tin gốc:
https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY
URI phản hồi của tập thẻ thông tin mẫu:
/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg
URL yêu cầu thẻ thông tin mẫu mà trình kết xuất sử dụng:
https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY
https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY
Bạn nên đính kèm mọi tham số xuất hiện trong URI của tileset, cùng với khoá API, khi tạo các yêu cầu thẻ thông tin tiếp theo. API Thẻ thông tin 3D cung cấp hai tham số sau:
session- Mã nhận dạng tích hợp cho phiên tải 3D. Mã này được API tự động tạo. Trình kết xuất phải đính kèm thuộc tính này khi tạo các yêu cầu thẻ thông tin tiếp theo.
key- Khoá API mà bạn đã dùng để truy cập vào dịch vụ Thẻ thông tin 3D. Bạn phải đính kèm tệp này vào tất cả các yêu cầu thẻ thông tin tiếp theo.
Hiển thị thông tin ghi nhận sự đóng góp
Ghi công có nghĩa là xác nhận nguồn của thẻ thông tin trên bản đồ và là yêu cầu để sử dụng API này – bao gồm cả việc ghi công thương hiệu Google (biểu trưng) cũng như ghi công dữ liệu. Bạn có thể sử dụng biểu trưng của Google trên trang Chính sách về API Thẻ thông tin trên Maps. Thông tin phân bổ dữ liệu được trả về trong mọi phản hồi thẻ thông tin. Tìm trong thẻ thông tin glTF, trong asset, copyright.
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
Bạn phải tổng hợp, sắp xếp và hiển thị thông tin này trên một dòng văn bản, thường ở cuối kết xuất. Quá trình này bao gồm các bước sau:
Trích xuất tất cả thông tin bản quyền từ tất cả thẻ thông tin trong chế độ xem.
Phân tách nhiều nguồn bản quyền bằng dấu chấm phẩy.
Sắp xếp thông tin dựa trên số lần xuất hiện.
Hiển thị các nguồn bản quyền trên màn hình, được sắp xếp từ nhiều lần xuất hiện nhất đến ít nhất, tương tự như cách Google Earth thực hiện.