Chính sách API Thẻ thông tin Bản đồ

Tài liệu này liệt kê các yêu cầu đối với ứng dụng được phát triển bằng API Bản đồ ô. Lưu ý rằng việc sử dụng API Thẻ thông tin của bản đồ chịu sự điều chỉnh của Thoả thuận của bạn với Google.

Cung cấp điều khoản sử dụng và chính sách quyền riêng tư

Nếu bạn phát triển ứng dụng API Thẻ thông tin của bản đồ, bạn phải cung cấp Điều khoản Sử dụngQuyền riêng tư Chính sách liên quan đến đơn đăng ký của bạn đáp ứng các nguyên tắc được nêu trong Thoả thuận của bạn với Google:

  • Điều khoản sử dụngChính sách quyền riêng tư phải được công khai sẵn có.
  • Bạn phải nêu rõ trong Điều khoản sử dụng của ứng dụng của mình rằng khi sử dụng ứng dụng, người dùng bị ràng buộc bởi Điều khoản của Google Dịch vụ.
  • Bạn phải thông báo cho người dùng trong Chính sách quyền riêng tư rằng bạn đang sử dụng API của Google Maps và kết hợp bằng cách tham khảo Chính sách quyền riêng tư của Google.

Nơi được đề xuất cung cấp Điều khoản sử dụngChính sách quyền riêng tư phụ thuộc vào nền tảng của ứng dụng của bạn.

Ứng dụng dành cho thiết bị di động

Nếu đang phát triển một ứng dụng di động, bạn nên cung cấp đường liên kết đến Điều khoản sử dụngChính sách quyền riêng tư đối với ứng dụng của bạn trang tải xuống trong cửa hàng ứng dụng liên quan và trong phần cài đặt ứng dụng .

Ứng dụng web

Nếu đang phát triển một ứng dụng web, bạn nên cung cấp đường liên kết đến Điều khoản sử dụngChính sách quyền riêng tư ở chân trang của bạn.

Tìm nạp trước, lưu vào bộ nhớ đệm hoặc lưu trữ nội dung

Ứng dụng sử dụng API Thẻ thông tin bản đồ chịu sự ràng buộc của các điều khoản của Thoả thuận với Google. Theo các điều khoản trong Thoả thuận của bạn, bạn không được tìm nạp trước, lập chỉ mục, lưu trữ hoặc lưu vào bộ nhớ đệm bất kỳ Nội dung nào ngoại trừ điều kiện được nêu trong điều khoản.

Cụ thể, các ứng dụng nên sử dụng API Thẻ thông tin của bản đồ để trực quan hoá bản đồ. Bạn không được sử dụng API Thẻ thông tin của bản đồ cho những trường hợp sử dụng không có hình ảnh trực quan, chẳng hạn như:

  • Phân tích hình ảnh
  • Diễn giải máy
  • Phát hiện/nhận dạng đối tượng
  • Trích xuất hoặc bán lại dữ liệu địa lý
  • Sử dụng ngoại tuyến, bao gồm cho bất kỳ mục đích nào ở trên

Phản hồi của API Thẻ thông tin của bản đồ có thể bao gồm tiêu đề Cache-Control. Tiêu đề này phải là được triển khai theo giao thức HTTP tài liệu của Google. Ví dụ: ứng dụng của bạn phải tôn trọng giá trị max-age, stale-while-revalidate, lệnh must-revalidateprivate khi chúng được truyền trong phản hồi.

Phản hồi của API Thẻ thông tin của bản đồ cũng có thể bao gồm tiêu đề ETag. Tiêu đề này cũng sẽ được triển khai theo tài liệu về giao thức HTTP khi yêu cầu bằng xác thực lại.

Lưu ý rằng mã địa điểm, được dùng để xác định duy nhất một địa điểm, được miễn các hạn chế về việc lưu vào bộ nhớ đệm. Mã địa điểm được trả về trong trường "place_id" trong Phản hồi của API Thẻ thông tin của bản đồ. Tìm hiểu cách lưu, làm mới và quản lý mã địa điểm trong hướng dẫn về Mã địa điểm.

Khi bạn sử dụng API Thẻ thông tin của bản đồ để hiển thị Google Maps, bạn cũng phải hiển thị biểu tượng của Google trên bản đồ và bạn không được thay đổi biểu tượng theo bất kỳ cách nào. Bạn nên đặt biểu trưng Google vào góc dưới bên trái của bản đồ và bạn nên đặt thông tin ghi công ở góc bên phải bản đồ của Google. Để biết thêm thông tin, hãy xem Nguyên tắc của Trung tâm tài nguyên thương hiệu.

