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ế, API Thẻ thông tin bản đồ sẽ trả về URI cho các thẻ thông tin con. Các URI tập ô này không phải là URL thông thường, chỉ bao gồm đường dẫn và thành phần 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 thẻ thông tin 3D.
Yêu cầu và phản hồi
Dưới đây là một số ví dụ về các yêu cầu và phản hồi Thẻ thông tin 3D ảnh thực tế. Bạn có thể kiểm tra 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 hợp thẻ thông tin gốc:
https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY
URI phản hồi Tilesset 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 tập thẻ thông tin, 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 2 thông số sau:
session- Giá trị nhận dạng tích hợp sẵn 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 thông tin 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 đối tượng 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ể xem biểu trưng của Google trên trang Chính sách API thẻ thông tin của bản đồ. Thông tin phân bổ dữ liệu sẽ được trả về trong mọi phản hồi thẻ thông tin. Hãy tìm mã này trong thẻ thông tin glTF, bên dưới 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.