Package google.maps.areainsights.v1

ดัชนี

AreaInsights

คําจํากัดความของบริการสําหรับ RPC แบบรวมของ Places

ComputeInsights

rpc ComputeInsights(ComputeInsightsRequest) returns (ComputeInsightsResponse)

วิธีนี้ช่วยให้คุณเรียกข้อมูลเชิงลึกเกี่ยวกับพื้นที่โดยใช้ตัวกรองที่หลากหลาย เช่น พื้นที่ ประเภทสถานที่ สถานะการทํางาน ระดับราคา และคะแนน ปัจจุบันระบบรองรับข้อมูลเชิงลึก "จํานวน" และ "สถานที่" ข้อมูลเชิงลึก "จำนวน" ช่วยให้คุณตอบคําถามต่างๆ ได้ เช่น "มีร้านอาหารกี่แห่งในแคลิฟอร์เนียที่เปิดทําการอยู่ มีราคาไม่แพง และมีคะแนนเฉลี่ยอย่างน้อย 4 ดาว" (ดูรายละเอียดเพิ่มเติมใน insight enum) ข้อมูลเชิงลึก "สถานที่" ช่วยให้คุณระบุสถานที่ที่ตรงกับตัวกรองที่ขอได้ จากนั้นไคลเอ็นต์จะใช้ชื่อทรัพยากรสถานที่เหล่านั้นเพื่อดึงข้อมูลรายละเอียดเพิ่มเติมเกี่ยวกับสถานที่แต่ละแห่งได้โดยใช้ Places API

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

ComputeInsightsRequest

คำขอสำหรับ RPC ของ ComputeInsights

ช่อง
insights[]

Insight

ต้องระบุ ข้อมูลเชิงลึกที่จะคํานวณ ปัจจุบันรองรับเฉพาะ INSIGHT_COUNT และ INSIGHT_PLACES
filter

Filter

ต้องระบุ ตัวกรองข้อมูลเชิงลึก

ComputeInsightsResponse

การตอบกลับสําหรับ RPC ของ ComputeInsights

ช่อง
place_insights[]

PlaceInsight

ผลลัพธ์สําหรับ Insights.INSIGHT_PLACES
count

int64

ผลลัพธ์สําหรับ Insights.INSIGHT_COUNT

ตัวกรอง

ตัวกรองสําหรับ RPC ของ ComputeInsights

ช่อง
location_filter

LocationFilter

ต้องระบุ จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ที่อยู่ในพื้นที่ที่ระบุโดยตัวกรองสถานที่
type_filter

TypeFilter

ต้องระบุ ตัวกรองประเภทสถานที่
operating_status[]

OperatingStatus

ไม่บังคับ จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ที่มีสถานะการทํางานอยู่ในรายการนี้ หากไม่ได้ตั้งค่า operating_status ระบบจะใช้ OPERATING_STATUS_OPERATIONAL เป็นค่าเริ่มต้น
price_levels[]

PriceLevel

ไม่บังคับ จำกัดผลการค้นหาไว้ที่สถานที่ที่มีระดับราคารวมอยู่ในรายการนี้ หากไม่ได้ตั้งค่า price_levels ไว้ ระบบจะรวมระดับราคาทั้งหมดไว้ในผลลัพธ์
rating_filter

RatingFilter

ไม่บังคับ จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ที่ได้รับคะแนนเฉลี่ยจากผู้ใช้ในช่วงที่ระบุโดย rating_filter หากไม่ได้ตั้งค่า rating_filter ระบบจะรวมการจัดประเภททั้งหมดไว้ในผลลัพธ์

ข้อมูลเชิงลึก

ข้อมูลเชิงลึกที่รองรับ

Enum
INSIGHT_UNSPECIFIED ไม่ได้ระบุ
INSIGHT_COUNT

ข้อมูลเชิงลึกการนับ