Để có trải nghiệm bản đồ 3D đậm chất điện ảnh hơn, tức là nếu các yêu cầu thiết kế trải nghiệm người dùng không thể sẵn sàng đáp ứng những vị trí này mới, bạn vẫn nên hiển thị rõ ràng biểu trưng Google ở đầu hoặc kết thúc hoặc cả hai kết thúc của trải nghiệm, sao cho quyền tác giả của bản đồ được độc giả của bạn hiểu. Bạn vẫn phải tuân thủ việc hiển thị các thuộc tính liên quan đến dữ liệu của bên thứ ba như mô tả dưới đây trong suốt thời gian diễn ra trải nghiệm điện ảnh. Xem phần Hiển thị biểu trưng và phân bổ dữ liệu trong hình ảnh trực quan kết hợp dưới đây để được hướng dẫn thêm.

Ví dụ sau đây về bản đồ hiển thị biểu trưng Google ở phía dưới bên trái của bản đồ, và thuộc tính ở phía dưới bên phải.

Tệp zip sau đây chứa biểu trưng Google có kích thước chính xác dành cho máy tính, ứng dụng Android và iOS. Bạn không được đổi kích thước hoặc sửa đổi các biểu trưng này theo bất kỳ cách nào.

Tải xuống: google_logo.zip

Đừng sửa đổi thông tin ghi nhận sự đóng góp. Không xóa, che khuất hoặc cắt bỏ thuộc tính của bạn. Bạn không thể sử dụng biểu trưng của Google cùng dòng (ví dụ: "Những bản đồ này từ [Google_logo]").

Liên tục phân bổ giá trị đóng góp. Nếu sử dụng ảnh chụp màn hình hình ảnh của Google bên ngoài nhúng trực tiếp, bao gồm thuộc tính chuẩn như xuất hiện trong hình ảnh. Nếu cần, bạn có thể tuỳ chỉnh kiểu và vị trí của văn bản thuộc tính, miễn là văn bản trong phạm vi gần nội dung và dễ đọc với người xem hoặc độc giả thông thường. Bạn không được di chuyển thông tin ghi nhận tác giả ra khỏi nội dung, chẳng hạn như đến cuối cuốn sách, các thông tin ghi công của tệp hoặc chương trình hay phần chân trang của trang web.

Bao gồm cả nhà cung cấp dữ liệu bên thứ ba. Một số dữ liệu và hình ảnh trên bản đồ của chúng tôi các sản phẩm này đến từ các nhà cung cấp không phải Google. Nếu sử dụng hình ảnh như vậy, văn bản thuộc tính phải thể hiện tên "Google" và(các) nhà cung cấp dữ liệu có liên quan, chẳng hạn như "Dữ liệu bản đồ: Google, Maxar Technologies." Trường hợp nhà cung cấp dữ liệu của bên thứ ba được trích dẫn với hình ảnh, chỉ bao gồm "Google" hoặc biểu trưng của Google không có thuộc tính thích hợp.

Nếu bạn đang sử dụng Nền tảng Google Maps trên một thiết bị không có màn hình ghi nhận tác giả thiết thực, hãy hãy liên hệ với nhóm bán hàng của Google để thảo luận về các giấy phép phù hợp với trường hợp sử dụng của bạn.

Hiển thị biểu trưng của Google bằng trình kết xuất của bên thứ ba

Khi bạn sử dụng API Thẻ thông tin của bản đồ để hiển thị Google Maps bằng cách sử dụng trình kết xuất đồ hoạ của bên thứ ba, bạn không được chồng chéo hoặc che khuất biểu trưng Google bằng bất kỳ biểu trưng khác, chẳng hạn như biểu trưng của trình kết xuất. Duy trì khoảng cách hợp lý đối với vùng đệm giữa biểu trưng của Google và biểu trưng của bên thứ ba để chúng xuất hiện dưới dạng biểu trưng độc lập. Không có biểu trưng nào có thể chồng chéo hoặc che khuất ghi nhận tác giả dữ liệu được cung cấp bởi phản hồi của API.

Hình ảnh được kết xuất có biểu trưng của Google và Cesium

Hiển thị các thuộc tính về dữ liệu của Google

Dữ liệu được trả về từ API Thẻ thông tin bản đồ yêu cầu hiển thị thuộc tính và thông tin bản quyền từ thông tin siêu dữ liệu hoặc khung nhìn thích hợp yêu cầu. Bạn phải hiển thị đầy đủ thông tin này như được cung cấp trong vị trí thích hợp, thường là góc dưới cùng bên phải của tập hợp ô hoặc trong chế độ xem trình kết xuất 3D. Xin lưu ý rằng các chuỗi thuộc tính tùy thuộc vào dữ liệu bản đồ mà khung nhìn của trình kết xuất yêu cầu.

