การตรวจสอบข้อมูลข้อมูลเชิงลึกเกี่ยวกับสถานที่

สำคัญ: ก่อนที่จะค้นหาข้อมูลข้อมูลเชิงลึกเกี่ยวกับสถานที่ คุณต้องลงชื่อสมัครใช้ก่อน เพื่อรับสิทธิ์เข้าถึงผลิตภัณฑ์ข้อมูลเชิงลึกเกี่ยวกับสถานที่

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

ดูการติดตั้งใช้งานรูปแบบนี้โดยละเอียดได้ที่ Notebook อธิบายนี้

เรียกใช้ใน Google Colab

ดูแหล่งที่มาใน GitHub

รูปแบบสถาปัตยกรรม

รูปแบบสถาปัตยกรรมนี้ช่วยให้คุณมีเวิร์กโฟลว์ที่ทำซ้ำได้เพื่อเชื่อมช่องว่าง ระหว่างการวิเคราะห์ทางสถิติระดับสูงกับการยืนยันความจริง การผสานความสามารถในการปรับขนาดของ BigQuery เข้ากับความแม่นยำของ Places API จะช่วยให้คุณตรวจสอบผลการวิเคราะห์ได้อย่างมั่นใจ ซึ่งมีประโยชน์อย่างยิ่งสำหรับการเลือกสถานที่ การวิเคราะห์คู่แข่ง และการวิจัยตลาดที่ความน่าเชื่อถือของข้อมูลมีความสำคัญสูงสุด

หัวใจสำคัญของรูปแบบนี้เกี่ยวข้องกับขั้นตอนหลัก 4 ขั้นตอน ได้แก่

1. ทำการวิเคราะห์ขนาดใหญ่: ใช้ฟังก์ชันการนับสถานที่ จากข้อมูลเชิงลึกเกี่ยวกับสถานที่ใน BigQuery เพื่อ วิเคราะห์ข้อมูลสถานที่ในพื้นที่ทางภูมิศาสตร์ขนาดใหญ่ เช่น ทั้งเมืองหรือภูมิภาค
2. แยกและดึงตัวอย่าง: ระบุพื้นที่ที่น่าสนใจ (เช่น "ฮอตสปอต" ที่มีความหนาแน่นสูง) จากผลลัพธ์ที่รวบรวมไว้ แล้วดึงsample_place_idsที่ฟังก์ชันระบุไว้
3. ดึงรายละเอียดความจริง: ใช้ Place IDs ที่ดึงออกมาเพื่อทำการเรียกที่กำหนดเป้าหมาย ไปยัง Place Details API เพื่อดึงรายละเอียดที่สมบูรณ์และเป็นจริงของแต่ละสถานที่
4. สร้างภาพข้อมูลรวม: วางเลเยอร์ข้อมูลสถานที่แบบละเอียดไว้เหนือ แผนที่สถิติระดับสูงเริ่มต้นเพื่อตรวจสอบด้วยภาพว่า จำนวนที่รวบรวมแล้วแสดงถึงความเป็นจริงในพื้นที่

เวิร์กโฟลว์ของโซลูชัน

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

วิเคราะห์ความหนาแน่นของสถานที่ในวงกว้างด้วยข้อมูลเชิงลึกเกี่ยวกับสถานที่

ขั้นตอนแรกคือการทำความเข้าใจภาพรวมในระดับสูง คุณสามารถเรียกใช้การค้นหาเพียงครั้งเดียวเพื่อรับข้อมูลสรุปเชิงสถิติแทนการดึงข้อมูลจุดที่น่าสนใจ (POI) หลายพันรายการ

PLACES_COUNT_PER_H3 ฟังก์ชัน ข้อมูลเชิงลึกเกี่ยวกับสถานที่เหมาะสำหรับกรณีนี้ โดยจะรวบรวมจำนวนจุดที่น่าสนใจไว้ในระบบตารางกริดหกเหลี่ยม (H3) ซึ่งช่วยให้คุณระบุพื้นที่ที่มี ความหนาแน่นสูงหรือต่ำได้อย่างรวดเร็วตามเกณฑ์ที่เฉพาะเจาะจง (เช่น ร้านอาหารที่มี คะแนนสูงและเปิดให้บริการ)

