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 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ì có thể bạn sẽ 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:

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 lớp này không chứa khoá API – cần thiết để cho phép 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 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 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. Giá trị này do API tạo tự động. Trình kết xuất phải đính kèm tệp 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.

Thuộc tính hiển thị

Phân bổ nghĩa là xác nhận nguồn của ô bản đồ và là yêu cầu bắt buộc để sử dụng API này – bao gồm thuộc tính thương hiệu Google (biểu trưng) cũng như thuộc tính 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 nội dung phản hồi, ở 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:

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

  2. Phân tách các nguồn về 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 đến ít lần nhất, tương tự như cách Google Earth thực hiện việc này.