Package google.maps.areainsights.v1

Chỉ mục

AreaInsights

Định nghĩa dịch vụ cho RPC tổng hợp của địa điểm.

ComputeInsights

rpc ComputeInsights(ComputeInsightsRequest) returns (ComputeInsightsResponse)

Phương thức này cho phép bạn truy xuất thông tin chi tiết về các khu vực bằng nhiều bộ lọc như: khu vực, loại địa điểm, trạng thái hoạt động, mức giá và điểm xếp hạng. Hiện tại, chúng tôi hỗ trợ thông tin chi tiết về "số lượng" và "số địa điểm". Với thông tin chi tiết về "số lượng", bạn có thể trả lời các câu hỏi như "Có bao nhiêu nhà hàng đang hoạt động, giá rẻ và có điểm xếp hạng trung bình ít nhất là 4 sao ở California" (xem enum insight để biết thêm chi tiết). Với thông tin chi tiết về "địa điểm", bạn có thể xác định những địa điểm khớp với bộ lọc đã yêu cầu. Sau đó, ứng dụng có thể sử dụng tên tài nguyên địa điểm đó để tìm nạp thêm thông tin chi tiết về từng địa điểm riêng lẻ bằng API Địa điểm.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform

ComputeInsightsRequest

Yêu cầu RPC ComputeInsights.

Trường
insights[]

Insight

Bắt buộc. Thông tin chi tiết cần tính toán. Hiện tại, chúng tôi chỉ hỗ trợ INSIGHT_COUNT và INSIGHT_PLACES.
filter

Filter

Bắt buộc. Bộ lọc thông tin chi tiết.

ComputeInsightsResponse

Phản hồi cho RPC ComputeInsights.

Trường
place_insights[]

PlaceInsight

Kết quả cho Insights.INSIGHT_PLACES.
count

int64

Kết quả cho Insights.INSIGHT_COUNT.

Lọc

Bộ lọc cho RPC ComputeInsights.

Trường
location_filter

LocationFilter

Bắt buộc. Giới hạn kết quả ở những địa điểm nằm trong khu vực do bộ lọc vị trí chỉ định.
type_filter

TypeFilter

Bắt buộc. Bộ lọc loại địa điểm.
operating_status[]

OperatingStatus

Không bắt buộc. Chỉ hiển thị những địa điểm có trạng thái hoạt động có trong danh sách này. Nếu bạn không đặt operating_status, thì OPERATING_STATUS_OPERATIONAL sẽ được dùng làm giá trị mặc định.
price_levels[]

PriceLevel

Không bắt buộc. Chỉ hiển thị những địa điểm có mức giá nằm trong danh sách này. Nếu bạn không đặt price_levels, tất cả các cấp giá sẽ được đưa vào kết quả.
rating_filter

RatingFilter

Không bắt buộc. Giới hạn kết quả ở những địa điểm có điểm xếp hạng trung bình của người dùng nằm trong phạm vi do rating_filter chỉ định. Nếu bạn không đặt rating_filter, thì tất cả điểm xếp hạng đều được đưa vào kết quả.

Thông tin chi tiết

Thông tin chi tiết được hỗ trợ.

Enum
INSIGHT_UNSPECIFIED Chưa chỉ định.
INSIGHT_COUNT

Thông tin chi tiết về số lượt đếm.

Khi bạn chỉ định thông tin chi tiết này, ComputeInsights sẽ trả về số lượng địa điểm khớp với tiêu chí bộ lọc đã chỉ định.

Yêu cầu mẫu:

{
  "insights": ["INSIGHT_COUNT"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

Ví dụ về phản hồi:

{
  "count": 1234
}
INSIGHT_PLACES

Trả lại địa điểm

Khi bạn chỉ định thông tin chi tiết này, ComputeInsights sẽ trả về mã nhận dạng địa điểm khớp với tiêu chí bộ lọc đã chỉ định.

Yêu cầu mẫu:

{
  "insights": ["INSIGHT_PLACES"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

Ví dụ về phản hồi:

{
  "placeInsights": [
    {"place": "places/ABC"},
    {"place": "places/PQR"},
    {"place": "places/XYZ"}
  ]
}

LocationFilter

Bộ lọc vị trí.

Chỉ định khu vực quan tâm cho thông tin chi tiết.

Trường
Trường hợp hợp nhất area. Bạn phải chỉ định một trong những giá trị sau. area chỉ có thể là một trong những loại sau:
circle

Circle

Diện tích dưới dạng hình tròn.
region

Region

Diện tích dưới dạng khu vực.
custom_area

CustomArea

Khu vực tuỳ chỉnh được chỉ định bằng một đa giác.

Hình tròn

Đường tròn được xác định bằng tâm điểm và bán kính tính bằng mét.

Trường
radius

int32

Không bắt buộc. Bán kính của hình tròn tính bằng mét
Trường hợp hợp nhất center. Tâm của hình tròn. center chỉ có thể là một trong những loại sau:
lat_lng

LatLng

Vĩ độ và kinh độ của tâm hình tròn.
place

string

Định dạng: Phải ở định dạng places/PLACE_ID, trong đó PLACE_ID là giá trị nhận dạng duy nhất của một địa điểm. Ví dụ: places/ChIJgUbEo8cfqokR5lP9_Wh_DaM.

CustomArea

Khu vực tuỳ chỉnh.

Trường
polygon

Polygon

Bắt buộc. Khu vực tuỳ chỉnh được biểu thị dưới dạng đa giác

Đa giác

Đa giác được biểu thị bằng một loạt toạ độ được kết nối theo thứ tự ngược chiều kim đồng hồ. Các toạ độ tạo thành một vòng lặp kín và xác định một vùng được tô màu. Toạ độ đầu tiên và cuối cùng tương đương nhau và phải chứa các giá trị giống hệt nhau. Định dạng này là phiên bản đơn giản của đa giác GeoJSON (chúng tôi chỉ hỗ trợ một vòng ngoài ngược chiều kim đồng hồ).

Trường
coordinates[]

LatLng

Không bắt buộc. Toạ độ xác định đa giác.

Khu vực

Khu vực là một ranh giới địa lý, chẳng hạn như: thành phố, mã bưu chính, quận, tiểu bang, v.v.

Trường
Trường hợp hợp nhất region. Xác định một khu vực địa lý. Mỗi lần, bạn chỉ có thể chỉ định một loại khu vực (ví dụ: địa điểm). region chỉ có thể là một trong những loại sau:
place

string

Giá trị nhận dạng duy nhất của một khu vực địa lý cụ thể.

OperatingStatus

Trạng thái hoạt động của địa điểm.

Enum
OPERATING_STATUS_UNSPECIFIED Chưa chỉ định. Không nên sử dụng giá trị này.
OPERATING_STATUS_OPERATIONAL Địa điểm này đang hoạt động và mở cửa trong khung giờ đã định.
OPERATING_STATUS_PERMANENTLY_CLOSED Địa điểm này không còn hoạt động nữa.
OPERATING_STATUS_TEMPORARILY_CLOSED Địa điểm này đang tạm thời đóng cửa và dự kiến sẽ mở cửa trở lại trong tương lai.

PlaceInsight

Chứa thông tin về một địa điểm

Trường
place

string

Giá trị nhận dạng duy nhất của địa điểm. Bạn có thể dùng tên tài nguyên này để truy xuất thông tin chi tiết về địa điểm bằng API Địa điểm.

PriceLevel

Mức giá của địa điểm.

Enum
PRICE_LEVEL_UNSPECIFIED Chưa chỉ định. Không nên sử dụng giá trị này.
PRICE_LEVEL_FREE Địa điểm cung cấp dịch vụ miễn phí.
PRICE_LEVEL_INEXPENSIVE Địa điểm cung cấp các dịch vụ giá rẻ.
PRICE_LEVEL_MODERATE Địa điểm cung cấp các dịch vụ có mức giá vừa phải.
PRICE_LEVEL_EXPENSIVE Địa điểm này cung cấp các dịch vụ đắt đỏ.
PRICE_LEVEL_VERY_EXPENSIVE Địa điểm này cung cấp các dịch vụ rất đắt đỏ.

RatingFilter

Bộ lọc điểm xếp hạng trung bình của người dùng.

Trường
min_rating

float

Không bắt buộc. Hạn chế kết quả ở những địa điểm có điểm xếp hạng trung bình của người dùng lớn hơn hoặc bằng min_rating. Giá trị phải nằm trong khoảng từ 1,0 đến 5,0.
max_rating

float

Không bắt buộc. Hạn chế kết quả ở những địa điểm có điểm xếp hạng trung bình của người dùng thấp hơn hoặc bằng max_rating. Giá trị phải nằm trong khoảng từ 1,0 đến 5,0.

TypeFilter

Bộ lọc loại địa điểm.

Chỉ hỗ trợ các loại Địa điểm trong Bảng a.

Một địa điểm chỉ có thể có một loại chính được liên kết. Ví dụ: loại chính có thể là "mexican_restaurant" hoặc "steak_house". Sử dụng included_primary_types và excluded_primary_types để lọc kết quả theo loại chính của địa điểm.

Một địa điểm cũng có thể có nhiều giá trị loại được liên kết với địa điểm đó. Ví dụ: một nhà hàng có thể có các loại sau: "seafood_restaurant", "restaurant", "food", "point_of_interest", "establishment". Sử dụng included_types và excluded_types để lọc kết quả trong danh sách các loại được liên kết với một địa điểm.

Nếu một cụm từ tìm kiếm được chỉ định với nhiều quy định hạn chế về loại, thì hệ thống sẽ chỉ trả về những địa điểm đáp ứng tất cả các quy định hạn chế đó. Ví dụ: nếu bạn chỉ định {"included_types": ["restaurant"], "excluded_primary_types": ["steak_house"]}, thì những địa điểm được trả về sẽ cung cấp các dịch vụ liên quan đến "nhà hàng" nhưng không hoạt động chủ yếu dưới dạng "steak_house".

Nếu có bất kỳ loại nào xung đột, tức là một loại xuất hiện trong cả loại included_types và excluded_types hoặc included_primary_types và excluded_primary_types, thì lỗi INVALID_ARGUMENT sẽ được trả về.

Bạn phải đặt một trong các thuộc tính included_types hoặc included_primary_types.

Trường
included_types[]

string

Không bắt buộc. Các loại Địa điểm được đưa vào.
excluded_types[]

string

Không bắt buộc. Các loại Địa điểm bị loại trừ.
included_primary_types[]

string

Không bắt buộc. Bao gồm các loại Địa điểm chính.
excluded_primary_types[]

string

Không bắt buộc. Các loại Địa điểm chính bị loại trừ.