Làm việc với trình kết xuất Thẻ thông tin 3D của riêng bạn

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

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 3D Tiles của riêng mình. Phương pháp này đòi hỏi bạn phải cân nhắc những yếu tố quan trọng sau:

URL nội dung

Khi phân phát Ô 3D ảnh thực tế, Map Tiles API sẽ trả về URI cho các nhóm ô con. Các URI tập hợp ô 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ố. Chúng không chứa khoá API của bạn (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 Quy cách về ô 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 Ô 3D ảnh thực tế. Bạn có thể kiểm tra các phần tử này bằng Công cụ cho nhà phát triển Chrome.

Yêu cầu mẫu về bộ ô gốc:

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

URI phản hồi mẫu của bộ ô:

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

URL yêu cầu ô 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 bộ ô, cùng với khoá API của bạn, khi tạo các yêu cầu ô tiếp theo. 3D Tiles API cung cấp 2 tham số sau:

session
Giá trị nhận dạng tích hợp cho phiên tải 3D. API sẽ tự động tạo mã này. Trình kết xuất phải đính kèm mã này khi tạo các yêu cầu về ô tiếp theo.
key
Khoá API mà bạn đã dùng để truy cập vào dịch vụ 3D Tiles. Bạn phải đính kèm mã này vào tất cả các yêu cầu về ô tiếp theo.

Thông tin ghi nhận sự đóng góp hiển thị

Ghi công có nghĩa là xác nhận nguồn của các ô bản đồ và là một yêu cầu bắt buộc để 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ư việc 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 về Map Tiles API. Thông tin về việc phân bổ dữ liệu được trả về trong mọi phản hồi của ô. Hãy tìm trong ô glTF, trong phần 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 quá trình kết xuất. Việc này bao gồm các bước sau:

  1. Trích xuất tất cả thông tin bản quyền từ tất cả các ô đang hiển thị.

  2. Phân tách nhiều nguồn bản quyền bằng dấu chấm phẩy.

  3. Sắp xếp thông tin dựa trên số lần xuất hiện.

  4. Hiển thị các nguồn bản quyền trên màn hình, sắp xếp từ nguồn xuất hiện nhiều nhất đến ít nhất, tương tự như cách Google Earth thực hiện.