ตัวอย่างคำค้นหามีดังนี้ โปรดทราบว่าคุณจะต้องระบุ ภูมิศาสตร์ของพื้นที่ค้นหา คุณสามารถใช้ชุดข้อมูลแบบเปิด เช่น ข้อมูล Overture Maps ชุดข้อมูลสาธารณะของ BigQuery เพื่อดึงข้อมูลขอบเขตทางภูมิศาสตร์

สำหรับขอบเขตชุดข้อมูลแบบเปิดที่ใช้บ่อย เราขอแนะนำให้สร้างเป็นตารางในโปรเจ็กต์ของคุณเอง ซึ่งจะช่วยลดต้นทุน BigQuery และ ปรับปรุงประสิทธิภาพการค้นหาได้อย่างมาก

-- This query counts all highly-rated, operational restaurants
-- across a large geography, grouping them into H3 cells.
SELECT *
FROM
  `places_insights___gb.PLACES_COUNT_PER_H3`(
    JSON_OBJECT(
      'geography', your_defined_geography,
      'h3_resolution', 8,
      'types', ['restaurant'],
      'business_status', ['OPERATIONAL'],
      'min_rating', 3.5
    )
  );

การกรองและการตรวจสอบตามรหัสแบรนด์

หากต้องการตรวจสอบจำนวนและรหัสสถานที่ตัวอย่างสำหรับแบรนด์ที่เฉพาะเจาะจง ให้ระบุรายการรหัสแบรนด์โดยใช้ตัวกรอง brand_ids

หากต้องการรับรหัสแบรนด์สำหรับแบรนด์เป้าหมาย ให้ค้นหาตาราง brands ใน BigQuery โดยใช้คำสั่งต่อไปนี้

SELECT id, name
FROM `YOUR_PROJECT.places_insights___us.brands`
WHERE LOWER(name) LIKE "%starbucks%";

หลังจากดึงรหัสแบรนด์เป้าหมาย (เช่น "1413758728321880760" สำหรับ Starbucks) แล้ว ให้ส่งรหัสนั้นภายในbrand_idsอาร์เรย์ตัวกรอง:

SELECT *
FROM
  `places_insights___us.PLACES_COUNT_PER_H3`(
    JSON_OBJECT(
      'geography', your_defined_geography,
      'h3_resolution', 8,
      'brand_ids', ["1413758728321880760"]
    )
  );

ในขั้นตอนที่ 3 ซึ่งเป็นการยืนยันความจริงพื้นฐาน แทนที่จะยืนยันว่าสถานที่ตรงกับหมวดหมู่ทั่วไป คุณสามารถเปรียบเทียบชื่อที่แสดงที่ API รายละเอียดสถานที่ส่งคืนกับชื่อแบรนด์ที่คาดไว้โดยใช้การจับคู่ตามนิพจน์ทั่วไปได้โดยอัตโนมัติ เช่น คุณสามารถเปรียบเทียบฟิลด์ response.display_name.text ได้

ผลลัพธ์ของคําค้นหานี้จะแสดงตารางของเซลล์ H3 และจํานวนสถานที่ ภายในแต่ละเซลล์ ซึ่งเป็นพื้นฐานสําหรับแผนที่ความหนาแน่นแบบฮีทแมป

แยกฮอตสปอตและดึงรหัสสถานที่ตัวอย่าง

ผลลัพธ์จากฟังก์ชัน PLACES_COUNT_PER_H3 ยังแสดงผลอาร์เรย์ของ sample_place_ids โดยมีรหัสสถานที่สูงสุด 250 รายการต่อองค์ประกอบของการตอบกลับ รหัสเหล่านี้ คือลิงก์จากสถิติรวมไปยังสถานที่แต่ละแห่งที่ มีส่วนทำให้เกิดสถิตินั้น

ระบบอาจระบุเซลล์ที่เกี่ยวข้องมากที่สุดจากคำค้นหาเริ่มต้นก่อน เช่น คุณอาจเลือก 20 เซลล์แรกที่มีจำนวนสูงสุด จากนั้น จากฮอตสปอตเหล่านี้ ให้คุณรวม sample_place_ids ไว้ในรายการเดียว รายการนี้แสดงตัวอย่างจุดที่น่าสนใจที่สุดที่คัดสรรมาแล้วจากพื้นที่ที่เกี่ยวข้องมากที่สุด เพื่อเตรียมพร้อมสำหรับการยืนยันที่กำหนดเป้าหมาย

