เกี่ยวกับ Places API (ใหม่)

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

บทนำ

Places API (ใหม่) มี API ต่อไปนี้

เอกสารนี้มีภาพรวมของ API ใหม่เหล่านี้

รายละเอียดสถานที่ (ใหม่)

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

คุณขอรับรหัสสถานที่ได้หลายวิธี โดยคุณสามารถใช้สิ่งต่อไปนี้ได้

Place Photos (ใหม่)

Place Photos (ใหม่) ช่วยให้คุณเพิ่มเนื้อหาภาพถ่ายคุณภาพสูงลงในแอปพลิเคชันได้โดยให้สิทธิ์เข้าถึงรูปภาพนับล้านที่จัดเก็บไว้ในฐานข้อมูล Google Places การใช้ Place Photos (ใหม่) API จะช่วยให้คุณเข้าถึง รูปภาพและปรับขนาดรูปภาพให้มีขนาดที่เหมาะสมที่สุดสำหรับแอปพลิเคชันได้

คำขอทั้งหมดไปยัง Place Photos (ใหม่) API ต้องมีชื่อทรัพยากร รูปภาพ ซึ่งระบุรูปภาพที่จะแสดงผลได้อย่างไม่ซ้ำกัน คุณรับชื่อทรัพยากรของรูปภาพได้โดยใช้สิ่งต่อไปนี้

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

การค้นหาข้อความ (ใหม่) และการค้นหาในบริเวณใกล้เคียง (ใหม่)

Places API (ใหม่) มี Search API 2 รายการ ได้แก่

  • การค้นหาข้อความ (ใหม่)

    ช่วยให้คุณระบุสตริงข้อความที่จะค้นหาสถานที่ได้ เช่น "อาหารมังสวิรัติรสเผ็ดในซิดนีย์ ออสเตรเลีย" หรือ "ร้านอาหารทะเลชั้นเลิศใกล้ พาโลอัลโต แคลิฟอร์เนีย"

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

  • การค้นหาในบริเวณใกล้เคียง (ใหม่)

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

    ระบุประเภทสถานที่อย่างน้อย 1 ประเภทที่กำหนดลักษณะของสถานที่ เช่น ระบุ "pizza_restaurant" และ "shopping_mall" เพื่อ ค้นหาร้านพิซซ่าที่ตั้งอยู่ในห้างสรรพสินค้าในภูมิภาคที่ระบุ

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

โทเค็นการเติมข้อความอัตโนมัติ (ใหม่) และเซสชัน

การเติมข้อความอัตโนมัติ (ใหม่) คือบริการบนเว็บที่แสดงการคาดคะเนสถานที่ และการคาดคะเนคำค้นหาเพื่อตอบสนองต่อคำขอ HTTP ในคำขอ ให้ระบุ สตริงการค้นหาข้อความและขอบเขตทางภูมิศาสตร์ที่ควบคุมพื้นที่ค้นหา

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

ฟิลด์ แอตทริบิวต์ และตัวเลือกการช่วยเหลือพิเศษใหม่

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

ช่อง

Places API (ใหม่) มีฟิลด์ใหม่หลายรายการ ดังนี้

ช่อง คำอธิบาย
regularSecondaryOpeningHours อธิบายเวลาที่เฉพาะเจาะจงสำหรับการดำเนินการบางอย่าง เวลาทําการรอง จะแตกต่างจากเวลาทําการหลักของธุรกิจ ตัวอย่างเช่น ร้านอาหารสามารถระบุเวลาทำการของไดรฟ์ทรูหรือเวลาทำการของบริการนำส่งเป็นเวลาทำการรองได้
paymentOptions ตัวเลือกการชำระเงินที่สถานที่ยอมรับ สถานที่หนึ่งๆ อาจยอมรับตัวเลือกการชำระเงินมากกว่า 1 รายการ หากไม่มีข้อมูลตัวเลือกการชำระเงิน ระบบจะไม่ตั้งค่าฟิลด์ตัวเลือกการชำระเงิน ตัวเลือกมีดังนี้
  • บัตรเครดิต
  • บัตรเดบิต
  • รับเฉพาะเงินสด
  • การชำระเงินผ่าน NFC
parkingOptions ตัวเลือกที่จอดรถที่สถานที่ให้บริการ ตัวเลือกมีดังนี้
  • ที่จอดรถฟรี
  • ที่จอดรถแบบเสียค่าใช้จ่าย
  • ที่จอดรถริมถนนแบบไม่เสียค่าใช้จ่าย
  • บริการรับจอดรถ
  • โรงจอดรถแบบไม่เสียค่าใช้จ่าย
  • โรงจอดรถแบบเสียค่าใช้จ่าย
subDestinations สถานที่ที่ไม่ซ้ำกันซึ่งเกี่ยวข้องกับสถานที่หนึ่งๆ เช่น อาคารผู้โดยสารของสนามบินถือเป็นจุดหมายย่อยของ สนามบิน
fuelOptions ข้อมูลล่าสุดเกี่ยวกับตัวเลือกเชื้อเพลิงที่มีให้บริการที่ ปั๊มน้ำมัน ข้อมูลนี้จะมีการอัปเดตเป็นประจำ ตัวเลือกมีดังนี้
  • ดีเซล
  • ธรรมดาไร้สารตะกั่ว
  • เบนซินระดับกลาง
  • พรีเมียม
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • LPG
  • E80
  • E85
  • มีเทน
  • ไบโอดีเซล
  • ดีเซลสำหรับรถบรรทุก
