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ể tích 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 của riêng mình. Phương pháp này yêu cầu bạn phải cân nhắc các 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 bộ ô con. Các URI bộ ô 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ạn cần khoá này để uỷ quyền cho yêu cầu). Để biết thêm thông tin, hãy xem phần Yêu cầu về Ô 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 của Ô 3D ảnh thực tế. Bạn có thể kiểm tra các yêu cầu và phản hồi 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 về bộ ô:

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

URL yêu cầu ô mẫu do 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 bộ ô, cùng với khoá API 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 giá trị này. Trình kết xuất phải đính kèm giá trị này khi tạo các yêu cầu ô tiếp theo.
key
Khoá API mà bạn đã dùng để truy cập vào dịch vụ Ô 3D. Bạn phải đính kèm khoá này vào tất cả các yêu cầu ô tiếp theo.

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

Thông tin ghi nhận sự đóng góp có nghĩa là xác nhận nguồn của các ô bản đồ và là một yêu cầu để sử dụng API này. Thông tin này bao gồm thông tin ghi nhận sự đóng góp về thương hiệu Google (logo) cũng như thông tin ghi nhận sự đóng góp về dữ liệu. Bạn có thể tìm thấy logo Google trên trang Chính sách của Map Tiles API. Thông tin ghi nhận sự đóng góp về dữ liệu được trả về trong mọi phản hồi về ô. Hãy tìm thông tin này trong ô glTF , 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. Điều 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 ô 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, sắp xếp theo thứ tự 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.