Giới thiệu về dữ liệu và truy vấn của Thông tin chi tiết về địa điểm

Dữ liệu Thông tin chi tiết về địa điểm

Thông tin chi tiết về địa điểm cung cấp tập dữ liệu đầy đủ và tập dữ liệu mẫu trong BigQuery.

Tập dữ liệu mẫu giúp bạn dùng thử Thông tin chi tiết về địa điểm để có thể đánh giá khả năng hữu dụng và giá trị của sản phẩm trước khi quyết định mua toàn bộ tập dữ liệu. Tập dữ liệu mẫu chỉ chứa dữ liệu cho chính thành phố đó. Báo cáo này không chứa dữ liệu về khu vực đô thị xung quanh.

Trang thông tin mẫu bao gồm dữ liệu về một thành phố hàng đầu cho mỗi quốc gia được hỗ trợ:

Amsterdam (NL) Helsinki (FI) Plovdiv (BG)
Ankara (TR) Hồng Kông (HK) Riffa (BH)
Arequipa (PE) Jakarta (ID) Rome (IT)
Athens (GR) Jeddah (SA) Santiago (CL)
Bad Gastein (AT) Johannesburg (ZA) Sao Paulo (Brazil)
Berlin (DE) Kuala Lumpur (MY) Sharjah (AE)
Brno (CZ) Lisbon (PT) Singapore (SG)
Brussels (BE) Luân Đôn (Vương quốc Anh) Stockholm (SE)
Bucharest (RO) Lusail (QA) Sydney (Úc)
Buenos Aires (AR) Madrid (ES) Đài Bắc (TW)
Busan (KR) Manila (PH) Tel Aviv-Yafo (IL)
Cairo (EG) Medellín (CO) Tokyo (JP)
Chiang Mai (TH) Thành phố Mexico (MX) Toronto (CA)
Copenhagen (DK) Mumbai (Ấn Độ) Warsaw (PL)
Cork (IE) Thành phố New York (Hoa Kỳ) Wellington (New Zealand)
Debrecen (HU) Oslo (NO) Zurich (CH)
Hà Nội (VN) Paris (FR)

Tập dữ liệu đầy đủ bao gồm dữ liệu cho từng quốc gia được hỗ trợ và bạn phải mua tập dữ liệu này. Nếu bạn muốn đăng ký sử dụng Thông tin chi tiết về địa điểm, hãy điền vào biểu mẫu yêu cầu. Chỉ người đăng ký dữ liệu mới cần yêu cầu quyền truy cập vào tập dữ liệu Thông tin chi tiết về địa điểm. Sau khi gói thuê bao hoạt động trong một dự án BigQuery, mọi người dùng có quyền truy cập vào dự án đó đều có thể truy vấn dữ liệu Thông tin chi tiết về địa điểm.

Mỗi tập dữ liệu theo quốc gia có trang thông tin riêng mà bạn phải đăng ký riêng. Để biết thêm thông tin về cách đăng ký một trang thông tin, hãy xem bài viết Thiết lập Thông tin chi tiết về địa điểm.

Giản đồ tập dữ liệu

Giản đồ tập dữ liệu địa điểm cho mỗi quốc gia bao gồm hai phần:

Ví dụ: nếu bạn đang làm việc với tập dữ liệu cho Tây Ban Nha (ES), hãy tham khảo cả giản đồ cốt lõi và giản đồ dành riêng cho ES.

Giản đồ cho tập dữ liệu thương hiệu xác định 3 trường:

  • id: Mã thương hiệu.
  • name: Tên thương hiệu, chẳng hạn như "Hertz" hoặc "Chase".
  • category: Danh mục cấp cao của thương hiệu, chẳng hạn như "Trạm xăng", "Đồ ăn và đồ uống" hoặc "Nhà nghỉ".

Truy vấn dữ liệu Thông tin chi tiết về địa điểm

Thông tin chi tiết về địa điểm cung cấp hai cách để truy vấn các tập dữ liệu:

  • Truy vấn trực tiếp tập dữ liệu bằng SQL: Thực thi các truy vấn SQL BigQuery chuẩn đối với các bảng tập dữ liệu. Điều này mang lại sự linh hoạt tối đa cho việc lọc phức tạp, kết hợp với dữ liệu của riêng bạn, phân tích tuỳ chỉnh và hỗ trợ các hàm tổng hợp bổ sung ngoài COUNT, chẳng hạn như AVG, SUM và GROUP BY. Xem tài liệu.
  • Truy vấn tập dữ liệu bằng các hàm Số lượng địa điểm: Hàm Số lượng địa điểm là các truy vấn SQL được tối ưu hoá và xác định trước, chạy trực tiếp trong BigQuery và đơn giản hoá các tác vụ truy xuất dữ liệu phổ biến. Các API này cung cấp thông tin chi tiết hơn, chẳng hạn như trả về Mã địa điểm để tra cứu thông tin chi tiết về từng địa điểm. Xem tài liệu.