evChargeOptions จำนวนเครื่องชาร์จรถยนต์ไฟฟ้า (EV) ที่สถานีนี้ แม้ว่า ที่ชาร์จ EV บางแห่งจะมีหัวชาร์จหลายหัว แต่ที่ชาร์จแต่ละเครื่องจะชาร์จ รถได้เพียง 1 คันในแต่ละครั้ง ดังนั้นฟิลด์นี้จึงแสดง จำนวนที่ชาร์จ EV ที่พร้อมให้บริการในเวลาที่กำหนด
shortFormattedAddress ที่อยู่ที่มนุษย์อ่านได้แบบสั้นๆ สำหรับสถานที่
primaryType ประเภทหลักของผลลัพธ์ที่ระบุ เช่น สถานที่อาจ จัดอยู่ในประเภทcafeหรือairport สถานที่หนึ่งๆ จะมีประเภทหลักได้เพียงประเภทเดียว ดูรายการค่าที่เป็นไปได้ทั้งหมดได้ที่ประเภทที่รองรับ
primaryTypeDisplayName ชื่อที่แสดงของประเภทหลัก ซึ่งแปลเป็นภาษาของคำขอ (หากมี) ดูรายการค่าทั้งหมดที่เป็นไปได้ได้ที่ประเภทที่รองรับ
entrances ทางเข้าของจุดหมาย ทางเข้าคือคู่พิกัดละติจูด/ลองจิจูดเดียวที่กำหนดตำแหน่งของจุดเข้าและออกของสถานที่
navigationPoints จุดนำทางสำหรับปลายทาง จุดนำทางคือสถานที่ที่อยู่ข้างถนนซึ่งการนำทางสามารถสิ้นสุดได้ รวมถึงโหมดการเดินทางและการใช้งานที่รองรับ

Attributes

Places API (ใหม่) มีแอตทริบิวต์ใหม่หลายรายการ ดังนี้

แอตทริบิวต์ คำอธิบาย
outdoorSeating สถานที่นี้มีที่นั่งกลางแจ้ง
liveMusic สถานที่จัดดนตรีสด
menuForChildren สถานที่นี้มีเมนูสำหรับเด็ก
servesCocktails สถานที่นี้เสิร์ฟค็อกเทล
servesDessert สถานที่นี้มีบริการของหวาน
servesCoffee สถานที่นี้มีบริการกาแฟ
goodForChildren สถานที่นี้เหมาะสำหรับเด็ก
allowsDogs สถานที่อนุญาตให้นำสุนัขเข้าได้
restroom สถานที่นี้มีห้องน้ำ
goodForGroups ที่พักรองรับกลุ่ม
goodForWatchingSports สถานที่นี้เหมาะสำหรับการชมกีฬา

ตัวเลือกการช่วยเหลือพิเศษ

Places API (ใหม่) มีช่องตัวเลือกการช่วยเหลือพิเศษต่อไปนี้

ช่อง คำอธิบาย
wheelchairAccessibleParking สถานที่นี้มีที่จอดรถที่รองรับเก้าอี้รถเข็น
wheelchairAccessibleEntrance สถานที่นี้มีทางเข้าที่รองรับเก้าอี้รถเข็น
wheelchairAccessibleRestroom สถานที่นี้มีห้องน้ำที่รองรับเก้าอี้รถเข็น
wheelchairAccessibleSeating สถานที่นี้มีที่นั่งที่รองรับเก้าอี้รถเข็น

ข้อมูลสรุปที่ทำงานด้วยระบบ AI

ข้อมูลสรุปที่ทำงานด้วยระบบ AI ของ Places API (ใหม่) ใช้ความสามารถของโมเดล Gemini เพื่อ แสดงข้อมูลสรุปเกี่ยวกับสถานที่และพื้นที่ที่ช่วยให้ผู้ใช้ตัดสินใจได้ว่าจะไปที่ไหน

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

เพิ่มฟีเจอร์ที่ทำงานด้วยระบบ AI ลงใน Places API (ใหม่)

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

  • ข้อมูลสรุปของสถานที่ ซึ่งเป็นข้อมูลสรุปภาพรวมสั้นๆ ที่เกี่ยวข้องกับสถานที่หนึ่งๆ
  • ข้อมูลสรุปรีวิว ซึ่งเป็นข้อมูลสรุปที่เข้าใจง่ายเกี่ยวกับสิ่งที่ผู้รีวิวพูดถึงสถานที่
  • ข้อมูลสรุปของพื้นที่ ซึ่งแสดงภาพรวมของสถานที่ใกล้เคียงและสถานที่ยอดนิยมในพื้นที่โดยรอบ ซึ่งรวมถึงข้อมูลสรุปเกี่ยวกับย่านใกล้เคียงและข้อมูลสรุปเกี่ยวกับสถานีชาร์จ EV

Google จะสร้างข้อมูลสรุปเหล่านี้ใหม่บ่อยครั้งเพื่อให้มั่นใจว่าข้อมูลสรุปเป็นข้อมูลล่าสุด โดยอิงตามข้อมูลล่าสุดที่มี เมื่อส่งคำขอ Places API (ใหม่) คุณจะแสดงข้อมูลล่าสุดในแอป

ย้ายข้อมูลไปยัง Places API (ใหม่)

หากคุณเป็นลูกค้าปัจจุบันของ Places API (เดิม) และต้องการย้ายข้อมูลแอปไปใช้ Places API (ใหม่) โปรดดูเอกสารการย้ายข้อมูลต่อไปนี้