Trước khi bắt đầu

Tài liệu này mô tả các điều kiện tiên quyết, phương pháp hay nhất và lỗi thường gặp khi làm việc với tập dữ liệu.

Điều kiện tiên quyết

Khi tạo tập dữ liệu:

  • Tên hiển thị phải là duy nhất trong dự án trên đám mây của bạn trên Google Cloud.
  • Tên hiển thị không được dài quá 64 byte (Vì các ký tự này được biểu thị bằng UTF-8, trong một số ngôn ngữ, mỗi ký tự có thể được biểu thị bằng nhiều byte).
  • Nội dung mô tả không được dài quá 1000 byte.

Khi tải dữ liệu lên:

  • Các loại tệp được hỗ trợ là CSV, GeoJSON và KML.
  • Kích thước tệp tối đa được hỗ trợ là 500 MB.
  • Tên cột thuộc tính không được bắt đầu bằng chuỗi "?_".
  • Không hỗ trợ hình học ba chiều. Điều này bao gồm cả hậu tố "Z" ở định dạng WKT, và toạ độ độ cao ở định dạng GeoJSON.

Các phương pháp hay nhất để chuẩn bị dữ liệu

Nếu dữ liệu nguồn của bạn phức tạp hoặc lớn, chẳng hạn như các điểm dày đặc, chuỗi đường thẳng hoặc đa giác dài (thường là các tệp nguồn có kích thước lớn hơn 50 MB thuộc danh mục này), hãy cân nhắc đơn giản hoá dữ liệu trước khi tải lên để đạt được hiệu suất tốt nhất trong bản đồ trực quan.

Dưới đây là một số phương pháp hay nhất để chuẩn bị dữ liệu:

  1. Giảm thiểu các thuộc tính của đối tượng. Chỉ giữ lại các thuộc tính của đối tượng cần thiết để định kiểu bản đồ của bạn, ví dụ: "id" và "category". Bạn có thể kết hợp các thuộc tính bổ sung với một đối tượng trong ứng dụng khách bằng cách sử dụng các kiểu dựa trên dữ liệu trên khoá nhận dạng duy nhất. Ví dụ: hãy xem Xem dữ liệu theo thời gian thực bằng tính năng định kiểu dựa trên dữ liệu.
  2. Sử dụng các kiểu dữ liệu đơn giản cho các đối tượng thuộc tính nếu có thể, chẳng hạn như số nguyên, để giảm thiểu kích thước ô và cải thiện hiệu suất của bản đồ.
  3. Đơn giản hoá các hình học phức tạp trước khi tải tệp lên. Bạn có thể thực hiện việc này trong một công cụ không gian địa lý mà bạn chọn, chẳng hạn như tiện ích Mapshaper.org nguồn mở Mapshaper.org hoặc trong BigQuery bằng cách sử dụng ST_Simplify trên các hình học đa giác phức tạp.
  4. Nhóm các điểm rất dày đặc trước khi tải tệp lên. Bạn có thể thực hiện việc này trong một công cụ không gian địa lý mà bạn chọn, chẳng hạn như các hàm nhóm turf.js nguồn mở turf.js cluster functions hoặc trong BigQuery bằng cách sử dụng ST_CLUSTERDBSCAN trên các hình học điểm dày đặc.

Xem hướng dẫn bổ sung về các phương pháp hay nhất cho tập dữ liệu trong phần Trực quan hoá dữ liệu bằng Tập dữ liệu và BigQuery.

Yêu cầu về GeoJSON

API Tập dữ liệu trên Maps hỗ trợ thông số kỹ thuật GeoJSON hiện tại. API Tập dữ liệu trên Maps cũng hỗ trợ các tệp GeoJSON chứa bất kỳ loại đối tượng nào sau đây:

  • Đối tượng hình học. Đối tượng hình học là một hình dạng không gian, được mô tả là sự kết hợp của các điểm, đường thẳng và đa giác có các lỗ tuỳ chọn.
  • Đối tượng đối tượng. Đối tượng đối tượng chứa một hình học cộng với các cặp tên/giá trị bổ sung có ý nghĩa dành riêng cho ứng dụng.
  • Bộ sưu tập đối tượng. Bộ sưu tập đối tượng là một tập hợp các đối tượng đối tượng.

