Ví dụ

Phần này trình bày một loạt các yêu cầu mẫu đối với Places Insights API.

Để sử dụng computeInsights, hãy gửi yêu cầu POST qua HTTP theo biểu mẫu sau:

https://areainsights.googleapis.com/v1:computeInsights

Trả lại các địa điểm trong một vòng tròn

Trả lại tất cả nhà hàng trong bán kính 200m quanh Quảng trường Trafalgar, London.

  • Khu vực tìm kiếm là một vòng tròn được căn giữa dựa trên một vĩ độ và kinh độ cụ thể. Bán kính của vòng tròn này là 200 mét, xác định kích thước của khu vực tìm kiếm.
  • Loại địa điểm được yêu cầu là nhà hàng và loại địa điểm này được chuyển bằng included_types trong type_filters.
  • Số lượng được yêu cầu bằng INSIGHTS_COUNT và mã địa điểm được yêu cầu bằng INSIGHTS_PLACES.
{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "location_filter": {
      "circle": {
        "lat_lng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "type_filter": { "included_types": "restaurant" }
  }
}

Loại trừ các loại địa điểm

Bạn cũng có thể loại trừ các loại địa điểm khỏi số lượng.

Yêu cầu sau đây giống với ví dụ đầu tiên, nhưng thêm excluded_types đến type_filters. Bạn có thể sử dụng chuỗi hoặc mảng cho included_types và excluded_types.

Ví dụ này loại trừ hai loại địa điểm: cafe và bakery khỏi giá trị Số lượng restaurant.

{
    "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
    "filter": {
        "location_filter": {
            "circle": {
                "lat_lng": { "latitude": 51.508, "longitude": -0.128},
                "radius": 200
            }
        },
        "type_filter": {
            "included_types": "restaurant",
            "excluded_types": [
                "cafe",
                "bakery"
            ]
        }
    }
}

Sử dụng loại chính

Ví dụ này sửa đổi yêu cầu trong ví dụ đầu tiên để chỉ bao gồm các địa điểm có primaryType là restaurant.

{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "location_filter": {
      "circle": {
        "lat_lng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "type_filter": { "included_primary_types": "restaurant" }
  }
}

Đa giác tuỳ chỉnh

Ví dụ này minh hoạ cách sử dụng đa giác tuỳ chỉnh để xác định cụm từ tìm kiếm của bạn . Hãy nhớ rằng việc chỉ định INSIGHTS_PLACES sẽ giới hạn tìm kiếm trong diện tích đủ nhỏ để trả lại tối đa 100 mã địa điểm. Đối với khu vực lớn hơn, hãy sử dụng INSIGHTS_COUNT để bỏ qua giới hạn này để dịch vụ không cần phải trả về mã địa điểm riêng lẻ.

Như trước đây, loại địa điểm được sử dụng là restaurant. Ví dụ này cũng giới thiệu thêm ba bộ lọc khác:

  • operating_status: Ví dụ này chỉ tính các địa điểm hoạt động.
  • price_level: Ví dụ này chỉ tính giá rẻ và có giá vừa phải địa điểm.
  • rating_filter: Ví dụ này chỉ tính những địa điểm có điểm bài đánh giá từ 4 đến 5.
{
    "insights": [ "INSIGHT_COUNT" ],
    "filter": {
        "location_filter": {
            "custom_area": {
                "polygon": {
                    "coordinates": [
                        { "latitude": 37.776, "longitude": -122.666 },
                        { "latitude": 37.130, "longitude": -121.898 },
                        { "latitude": 37.326, "longitude": -121.598 },
                        { "latitude": 37.912, "longitude": -122.247 },
                        { "latitude": 37.776, "longitude": -122.666 }
                    ]
                }
            }
        },
        "type_filter": {
            "included_types": "restaurant"
        },
        "operating_status": [ "OPERATING_STATUS_OPERATIONAL" ],
        "price_levels": [ "PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE" ],
        "rating_filter": { "min_rating": 4.0, "max_rating": 5.0 }
    }
}

Khu vực địa lý

Ví dụ này sử dụng mã địa điểm Khu vực địa lý để đặt khu vực tìm kiếm. Các mã địa điểm này bao gồm hình học của một địa điểm, chẳng hạn như một thị trấn hoặc thành phố. Mã nhận dạng địa điểm dùng ở đây là ChIJiQHsW0m3j4ARm69rRkrUF3w, tương ứng với thành phố Mountain View, California.

Việc truyền mã địa điểm đến API Thông tin chi tiết về địa điểm sẽ đặt phạm vi tìm kiếm thành ranh giới của khu vực địa lý. Mã địa điểm được truyền bằng place, ở định dạng places/<place_ID>.

Bạn có thể lấy mã địa điểm Khu vực địa lý theo một trong những cách sau:

{
    "insights": [
        "INSIGHT_COUNT"
    ],
    "filter": {
        "location_filter": {
            "region": {
                "place": "places/ChIJiQHsW0m3j4ARm69rRkrUF3w"
            }
        },
        "type_filter": {
            "included_types": [
                "restaurant"
            ]
        }
    }
}