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 Thẻ thông tin của bản đồ. Xin lưu ý rằng việc sử dụng API Thẻ thông tin trên bản đồ chịu sự điều chỉnh của thoả thuận giữa bạn và Google.
Cung cấp điều khoản sử dụng và chính sách quyền riêng tư
Nếu phát triển một ứ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ụng và Chính sách quyền riêng tư cho ứng dụng của mình. Những nội dung này đáp ứng các nguyên tắc nêu trong Thoả thuận của bạn với Google:
- Điều khoản sử dụng và Chính sách quyền riêng tư phải được cung cấp công khai.
- Bạn phải nêu rõ trong Điều khoản sử dụng của ứng dụng rằng khi sử dụng ứng dụng, người dùng phải tuân thủ Điều khoản dịch vụ của Google.
- Bạn phải thông báo cho người dùng trong Chính sách quyền riêng tư của mình rằng bạn đang sử dụng(các) API Google Maps và kết hợp bằng cách dẫn chiếu Chính sách quyền riêng tư của Google.
Nơi bạn nên cung cấp Điều khoản sử dụng và Chí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 phát triển ứng dụng di động, bạn nên cung cấp đường liên kết đến Điều khoản sử dụng và Chính sách quyền riêng tư trên trang tải xuống của ứng dụng trong cửa hàng ứng dụng có liên quan và trong trình đơ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ụng và Chính sách quyền riêng tư ở chân trang web.
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 của bản đồ chịu sự ràng buộc của các điều khoản trong Thoả thuận của bạ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ừ các điều kiện giới hạn được nêu trong các điều khoản.
Cụ thể, ứ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 trên bản đồ cho bất kỳ trường hợp sử dụng nào không phải để trực quan hoá, chẳng hạn như:
- Phân tích hình ảnh
- Diễn giải bằng 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
sẽ được triển khai theo tài liệu về giao thức HTTP. Ví dụ: ứng dụng của bạn phải tuân thủ giá trị max-age
, giá trị stale-while-revalidate
, lệnh must-revalidate
và lệnh private
khi đượ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 xác thực lại.
Xin lưu ý rằng mã địa điểm dùng để xác định duy nhất một địa điểm sẽ không phải tuân thủ các quy định 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.
Hiển thị biểu trưng Google
Khi 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 trưng Google trên bản đồ và không được thay đổi biểu trưng theo bất kỳ cách nào. Bạn nên đặt biểu trưng Google ở góc dưới cùng bên trái của bản đồ và đặt thông tin ghi công ở góc bên phải của bản đồ. Để biết thêm thông tin, hãy xem các nguyên tắc của Trung tâm tài nguyên thương hiệu.
Đối với trải nghiệm bản đồ 3D đậm chất điện ảnh hơn, nghĩa là nếu các yêu cầu thiết kế trải nghiệm của bạn không thể phù hợp với các hướng dẫn về vị trí này, thì bạn vẫn nên hiển thị rõ ràng biểu trưng Google ở đầu hoặc cuối hoặc cả hai đầu trải nghiệm để đối tượng của bạn hiểu được quyền tác giả của bản đồ. Bạn vẫn phải tuân thủ việc hiển thị thông tin ghi công dữ liệu của bên thứ ba như mô tả dưới đây trong suốt thời lượng của trải nghiệm điện ảnh. Hãy xem phần Cách hiển thị biểu trưng và các thuộc tính dữ liệu trong hình ảnh trực quan kết hợp bên dưới để biết thêm hướng dẫn.
Ví dụ về bản đồ sau đây cho thấy 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.
Để sử dụng trên nền sáng | Để sử dụng trên nền tố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 thay đổ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 xoá, che khuất hoặc cắt bỏ thông tin phân bổ. 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 đến từ [Google_logo]").
Giữ cho mô hình phân bổ gần nhau. Nếu sử dụng ảnh chụp màn hình của hình ảnh trên Google bên ngoài tính năng nhúng trực tiếp, hãy thêm thông tin ghi công tiêu chuẩn như 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 ghi công, miễn là văn bản đó nằm gần nội dung và người xem hoặc người đọc thông thường có thể đọc được. Bạn không được di chuyển phần ghi công ra khỏi nội dung, chẳng hạn như ra cuối sách, phần ghi công của tệp hoặc chương trình hoặc 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 các sản phẩm lập bản đồ của chúng tôi là của các nhà cung cấp khác ngoài Google. Nếu sử dụng hình ảnh như vậy, văn bản ghi công của bạn phải có 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". Khi có nhà cung cấp dữ liệu bên thứ ba được trích dẫn cùng với hình ảnh, việc chỉ ghi "Google" hoặc biểu trưng Google là chưa đủ.
Nếu bạn đang sử dụng Nền tảng Google Maps trên một thiết bị không phù hợp với chế độ hiển thị thông tin ghi công, vui lòng 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 Google bằng trình kết xuất của bên thứ ba
Khi sử dụng API Thẻ thông tin trên bản đồ để hiển thị Google Maps bằng trình kết xuất 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 nào khác, chẳng hạn như biểu trưng của trình kết xuất. Duy trì khoảng đệm hợp lý 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 thuộc tính dữ liệu do phản hồi của API cung cấp.
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 trên bản đồ yêu cầu hiển thị thông tin ghi công và bản quyền từ các yêu cầu siêu dữ liệu hoặc thông tin khung nhìn thích hợp. Bạn nên hiển thị toàn bộ thông tin này như được cung cấp ở vị trí thích hợp, thường là góc dưới cùng bên phải của nhóm thẻ thông tin hiển thị hoặc trong chế độ xem trình kết xuất 3D. Xin lưu ý rằng các chuỗi phân bổ có thể biến đổi, tuỳ 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.
Nếu không thể hiển thị đầy đủ thông tin phân bổ dữ liệu do các quy tắc ràng buộc về kích thước khung nhìn, hãy cân nhắc thêm một phần tử giao diện người dùng có thể nhấp hoặc di chuột qua có nhãn "Nguồn dữ liệu". Phần tử này sẽ mở trong cửa sổ bản đồ để cung cấp thông tin phân bổ. Luôn cố gắng duy trì các phương pháp vẽ bản đồ tốt.
Hiển thị thông tin ghi công dữ liệu của bên thứ ba
Khi sử dụng API Thẻ thông tin của bản đồ để hiển thị dữ liệu 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), có thể bạn sẽ phải hiển thị thông tin ghi công 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 làm lu mờ mô hình phân bổ dữ liệu của Google theo bất kỳ cách nào với mô hình phân bổ dữ liệu của bên thứ ba. Phân bổ dữ liệu của bên thứ ba phải được tách biệt rõ ràng với phân bổ dữ liệu của Google. Ngoài ra, phải rõ ràng 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à thông tin ghi công dữ liệu trong hình ảnh trực quan kết hợp
Khi sử dụng dữ liệu của Google Maps làm bản đồ cơ sở trong khi phủ dữ liệu bản đồ của riêng bạn, bạn phải đảm bảo rằng đối tượng của bạn hiểu rõ phần nào của bản đồ trực quan là do Google cung cấp và phần nào là do dữ liệu bản đồ của riêng bạn cung cấp. Ngoài ra, hãy tuân thủ các nguyên tắc trong phần 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 tế (dùng làm nền) với các mô hình ảnh thực tế của riêng bạn (ở nền trước). Người dùng có thể bị nhầm lẫn về việc thành phần nào của cảnh bắt nguồn từ dữ liệu Google Maps. Trong những 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 trong luồng người dùng rằng phần nào của cảnh bắt nguồn từ dữ liệu 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 các nguồn dữ liệu mà bạn sử dụng với dữ liệu của 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 Thẻ thông tin 3D ảnh thực tế, miễn là các đối tượng 3D đó không được trích xuất, theo dõi hoặc bắt nguồn theo cách thủ công hoặc bằng máy từ Thẻ thông tin 3D ảnh thực tế.
Tạo video bằng API ô bản đồ
- Video quảng bá: Bạn có thể tạo video quảng bá 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 bá phải nói về các tính năng của (các) ứng dụng.
- Video quảng cáo phải được đánh dấu rõ ràng "chỉ nhằm mục đích quảng bá" và phải tuân thủ Nguyên tắc phân bổ trong Chính sách của API Thẻ thông tin bản đồ.
- Bạn không được bán lại video quảng cáo một cách riêng biệt hoặc bán kèm theo 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 bá, bao gồm cả yêu cầu của bên thứ ba.
Truy xuất thông tin ghi công và bản quyền
Nhận thông tin phân bổ và bản quyền từ trường copyright
trong phản hồi của các lệnh gọi API sau, tuỳ thuộc vào dịch vụ bạn đang sử dụng:
Ô 2D
Thẻ thông tin Lộ trình, Vệ tinh và Địa hình
Thông tin bản quyền và thông tin ghi công có sẵn trong phản hồi thông tin khung nhìn, như trong ví dụ sau.
{
"copyright": "Map data ©2023",
"maxZoomRects": [
{
"maxZoom": 19,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
...
]
}
Ô Chế độ xem phố
Bạn có thể xem thông tin về bản quyền và thông tin phân bổ trong phản hồi siêu dữ liệu của Chế độ xem đường phố. Ví dụ:
{
"panoId": "Zzl28rqGJgaL2IdkUleP8A",
"lat": 50.059138596550696,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"copyright": "From the Owner, Photo by: Google",
…
}
Mã hình ảnh toàn cảnh (dùng để nhận dạng duy nhất một hình ảnh toàn cảnh trên Chế độ xem đường phố) sẽ được miễn trừ khỏi quy định hạn chế về việc lưu vào bộ nhớ đệm. Do đó, bạn có thể lưu trữ giá trị mã nhận dạng ảnh toàn cảnh vô thời hạn. Giá trị mã nhận dạng toàn cảnh được trả về trong trường panoId
trong các phản hồi API Chế độ xem đường phố 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ác thẻ thông tin hiển thị; thường là dọc theo cuối quá trình kết xuất. Ví dụ: bạn có thể tìm thấy các thuộc tính dữ liệu trong một thẻ thông tin glTF bằng cách xem trong asset
, copyright
.
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
CesiumJS
Nếu đang sử dụng CesiumJS làm trình kết xuất, thì để hiển thị giá trị phân bổ, bạn cần bật showCreditsOnScreen
trong HTML kết xuất.
// 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 đang sử dụng Cesium for Unreal làm trình kết xuất, thì để hiển thị thông tin ghi công, bạn cần bật trường Show Credits On Screen (Hiển thị thông tin ghi công trên màn hình) trong World Outliner (Bố cục thế giới).
Cesium cho Unity
Nếu đang sử dụng Cesium for Unity làm trình kết xuất, thì để hiển thị thông tin ghi công, bạn cần bật trường Show Credits On Screen (Hiển thị thông tin ghi công trên màn hình) trong bảng điều khiển Inspector (Trình kiểm tra).
Nguyên tắc về kiểu cho mô hình phân bổ của Google
Sau đây là nguyên tắc về kiểu cho phần ghi công 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 phần khoá phải bằng hoặc lớn hơn chiều cao của chữ "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 với biến thể màu phù hợp cho một nề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, sử dụng độ phủ màu đen tối đa từ 0% đến 40%.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Trên nền tối hơn và trên nền ảnh 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à thuộc tính.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Phông chữ
Sử dụng phông chữ Roboto.
Ví dụ về CSS
Khi áp dụng cho văn bản "Google", CSS sau đây sẽ hiển thị "Google" với phông chữ, màu sắc và khoảng cách thích hợp 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;