หากคุณประมวลผลผลลัพธ์ BigQuery ใน Python โดยใช้ pandas DataFrame ตรรกะในการแยกรหัสเหล่านี้จะตรงไปตรงมา ดังนี้

# Assume 'results_df' is a pandas DataFrame from your BigQuery query.

# 1. Identify the 20 busiest H3 cells by sorting and taking the top results.
top_hotspots_df = results_df.sort_values(by='count', ascending=False).head(20)

# 2. Extract and flatten the lists of sample_place_ids from these hotspots.
# The .explode() function creates a new row for each ID in the lists.
all_sample_ids = top_hotspots_df['sample_place_ids'].explode()

# 3. Create a final list of unique Place IDs to verify.
place_ids_to_verify = all_sample_ids.unique().tolist()

print(f"Consolidated {len(place_ids_to_verify)} unique Place IDs for spot-checking.")

คุณสามารถใช้ตรรกะที่คล้ายกันได้หากใช้ภาษาโปรแกรมอื่นๆ

เรียกดูรายละเอียดความจริงพื้นฐานด้วย Places API

เคล็ดลับ: Geocoding API ยังรองรับการใช้รหัสสถานที่เพื่อดึงข้อมูลสถานที่ด้วย

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

นี่คือขั้นตอนการตรวจสอบที่สำคัญ แม้ว่าข้อมูลเชิงลึกเกี่ยวกับสถานที่จะบอกจำนวนร้านอาหารในพื้นที่หนึ่งๆ แต่ Places API จะบอกชื่อร้านอาหารเหล่านั้น พร้อมระบุชื่อ ที่อยู่ที่แน่นอน ละติจูด/ลองจิจูด คะแนนของผู้ใช้ และแม้แต่ลิงก์โดยตรงไปยังตำแหน่งของร้านอาหารใน Google Maps ซึ่งจะช่วยเพิ่มข้อมูลตัวอย่าง และเปลี่ยนรหัสที่เป็นนามธรรมให้กลายเป็นสถานที่ที่จับต้องได้และยืนยันได้

ดูรายการข้อมูลทั้งหมดที่ใช้ได้จาก Place Details API และค่าใช้จ่าย ที่เกี่ยวข้องกับการดึงข้อมูลได้ที่เอกสารประกอบเกี่ยวกับ API

คำขอไปยัง Places API สำหรับรหัสที่เฉพาะเจาะจงโดยใช้ไลบรารีของไคลเอ็นต์ Python จะมีลักษณะดังนี้ ดูรายละเอียดเพิ่มเติมได้ที่ตัวอย่างไลบรารีของไคลเอ็นต์ Places API (ใหม่)

# A request to fetch details for a single Place ID.
request = {"name": f"places/{place_id}"}

# Define the fields you want returned in the response as a comma-separated string.
fields_to_request = "formattedAddress,location,displayName,googleMapsUri"

# The response contains ground truth data.
response = places_client.get_place(
    request=request,
    metadata=[("x-goog-fieldmask", fields_to_request)]
)

โปรดทราบว่าฟิลด์ในคำขอนี้ดึงข้อมูลจาก SKU การเรียกเก็บเงิน 2 รายการที่แตกต่างกัน

• formattedAddress และ location เป็นส่วนหนึ่งของ รายละเอียดสถานที่ ข้อมูลสำคัญ SKU
• displayName และ googleMapsUri เป็นส่วนหนึ่งของ รายละเอียดสถานที่ Pro SKU

เมื่อคำขอรายละเอียดสถานที่เดียวมีฟิลด์จาก SKU หลายรายการ ระบบจะเรียกเก็บเงินทั้งคำขอในอัตราของ SKU ระดับสูงสุด ดังนั้น ระบบจะเรียกเก็บเงินสำหรับการเรียกใช้เฉพาะนี้เป็นการเรียกใช้รายละเอียดสถานที่ Pro