เมื่อระบุข้อมูลเชิงลึกนี้ ComputeInsights จะแสดงจํานวนสถานที่ที่ตรงกับเกณฑ์ตัวกรองที่ระบุ

ตัวอย่างคำขอ

{
  "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
    }
  }
}

ตัวอย่างคำตอบ

{
  "count": 1234
}
INSIGHT_PLACES

สถานที่สำหรับคืนสินค้า

เมื่อระบุข้อมูลเชิงลึกนี้ ComputeInsights จะแสดงรหัสสถานที่ที่ตรงกับเกณฑ์ตัวกรองที่ระบุ

ตัวอย่างคำขอ

{
  "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
    }
  }
}

ตัวอย่างคำตอบ

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

LocationFilter

ตัวกรองสถานที่ตั้ง

ระบุขอบเขตความสนใจของข้อมูลเชิงลึก

ช่อง
ฟิลด์สหภาพ area คุณต้องระบุค่าใดค่าหนึ่งต่อไปนี้ area ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
circle

Circle

พื้นที่เป็นวงกลม
region

Region

พื้นที่เป็นภูมิภาค
custom_area

CustomArea

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

วงกลม

วงกลมจะกำหนดโดยจุดศูนย์กลางและรัศมีเป็นเมตร

ช่อง
radius

int32

ไม่บังคับ รัศมีของวงกลมเป็นเมตร
ฟิลด์สหภาพ center ตรงกลางวงกลม center ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
lat_lng

LatLng

ละติจูดและลองจิจูดของศูนย์กลางวงกลม
place

string

รูปแบบ: ต้องอยู่ในรูปแบบ places/PLACE_ID โดยที่ PLACE_ID เป็นตัวระบุที่ไม่ซ้ำกันของสถานที่ ตัวอย่างเช่น places/ChIJgUbEo8cfqokR5lP9_Wh_DaM

CustomArea

พื้นที่ที่กำหนดเอง

ช่อง
polygon

Polygon

ต้องระบุ พื้นที่ที่กำหนดเองซึ่งแสดงเป็นรูปหลายเหลี่ยม

รูปหลายเหลี่ยม

รูปหลายเหลี่ยมแสดงด้วยชุดพิกัดที่เชื่อมต่อกันตามลำดับทวนเข็มนาฬิกา พิกัดจะสร้างลูปปิดและกำหนดขอบเขตที่เติม พิกัดแรกและพิกัดสุดท้ายจะเท่ากันและมีค่าเหมือนกัน รูปแบบนี้เป็นรูปหลายเหลี่ยม GeoJSON เวอร์ชันที่เรียบง่าย (เรารองรับเฉพาะวงแหวนด้านนอกแบบทวนเข็มนาฬิกาวงเดียว)

ช่อง
coordinates[]

LatLng

ไม่บังคับ พิกัดที่กําหนดรูปหลายเหลี่ยม

ภูมิภาค

ภูมิภาคคือขอบเขตทางภูมิศาสตร์ เช่น เมือง รหัสไปรษณีย์ เขตการปกครอง รัฐ ฯลฯ

ช่อง
ฟิลด์สหภาพ region กำหนดภูมิภาคทางภูมิศาสตร์ ระบุภูมิภาคได้ครั้งละ 1 ประเภทเท่านั้น (เช่น สถานที่) region ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
place

string

ตัวระบุที่ไม่ซ้ำกันของภูมิภาคทางภูมิศาสตร์ที่เฉพาะเจาะจง

OperatingStatus

สถานะการดําเนินการของสถานที่

Enum
OPERATING_STATUS_UNSPECIFIED ไม่ได้ระบุ ไม่ควรใช้ค่านี้
OPERATING_STATUS_OPERATIONAL สถานที่ดังกล่าวเปิดทำการตามเวลาที่กำหนด
OPERATING_STATUS_PERMANENTLY_CLOSED สถานที่ดังกล่าวปิดกิจการแล้ว
OPERATING_STATUS_TEMPORARILY_CLOSED สถานที่นี้ปิดชั่วคราวและคาดว่าจะเปิดอีกครั้งในอนาคต

