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 xem xét các yếu tố quan trọng sau đây:
URL nội dung
Khi phân phát Thẻ thông tin 3D ảnh thực, API Thẻ thông tin bản đồ sẽ trả về URI cho các thẻ thông tin con. Các URI của tập hợp ô này không phải là URL thông thường mà chỉ bao gồm thành phần đường dẫn và tham số. Chúng không chứa khoá API của bạn, đây là khoá bắt buộc để cấp phép 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 của thẻ thông tin 3D.
Yêu cầu và phản hồi
Dưới đây là một số ví dụ về yêu cầu và phản hồi Thẻ thông tin 3D ảnh thực tế. Bạn kiểm tra chúng bằng Công cụ cho nhà phát triển Chrome.
Yêu cầu tập hợp ô gốc mẫu:
https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY
URI phản hồi của tập hợp ô 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 thẻ thông tin cùng với khoá API khi tạo các yêu cầu tiếp theo về thẻ thông tin. API Thẻ thông tin 3D cung cấp hai tham số sau:
session- Giá trị nhận dạng tích hợp sẵn cho một phiên tải 3D. Dữ liệu này do API tạo tự động. Trình kết xuất phải đính kèm trình kết xuất 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.
Thuộc tính hiển thị
Phân bổ có nghĩa là xác nhận nguồn của ô bản đồ và là một yêu cầu để sử dụng API này – bao gồm cả thuộc tính thương hiệu Google (biểu trưng) cũng như thuộc tính dữ liệu. Biểu trưng của Google có sẵn cho bạn trên trang Chính sách của API Thẻ thông tin trên bản đồ. Thông tin phân bổ dữ liệu sẽ được trả về trong mỗi phản hồi cho thẻ thông tin. Hãy tìm mã này trong nội dung phản hồi, trong JSON 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 là ở cuối quá trình 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 của tất cả các ô mà bạn 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 theo thứ tự từ ít xuất hiện nhất đến ít nhất, tương tự như cách Google Earth thực hiện.