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ụng và Quyề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ụng và Chí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ụ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 đ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ụng và Chí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ụng và Chí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-revalidate và
private 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.
Đang hiển thị biểu trưng của Google
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.
| Để dùng trên nền sáng | Để 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 đổ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.
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.
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.
Truy xuất thông tin ghi công và bản quyền
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
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.
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.
#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.
#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;