PlaceInsight

เก็บข้อมูลเกี่ยวกับสถานที่

ช่อง
place

string

ตัวระบุที่ไม่ซ้ำกันของสถานที่ ชื่อทรัพยากรนี้ใช้ดึงรายละเอียดเกี่ยวกับสถานที่โดยใช้ Places API ได้

PriceLevel

ระดับราคาของที่พัก

Enum
PRICE_LEVEL_UNSPECIFIED ไม่ได้ระบุ ไม่ควรใช้ค่านี้
PRICE_LEVEL_FREE สถานที่ให้บริการฟรี
PRICE_LEVEL_INEXPENSIVE สถานที่ให้บริการราคาไม่แพง
PRICE_LEVEL_MODERATE สถานที่ให้บริการมีบริการราคาปานกลาง
PRICE_LEVEL_EXPENSIVE สถานที่ให้บริการมีราคาแพง
PRICE_LEVEL_VERY_EXPENSIVE สถานที่ให้บริการมีราคาแพงมาก

RatingFilter

ตัวกรองการให้คะแนนของผู้ใช้โดยเฉลี่ย

ช่อง
min_rating

float

ไม่บังคับ จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ที่ได้รับคะแนนโดยเฉลี่ยจากผู้ใช้มากกว่าหรือเท่ากับ min_rating ค่าต้องอยู่ระหว่าง 1.0 ถึง 5.0
max_rating

float

ไม่บังคับ จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ที่ได้รับคะแนนโดยเฉลี่ยจากผู้ใช้น้อยกว่าหรือเท่ากับ max_rating ค่าต้องอยู่ระหว่าง 1.0 ถึง 5.0

TypeFilter

ตัวกรองประเภทสถานที่

รองรับเฉพาะประเภทสถานที่จากตาราง ก

สถานที่หนึ่งๆ จะเชื่อมโยงกับประเภทหลักได้เพียงประเภทเดียวเท่านั้น เช่น ประเภทหลักอาจเป็น "mexican_restaurant" หรือ "steak_house" ใช้ included_primary_types และ excluded_primary_types เพื่อกรองผลลัพธ์ตามประเภทหลักของสถานที่

สถานที่หนึ่งๆ อาจมีค่าประเภทที่เชื่อมโยงอยู่หลายค่า เช่น ร้านอาหารอาจมีประเภทต่อไปนี้ "seafood_restaurant", "restaurant", "food", "point_of_interest", "establishment" ใช้ included_types และ excluded_types เพื่อกรองผลลัพธ์ในรายการประเภทที่เชื่อมโยงกับสถานที่

หากระบุการค้นหาที่มีข้อจำกัดหลายประเภท ระบบจะแสดงเฉพาะสถานที่ที่ตรงกับข้อจำกัดทั้งหมด เช่น หากคุณระบุ {"included_types": ["restaurant"], "excluded_primary_types": ["steak_house"]} สถานที่ที่แสดงจะให้บริการที่เกี่ยวข้องกับ "restaurant" แต่ไม่ได้ดำเนินการเป็น "steak_house" เป็นหลัก

หากมีประเภทที่ขัดแย้งกัน เช่น ประเภทปรากฏทั้งในประเภท included_types และ excluded_types หรือ included_primary_types และ excluded_primary_types ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT

ต้องตั้งค่ารายการใดรายการหนึ่งระหว่าง included_types หรือ included_primary_types

ช่อง
included_types[]

string

ไม่บังคับ ประเภทสถานที่ที่รวมไว้
excluded_types[]

string

ไม่บังคับ ประเภทสถานที่ที่ยกเว้น
included_primary_types[]

string

ไม่บังคับ ประเภทสถานที่หลักที่รวมไว้
excluded_primary_types[]

string

ไม่บังคับ ประเภทสถานที่หลักที่ยกเว้น