Truy vấn trực tiếp

Việc truy vấn dữ liệu trực tiếp sẽ áp dụng ngưỡng tổng hợp. Kết quả chỉ được trả về nếu truy vấn tổng hợp ít nhất 5 Địa điểm. Ví dụ: nếu kết quả của tiêu chí tìm kiếm là 0, 1, 2, 3 hoặc 4, thì kết quả đó sẽ bị bỏ qua trong phản hồi. Ví dụ: một truy vấn về tổng số nhà hàng trong một khu vực nhất định sẽ chỉ trả về kết quả nếu tổng số nhà hàng là 5 trở lên, nếu không thì sẽ không trả về kết quả.

Truy vấn hàm Places Count

Các hàm Số lượng địa điểm có thể trả về danh sách Mã địa điểm. Bạn có thể dùng danh sách này để tra cứu thông tin về từng địa điểm bằng các sản phẩm khác của GMP như Places API và Places UI Kit.

Các hàm Đếm địa điểm không thực thi ngưỡng tổng hợp mà thực thi diện tích tìm kiếm tối thiểu là 40 m x 40 m (1.600 m2). Điều này có nghĩa là miễn là cụm từ tìm kiếm của bạn lớn hơn khu vực tìm kiếm tối thiểu, bạn sẽ luôn nhận được kết quả, kể cả khi không có địa điểm nào khớp với cụm từ tìm kiếm của bạn.

Trường hợp nên truy vấn dữ liệu trực tiếp và trường hợp nên sử dụng hàm

Hãy truy vấn dữ liệu trực tiếp nếu bạn không cần số lượng kết quả thấp, nếu bạn muốn nhận thông tin chi tiết ngoài số lượng, chẳng hạn như AVG, SUM hoặc COUNTIF, hoặc nếu bạn cần thực hiện các truy vấn phức tạp hơn, chẳng hạn như kết hợp các tập dữ liệu.

Hãy truy vấn bằng các hàm nếu bạn cần biết liệu có ít hoặc không có kết quả hay không, hoặc nếu bạn cần truy xuất thông tin về từng địa điểm, chẳng hạn như tên hoặc địa chỉ địa điểm.

Bảng này cung cấp thông tin so sánh chi tiết về sự khác biệt giữa truy vấn trực tiếp và hàm Số lượng địa điểm.

Hàm đếm địa điểm Truy vấn trực tiếp tập dữ liệu
Lợi ích
  • Trả về Mã địa điểm có thể dùng để truy vấn các API khác.
  • Có thể trả về số lượng bất kỳ.
  • Tối ưu hoá để đạt hiệu suất cao và chi phí xử lý thấp.
  • Dễ sử dụng. Không cần viết các truy vấn phức tạp.
  • Xác thực các tham số đầu vào và trả về lỗi, giúp bạn dễ dàng sử dụng và gỡ lỗi hơn.
  • Cho phép thực hiện các truy vấn phức tạp như bộ lọc nâng cao và kết hợp.
  • Không thực thi khu vực tìm kiếm tối thiểu.
  • Hỗ trợ các hàm tổng hợp khác ngoài COUNT, chẳng hạn như AVG, SUM và GROUP BY.
Giao diện Bốn hàm SQL được xác định trước để tạo thông tin chi tiết về COUNT: số lượng đơn lẻ, số lượng theo loại, số lượng theo vị trí địa lý, số lượng theo ô H3. JSON_OBJECT truyền đối số đến hàm. Viết SQL của riêng bạn để chạy các hàm tổng hợp như COUNT, COUNT_IF, SUM và AVG.. Bạn có thể tạo thêm thông tin chi tiết bằng cách sử dụng JOIN, GROUP BY, WHERE và các hàm khác.
Các hạn chế Áp dụng diện tích tìm kiếm tối thiểu là 40 m x 40 m (1.600 m2). Hàm sẽ trả về kết quả ngay cả khi số lượng tổng hợp nhỏ hơn 5, miễn là đáp ứng được khu vực tìm kiếm tối thiểu. Kết quả có số lượt ít hơn 5 sẽ bị bỏ qua trong kết quả (tức là hàng bị loại trừ).
Bộ lọc thuộc tính được hỗ trợ Tham số bộ lọc hàm Số lượng địa điểm hỗ trợ các bộ lọc thuộc tính truy vấn trực tiếp giống nhau, ngoại trừ:
  • Địa điểm id
  • Thành phần địa chỉ
Hỗ trợ giản đồ đầy đủ.