API Tập dữ liệu trên Maps không hỗ trợ các tệp GeoJSON có dữ liệu trong hệ thống tham chiếu toạ độ (CRS) khác với WGS84.

Để biết thêm thông tin về GeoJSON, hãy xem phần Tuân thủ RFC 7946.

Yêu cầu về KML

API Tập dữ liệu trên Maps có các yêu cầu sau:

  • Tất cả URL phải là cục bộ (hoặc tương đối) đối với chính tệp đó.
  • Hỗ trợ hình học điểm, đường thẳng và đa giác.
  • Tất cả thuộc tính dữ liệu đều được coi là chuỗi.
Các tính năng sau của KML không được hỗ trợ:
  • Biểu tượng hoặc <styleUrl> được xác định bên ngoài tệp.
  • Đường liên kết mạng, chẳng hạn như <NetworkLink>
  • Lớp phủ mặt đất, chẳng hạn như <GroundOverlay>
  • Hình học 3D hoặc bất kỳ thẻ nào liên quan đến độ cao, chẳng hạn như <altitudeMode>
  • Thông số kỹ thuật của camera, chẳng hạn như <LookAt>
  • Các kiểu được xác định bên trong tệp KML.

Yêu cầu về CSV

Đối với tệp CSV, các tên cột được hỗ trợ được liệt kê bên dưới theo thứ tự ưu tiên:

  • latitude, longitude
  • lat, long
  • x, y
  • wkt (Văn bản nổi tiếng)
  • address, city, state, zip
  • address
  • Một cột chứa tất cả thông tin về địa chỉ, chẳng hạn như 1600 Amphitheatre Parkway Mountain View, CA 94043

Ví dụ: tệp của bạn chứa các cột có tên x, y và wkt. Vì x và y có mức độ ưu tiên cao hơn (theo thứ tự tên cột được hỗ trợ trong danh sách ở trên), nên các giá trị trong cột x và y sẽ được sử dụng và cột wkt sẽ bị bỏ qua.

Ngoài ra:

  • Mỗi tên cột phải thuộc về một cột duy nhất. Tức là bạn không thể có một cột có tên xy chứa cả dữ liệu toạ độ x và y. Toạ độ x và y phải nằm trong các cột riêng biệt.
  • Tên cột không phân biệt chữ hoa chữ thường.
  • Thứ tự của tên cột không quan trọng. Ví dụ: nếu tệp CSV của bạn chứa lat và long cột, thì các cột này có thể xuất hiện theo bất kỳ thứ tự nào.

Xử lý lỗi tải dữ liệu lên

Khi tải dữ liệu lên một tập dữ liệu, bạn có thể gặp một trong các lỗi thường gặp được mô tả trong phần này.

Lỗi GeoJSON

Các lỗi GeoJSON thường gặp bao gồm:

  • Thiếu trường type hoặc type không phải là chuỗi. Tệp dữ liệu GeoJSON được tải lên phải chứa một trường chuỗi có tên là type như một phần của mỗi định nghĩa Đối tượng đối tượng và Đối tượng hình học.

Lỗi KML

Các lỗi KML thường gặp bao gồm:

  • Tệp dữ liệu không được chứa bất kỳ tính năng KML không được hỗ trợ nào được liệt kê ở trên, nếu không, quá trình nhập dữ liệu có thể không thành công.

Lỗi CSV

Các lỗi CSV thường gặp bao gồm:

  • Một số hàng bị thiếu giá trị cho cột hình học. Tất cả các hàng trong tệp CSV phải chứa các giá trị không trống cho các cột hình học. Các cột hình học bao gồm:
    • latitude, longitude
    • lat, long
    • x, y
    • wkt
    • address, city, state, zip
    • address
    • Một cột chứa tất cả thông tin về địa chỉ, chẳng hạn như 1600 Amphitheatre Parkway Mountain View, CA 94043
  • Nếu x và y là các cột hình học, hãy đảm bảo rằng các đơn vị là kinh độ và vĩ độ. Một số tập dữ liệu công khai sử dụng các hệ toạ độ khác nhau trong các tiêu đề x và y. Nếu sử dụng sai đơn vị, tập dữ liệu có thể nhập thành công, nhưng dữ liệu được kết xuất có thể hiển thị các điểm của tập dữ liệu ở những vị trí không mong muốn.