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

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

บทนำ

Places API (ใหม่) ประกอบด้วย API ต่อไปนี้

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

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

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

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

Place Photos (ใหม่)

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

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

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

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

Places API (ใหม่) ประกอบด้วย Search API 2 รายการ ได้แก่

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

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

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

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

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

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

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

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

Autocomplete (ใหม่) เป็นบริการบนเว็บที่แสดงการคาดคะเนสถานที่และการคาดคะเนคำค้นหาเพื่อตอบสนองต่อคำขอ 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 (ใหม่) โปรดดูเอกสารประกอบการย้ายข้อมูลต่อไปนี้