ตัวอย่าง

ส่วนนี้จะแสดงตัวอย่างคําขอไปยัง Places Insights API

หากต้องการใช้ computeInsights ให้ส่งคำขอ HTTP POST ในรูปแบบต่อไปนี้

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

แสดงผลสถานที่ภายในแวดวง

ส่งคืนร้านอาหารทั้งหมดภายในรัศมี 200 ม. จากจัตุรัสทราฟัลการ์ ลอนดอน

  • พื้นที่ที่ค้นหาคือวงกลมที่มีศูนย์กลางอยู่ที่ละติจูดและลองจิจูดที่เฉพาะเจาะจง รัศมีของวงกลมนี้คือ 200 เมตร ซึ่งเป็นตัวกำหนดขนาดของวงกลม พื้นที่ค้นหา
  • ประเภทสถานที่ที่ขอคือร้านอาหาร และส่งผ่านโดยใช้ included_types ภายใน type_filters
  • ระบบส่งคำขอจำนวนโดยใช้ INSIGHTS_COUNT และรหัสสถานที่ ขอโดยใช้ 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" }
  }
}

ยกเว้นประเภทสถานที่

นอกจากนี้ยังยกเว้นประเภทสถานที่ออกจากจำนวนดังกล่าวได้ด้วย

คําขอต่อไปนี้เหมือนกับตัวอย่างแรก แต่เพิ่ม excluded_types ลงใน type_filters คุณจะใช้สตริงหรืออาร์เรย์ก็ได้ ของสตริงสำหรับ included_types และ excluded_types

ตัวอย่างนี้ยกเว้นสถานที่ 2 ประเภท ได้แก่ cafe และ bakery จาก จำนวน 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"
            ]
        }
    }
}

ใช้ประเภทหลัก

ตัวอย่างนี้แก้ไขคำขอจากตัวอย่างแรกให้รวมเฉพาะตำแหน่ง ที่มี primaryType เป็น 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" }
  }
}

รูปหลายเหลี่ยมที่กำหนดเอง

ตัวอย่างนี้แสดงวิธีใช้รูปหลายเหลี่ยมที่กำหนดเองเพื่อกำหนดการค้นหาของคุณ ของคุณ โปรดทราบว่าการระบุ INSIGHTS_PLACES จะจำกัดการค้นหาไว้เฉพาะ พื้นที่ที่มีขนาดเล็กพอที่จะแสดงผลรหัสตำแหน่งได้สูงสุด 100 รหัส สำหรับพื้นที่ขนาดใหญ่ขึ้น INSIGHTS_COUNT เพื่อข้ามข้อจำกัดนี้เพื่อให้บริการไม่ต้อง แสดงผลรหัสสถานที่แต่ละแห่ง

ประเภทสถานที่ที่ใช้คือ restaurant เช่นเดียวกับก่อนหน้านี้ ตัวอย่างนี้ยังแสดงตัวกรองอีก 3 รายการ ได้แก่

  • operating_status: ตัวอย่างนี้นับเฉพาะสถานที่ที่มีการดำเนินงานเท่านั้น
  • price_level: ตัวอย่างนี้นับเฉพาะที่พักราคาไม่แพงและราคาปานกลาง
  • rating_filter: ตัวอย่างนี้จะนับเฉพาะสถานที่ที่มีคะแนนรีวิวระหว่าง 4.0 และ 5.0
{
    "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 }
    }
}

พื้นที่ทางภูมิศาสตร์

ตัวอย่างนี้ใช้รหัสสถานที่พื้นที่ทางภูมิศาสตร์เพื่อกำหนดพื้นที่การค้นหา รหัสสถานที่เหล่านี้ประกอบด้วยเรขาคณิตของสถานที่ เช่น เมือง รหัสสถานที่ที่ใช้ที่นี่คือ ChIJiQHsW0m3j4ARm69rRkrUF3w ซึ่งตรงกับ เมืองเมาน์เทนวิว รัฐแคลิฟอร์เนีย

การส่งต่อรหัสสถานที่ไปยัง Places Insights API จะกำหนดพื้นที่การค้นหาให้อยู่ในขอบเขต ในพื้นที่ทางภูมิศาสตร์ดังกล่าว ระบบจะส่งรหัสสถานที่โดยใช้ place ในรูปแบบ places/<place_ID>

คุณสามารถรับรหัสสถานที่ตามพื้นที่ทางภูมิศาสตร์ได้หลายวิธีดังนี้

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