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

Nếu bạn không thể kết hợp sản phẩm kết xuất của bên thứ ba vào , 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 trò chơi xếp hình cho trẻ em. Các URI tập ô này không phải là URL thông thường. Chúng chỉ bao gồm đường dẫn và tham số. Chúng không chứa khoá API của bạn, để 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 hãy 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 thẻ thông tin 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 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 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
Giá trị nhận dạng tích hợp sẵn cho phiên tải 3D. Quảng cáo này được tạo tự động bởi API. Trình kết xuất phải đính kèm tệp này khi tạo đoạn mã yêu cầu thẻ thông tin.
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 đối với việc sử dụng API này, bao gồm cả thuộc tính thương hiệu (biểu trưng) của Google cũng như phân bổ dữ liệu. Biểu trưng Google có sẵn cho bạn trên Chính sách về API Thẻ thông tin của bản đồ. Dữ liệu thông tin phân bổ được trả về trong mọi phản hồi ô. Hãy tìm kiế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 kết xuất. Quá trình 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ả thẻ thông tin trong chế độ xem.

  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, được sắp xếp theo thứ tự từ hầu hết các lần xuất hiện cho đến ít nhất, tương tự như cách Google Earth làm được.