หากต้องการควบคุมต้นทุน ให้ใช้ FieldMask เสมอเพื่อขอเฉพาะฟิลด์ที่แอปพลิเคชันของคุณต้องการ

สร้างภาพแบบรวมเพื่อการตรวจสอบ

เคล็ดลับ: Places UI Kit ยังใช้เพื่อแสดงผลลัพธ์ด้วยรหัสสถานที่ได้ด้วย

ขั้นตอนสุดท้ายคือการรวมชุดข้อมูลทั้ง 2 ชุดไว้ในมุมมองเดียว ซึ่งจะช่วยให้คุณตรวจสอบการวิเคราะห์เบื้องต้นได้อย่างรวดเร็วและง่ายดาย ภาพควรมี 2 เลเยอร์ดังนี้

1. เลเยอร์ฐาน: แผนที่ Choropleth หรือแผนที่ความหนาแน่นที่สร้างจากผลลัพธ์เริ่มต้น PLACES_COUNT_PER_H3 ซึ่งแสดงความหนาแน่นโดยรวมของสถานที่ต่างๆ ใน พื้นที่ทางภูมิศาสตร์ของคุณ
2. เลเยอร์บนสุด: ชุดเครื่องหมายแต่ละรายการสำหรับจุดที่น่าสนใจตัวอย่างแต่ละรายการ ซึ่งพล็อต โดยใช้พิกัดที่แน่นอนซึ่งดึงมาจาก Places API ในขั้นตอนก่อนหน้า

ตรรกะในการสร้างมุมมองแบบรวมนี้แสดงอยู่ในตัวอย่างรหัสเทียมต่อไปนี้

# Assume 'h3_density_data' is your aggregated data from Step 1.
# Assume 'detailed_places_data' is your list of place objects from Step 3.

# Create the base choropleth map from the H3 density data.
# The 'count' column determines the color of each hexagon.
combined_map = create_choropleth_map(
    data=h3_density_data,
    color_by_column='count'
)

# Iterate through the detailed place data to add individual markers.
for place in detailed_places_data:
    # Construct the popup information with key details and a link.
    popup_html = f"""
    <b>{place.name}</b><br>
    Address: {place.address}<br>
    <a href="{place.google_maps_uri}" target="_blank">View on Maps</a>
    """

    # Add a marker for the current place to the base map.
    combined_map.add_marker(
        location=[place.latitude, place.longitude],
        popup=popup_html,
        tooltip=place.name
    )

# Display the final map with both layers.
display(combined_map)

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

บทสรุป

รูปแบบสถาปัตยกรรมนี้เป็นวิธีที่แข็งแกร่งและมีประสิทธิภาพในการตรวจสอบความถูกต้องของข้อมูลเชิงลึกเชิงพื้นที่ขนาดใหญ่ การใช้ประโยชน์จากข้อมูลเชิงลึกเกี่ยวกับสถานที่สำหรับการวิเคราะห์ในวงกว้างที่ปรับขนาดได้ และ Place Details API สำหรับการยืนยันความจริงที่กำหนดเป้าหมาย จะช่วยสร้างวงจรความคิดเห็นที่มีประสิทธิภาพ ซึ่งจะช่วยให้มั่นใจได้ว่าการตัดสินใจเชิงกลยุทธ์ ไม่ว่าจะเป็นการเลือกสถานที่ตั้งร้านค้าปลีกหรือการวางแผนด้านลอจิสติกส์ จะอิงตามข้อมูลที่ไม่เพียงแต่มีนัยสำคัญทางสถิติเท่านั้น แต่ยังมีความถูกต้องที่ตรวจสอบได้อีกด้วย

ขั้นตอนถัดไป

• สํารวจฟังก์ชันการนับสถานที่อื่นๆ เพื่อดูว่าฟังก์ชันเหล่านี้ตอบคําถามเชิงวิเคราะห์ที่แตกต่างกันได้อย่างไร
• ดูเอกสารประกอบของ Places API เพื่อค้นหาฟิลด์อื่นๆ ที่คุณขอได้เพื่อเพิ่มคุณค่าให้กับการวิเคราะห์

ผู้ร่วมให้ข้อมูล

Henrik Valve | DevX Engineer