Trường hợp không thể hiển thị đầy đủ thuộc tính dữ liệu do kích thước khung nhìn hãy cân nhắc thêm một phần tử di chuột qua hoặc phần tử có thể nhấp trên giao diện người dùng có nhãn "Dữ liệu nguồn", sẽ mở ra trong cửa sổ bản đồ để cung cấp thông tin phân bổ. Luôn cố gắng duy trì khả năng vẽ bản đồ tốt thực tiễn.

Chân trang chứa biểu trưng của Google và thuộc tính của nhà cung cấp dữ liệu.

Hiển thị thông tin ghi nhận sự đóng góp cho dữ liệu của bên thứ ba

Khi bạn sử dụng API Thẻ thông tin của bản đồ để hiển thị Google Maps dưới dạng bản đồ cơ sở và phủ dữ liệu không gian địa lý của bên thứ ba (không phải của Google), bạn có thể bắt buộc phải hiển thị phân bổ giá trị đóng góp từ nhà cung cấp dữ liệu của bên thứ ba. Bạn không được chồng chéo hoặc che khuất thuộc tính dữ liệu của Google theo bất kỳ cách nào với dữ liệu của bên thứ ba. Ghi nhận tác giả dữ liệu của bên thứ ba phải rõ ràng không được liên kết với thuộc tính dữ liệu của Google. Ngoài ra, thông tin đó phải rõ ràng biểu trưng của Google và thuộc tính dữ liệu của Google được liên kết với bản đồ cơ sở và với nhau.

Hiển thị biểu trưng và thuộc tính dữ liệu trong hình ảnh trực quan kết hợp

Khi bạn sử dụng dữ liệu Google Maps làm bản đồ cơ sở trong khi phủ bản đồ của riêng mình dữ liệu, bạn phải đảm bảo đối tượng của mình hoàn toàn hiểu được phần nào của bản đồ hình ảnh trực quan nào được phân bổ cho Google và các phần nào được phân bổ cho dữ liệu bản đồ của riêng bạn. Ngoài ra, hãy tuân thủ các nguyên tắc trong bài viết Hiển thị biểu trưng Google ở trên.

Ví dụ: hãy cân nhắc việc kết hợp Thẻ thông tin 3D ảnh thực (làm trình lấp đầy nền) với mô hình ảnh chân thực riêng (ở nền trước). Người dùng có thể bị nhầm lẫn về thành phần nào của cảnh bắt nguồn từ dữ liệu của Google Maps. Trong các trường hợp như vậy, bạn phải nêu rõ trong chuỗi thuộc tính giao diện người dùng hoặc luồng người dùng phần nào của cảnh bắt nguồn từ dữ liệu của Google Maps. Bạn chịu trách nhiệm tuân thủ mọi yêu cầu phân bổ của bên thứ ba có thể áp dụng cho nguồn dữ liệu mà bạn sử dụng với dữ liệu Google Maps.

Lớp phủ dữ liệu địa lý với Ô 3D ảnh thực

Bạn có thể phủ các đối tượng 3D của riêng mình lên các Ô 3D ảnh thực tế miễn là đối tượng 3D đó không trích xuất, theo dấu hoặc được lấy theo cách thủ công hay bằng máy từ Ô 3D ảnh thực.

Tạo video bằng API ô bản đồ

  • Video quảng cáo: Bạn có thể tạo video quảng cáo tuân theo các điều khoản của Thoả thuận và những điều sau:
    • Video quảng cáo không được bao gồm hình ảnh ở Chế độ xem đường phố.
    • Video quảng cáo không được dài quá 30 giây.
    • Video quảng cáo phải nói về khả năng của ứng dụng.
    • Video quảng cáo phải được đánh dấu rõ ràng "cho mục đích quảng cáo chỉ" và phải tuân thủ Nguyên tắc phân bổ trong Chính sách về API Thẻ thông tin của bản đồ.
    • Bạn không được bán riêng video quảng cáo hoặc là một phần của phần mềm, ứng dụng hoặc trải nghiệm người dùng.
  • Yêu cầu gỡ bỏ: Bạn có trách nhiệm tuân thủ mọi yêu cầu gỡ bỏ Video quảng cáo, bao gồm cả yêu cầu từ các bên thứ ba.

Nhận thông tin ghi công và bản quyền từ trường copyright trong phản hồi của các lệnh gọi API sau đây, tuỳ thuộc vào dịch vụ bạn đang sử dụng:

Ô 2D

Ô Bản đồ đường đi, Vệ tinh và Địa hình

Thông tin bản quyền và ghi công có sẵn từ thông tin khung nhìn phản hồi, như được thể hiện trong ví dụ sau.

{
  "copyright": "Map data ©2023",
  "maxZoomRects": [
    {
      "maxZoom": 19,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    ...
  ]
}

Ô Chế độ xem phố

Thông tin ghi công và bản quyền có sẵn trong siêu dữ liệu của Chế độ xem đường phố của bạn. Ví dụ:

{
  "panoId": "Zzl28rqGJgaL2IdkUleP8A",
  "lat": 50.059138596550696,
  "imageHeight": 6656,
  "imageWidth": 13312,
  "tileHeight": 512,
  "tileWidth": 512,
  "copyright": "From the Owner, Photo by: Google",
  
}

ID ảnh toàn cảnh, được sử dụng để xác định duy nhất một ảnh toàn cảnh của Chế độ xem phố, được miễn khỏi hạn chế lưu vào bộ nhớ đệm. Do đó, bạn có thể lưu trữ các giá trị mã nhận dạng ảnh toàn cảnh vô thời hạn. Giá trị mã ảnh toàn cảnh được trả về trong trường panoId trên Đường Xem phản hồi của API tĩnh.

Ô 3D ảnh thực tế

Đối với Thẻ thông tin 3D ảnh thực tế, dữ liệu phân bổ được trả về trong mỗi yêu cầu thẻ thông tin. Bạn phải tổng hợp, sắp xếp và hiển thị trong một dòng, tất cả các thuộc tính cho được hiển thị tiles; thường là dọc theo phần dưới cùng của quá trình kết xuất. Ví dụ: bạn có thể tìm thấy phân bổ dữ liệu trong glTF Thẻ thông tin bằng cách xem trong phần asset, copyright.

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

CesiumJS

Nếu bạn đang sử dụng CesiumJS làm trình kết xuất đồ hoạ, thì để hiển thị , bạn cần bật showCreditsOnScreen trong HTML hiển thị của mình.

// Add Photorealistic 3D Tiles tileset.
    const tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
      url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
      // This property is needed to appropriately display attributions
      // as required.
      showCreditsOnScreen: true,
    }));

Cesium cho Unreal

Nếu bạn đang sử dụng Cesium cho Unreal làm trình kết xuất đồ hoạ, hãy hiển thị ghi nhận tác giả, bạn cần bật trường Hiển thị ghi nhận tác giả trên màn hình trong World Outliner

Cách bật tính năng phân bổ cho Cesium cho
Không thực tế

Cesium cho Unity

Nếu bạn đang sử dụng Cesium cho Unity làm trình kết xuất đồ hoạ, thì để hiển thị ghi nhận tác giả, bạn cần bật trường Hiển thị ghi nhận tác giả trên màn hình trong Bảng điều khiển trình kiểm tra.

Cách bật tính năng phân bổ cho Cesium cho
Unity

Nguyên tắc về kiểu cho mô hình phân bổ trên Google

Sau đây là nguyên tắc chọn kiểu cho các thuộc tính của Google trong CSS và HTML nếu bạn không thể sử dụng biểu trưng Google có thể tải xuống.

Không gian trống

Khoảng không gian trống xung quanh đường khoá phải bằng hoặc lớn hơn chiều cao thuộc "G" trong Google.

Khoảng cách giữa bản sao thuộc tính và biểu trưng Google phải bằng một nửa chiều rộng của chữ "G".

Mức độ dễ đọc

Dòng tên tác giả phải luôn rõ ràng, dễ đọc và xuất hiện có đúng biến thể màu sắc để thông tin cơ bản nhất định. Luôn đảm bảo cung cấp đủ độ tương phản cho biến thể biểu trưng mà bạn chọn.

Màu

Sử dụng văn bản Google Material Gray 700 trên nền trắng hoặc sáng với phạm vi từ 0% đến 40% tông màu đen tối đa.

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

Trên nền tối hơn và trên ảnh chụp hoặc các mẫu không bận rộn, hãy sử dụng văn bản màu trắng cho dòng ghi tên tác giả và phân bổ giá trị đóng góp.

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

Phông chữ

Sử dụng Phông chữ Roboto.

Dịch vụ so sánh giá (CSS) mẫu

CSS sau đây, khi áp dụng cho văn bản "Google", sẽ hiển thị "Google" với tính năng thích hợp phông chữ, màu sắc và khoảng cách trên nền trắng hoặc sáng.

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;