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

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

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

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

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

การรับรหัสสถานที่ทำได้หลายวิธี ดังนี้

รูปภาพสถานที่ (ใหม่)

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

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

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

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

Places API ประกอบด้วย API การค้นหา 2 แบบ ได้แก่

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

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

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

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

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

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

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

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

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

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

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

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

ช่อง

Places API (ใหม่) มีฟิลด์ใหม่หลายฟิลด์:

ช่อง คำอธิบาย
regularSecondaryOpeningHours อธิบายเวลาที่เฉพาะเจาะจงสำหรับการดำเนินการบางอย่าง ข้อมูลรอง เวลาทำการแตกต่างจากเวลาทำการหลักของธุรกิจ สำหรับ เช่น ร้านอาหารสามารถระบุช่วงเวลาขับรถหรือบริการจัดส่ง เป็นเวลาทำการรองด้วย
paymentOptions ตัวเลือกการชำระเงินที่สถานที่นี้ยอมรับ สถานที่สามารถยอมรับได้มากกว่า หนึ่งตัวเลือกการชำระเงิน หากไม่มีข้อมูลตัวเลือกการชำระเงิน ระบบจะยกเลิกการตั้งค่าฟิลด์ตัวเลือกการชำระเงิน โดยมีตัวเลือกดังต่อไปนี้
  • บัตรเครดิต
  • บัตรเดบิต
  • รับเฉพาะเงินสด
  • การชำระเงินผ่าน 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 ชื่อที่แสดงของประเภทหลัก ซึ่งแปลตามคําขอ ภาษา หากมี สำหรับรายการค่าที่เป็นไปได้ทั้งหมด ดูประเภทที่รองรับ

Attributes

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

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

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

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

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

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

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