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 nhằm mục đích giúp bạn dùng thử Thông tin chi tiết về địa điểm để có thể đánh giá khả năng sử dụng và giá trị của sản phẩm trước khi quyết định mua tập dữ liệu đầy đủ. Tập dữ liệu mẫu chỉ chứa dữ liệu của chính thành phố đó. Tập dữ liệu này không chứa dữ liệu của khu vực đô thị xung quanh.

Trang thông tin mẫu bao gồm dữ liệu của một thành phố hàng đầu cho từng 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 (BR)
Berlin (DE) Kuala Lumpur (MY) Sharjah (AE)
Brno (CZ) Lisbon (PT) Singapore (SG)
Brussels (BE) London (GB) Stockholm (SE)
Bucharest (RO) Lusail (QA) Sydney (AU)
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) Mexico City (MX) Toronto (CA)
Copenhagen (DK) Mumbai (IN) Warsaw (PL)
Cork (IE) New York City (US) Wellington (NZ)
Debrecen (HU) Oslo (NO) Zurich (CH)
Hà Nội (VN) Paris (FR)

Bạn phải mua tập dữ liệu đầy đủ bao gồm dữ liệu của từng quốc gia được hỗ trợ. 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 đăng ký hoạt động trong một dự án BigQuery, bất kỳ người dùng nào 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 quốc gia đều có một 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 về địa điểm cho mỗi quốc gia bao gồm 2 phần:

Ví dụ: nếu bạn đang làm việc với tập dữ liệu của 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 về thương hiệu xác định 3 trường:

  • id: Mã thương hiệu.
  • name: Tên của 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à thức uống" hoặc "Chỗ ở".

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 2 cách để truy vấn 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 tiêu chuẩn đối với các bảng tập dữ liệu. Cách này mang lại sự linh hoạt cao nhất 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, SUMGROUP BY. Xem tài liệu.
  • Truy vấn tập dữ liệu bằng các hàm Đếm địa điểm: Các hàm Đếm địa điểm là các truy vấn SQL được xác định trước và tối ưu hoá, chạy trực tiếp trong BigQuery và đơn giản hoá các tác vụ truy xuất dữ liệu thông thường. Các hàm này cung cấp thông tin chi tiết 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 trực tiếp dữ liệu sẽ thực thi một 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 tiêu chí tìm kiếm của bạn cho kết quả là số lượng 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ề phản hồi nếu tổng số là 5 trở lên, nếu không thì sẽ không có phản hồi nào được trả về.

Truy vấn hàm Đếm địa điểm

Các hàm Đếm địa điểm có thể trả về danh sách Mã địa điểm. Bạn có thể sử 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 (Nền tảng Google Maps), chẳng hạn như Places APIPlaces UI Kit.

Các hàm Đếm địa điểm không thực thi ngưỡng tổng hợp mà thay vào đó thực thi một khu vực tìm kiếm tối thiểu là 40,0 mét x 40,0 mét (1600 m2). Điều này có nghĩa là miễn là truy vấn 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 có 0 địa điểm khớp với truy vấn của bạn.

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

Hãy truy vấn trực tiếp dữ liệu 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 tập dữ liệu.

Hãy truy vấn bằng các hàm nếu bạn cần biết có số lượng kết quả thấp hay không có kết quả nào, 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ỉ của đị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 Đếm đị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ề bất kỳ số lượng nào.
  • Được tối ưu hoá để mang lại hiệu suất 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, chẳng hạn như 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 bổ sung ngoài COUNT, chẳng hạn như AVG, SUMGROUP BY.
Giao diện 4 hàm SQL được xác định trước tạo ra thông tin chi tiết 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 các đối số vào hàm. Viết SQL của riêng bạn để chạy các hàm tổng hợp, chẳng hạn như COUNT, COUNT_IF, SUM, và AVG.. Bạn có thể tạo thông tin chi tiết bổ sung bằng cách sử dụng JOIN, GROUP BY, WHERE, và các hàm khác.
Các hạn chế Thực thi khu vực tìm kiếm tối thiểu là 40,0 mét x 40,0 mét (1600 m2). Một 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ượng nhỏ 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ợ Các tham số bộ lọc hàm Đếm địa điểm hỗ trợ giống như các bộ lọc thuộc tính truy vấn trực tiếp, ngoại trừ:
  • id địa điểm
  • Các thành phần địa chỉ
  • Giờ mở cửa
  • Các lựa chọn sạc xe điện
  • Thương hiệu
Hỗ trợ giản đồ đầy đủ.