บทนำ
Places API ช่วยให้คุณค้นหาและดึงข้อมูลของสถานที่ประเภทต่างๆ โดยใช้สตริงข้อความหรือตามความใกล้เคียงได้ Places API (เดิม) เป็นเวอร์ชันเดิมของ Places API (ใหม่)
ตารางต่อไปนี้แสดงเวอร์ชันที่สอดคล้องกันของ API ทั้ง 2 รายการ ใช้คู่มือนี้เพื่อทำความเข้าใจความแตกต่างที่สำคัญระหว่างทั้ง 2 รายการและย้ายข้อมูลไปยัง Places API (ใหม่)
| Places API (เดิม) | Places API (ใหม่) | หมายเหตุ |
|---|---|---|
| ค้นหาสถานที่ (เดิม) | การค้นหาข้อความ (ใหม่) | ไม่มีการค้นหาสถานที่ (เดิม) เวอร์ชันใหม่ โดย การค้นหาข้อความ (ใหม่) จะมาแทนที่ |
| การค้นหาในบริเวณใกล้เคียง (เดิม) | การค้นหาในบริเวณใกล้เคียง (ใหม่) | คำขอทั้งหมดที่ใช้ API เดิมซึ่งมีคำค้นหาข้อความควรใช้การค้นหาข้อความ (ใหม่) เนื่องจาก การค้นหาในบริเวณใกล้เคียง (ใหม่) ไม่รองรับการป้อนข้อความ |
| การค้นหาข้อความ (เดิม) | การค้นหาข้อความ (ใหม่) | |
| รายละเอียดสถานที่ (เดิม) | รายละเอียดสถานที่ (ใหม่) | |
| Place Photos (เดิม) | Place Photos (ใหม่) | |
| Place Autocomplete (เดิม) | Autocomplete (ใหม่) | |
| Query Autocomplete (เดิม) | Autocomplete (ใหม่) | เพิ่มความสามารถในการเติมข้อความอัตโนมัติ (ใหม่) |
ย้ายข้อมูลไปยัง API ใหม่
หากต้องการย้ายข้อมูลไปยัง API ใหม่ โปรดดูคำแนะนำในการย้ายข้อมูลต่อไปนี้
- ย้ายข้อมูลไปยังการค้นหาในบริเวณใกล้เคียง (ใหม่)
- ย้ายข้อมูลไปยังการค้นหาข้อความ (ใหม่)
- ย้ายข้อมูลไปยังรายละเอียดสถานที่ (ใหม่)
- ย้ายข้อมูลไปยังรูปภาพของสถานที่ (ใหม่)
- ย้ายข้อมูลไปยัง Autocomplete (ใหม่)
ฟีเจอร์หลักที่เพิ่มลงใน Places API (ใหม่)
ส่วนนี้จะครอบคลุมฟีเจอร์หลักที่เพิ่มลงใน Places API (ใหม่)
ติดตั้งใช้งานบนแพลตฟอร์มมาตรฐานของ Google Cloud
Places API (ใหม่) มีการติดตั้งใช้งานในโครงสร้างพื้นฐานของบริการใน Google Cloud การใช้งานนี้จะช่วยให้แพลตฟอร์มมีความปลอดภัยและน่าเชื่อถือมากขึ้น พร้อมตัวเลือกด้านความปลอดภัยที่ได้รับการปรับปรุง เช่น OAuth การออกแบบ API มาตรฐานนี้ช่วยให้ API มีความสอดคล้องกัน ซึ่งจะช่วยเพิ่มประสิทธิภาพในการพัฒนาด้วย Places API (ใหม่)
ประสิทธิภาพที่ดีขึ้น
Places API (ใหม่) มีประสิทธิภาพที่ดีขึ้น จึงคุ้มค่าที่จะแทนที่แอปที่ใช้ Places API เดิม
การกำหนดราคาที่เข้าใจง่าย
Places API (ใหม่) ช่วยให้การกำหนดราคาง่ายขึ้น คุณจึงจ่ายเฉพาะข้อมูลที่ใช้เท่านั้น การกำหนดราคาแบบง่ายจะใช้มาสก์ฟิลด์
เมื่อใช้รายละเอียดสถานที่ (ใหม่), การค้นหาในบริเวณใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) คุณจะใช้มาสก์ฟิลด์เพื่อควบคุมรายการฟิลด์ที่จะแสดงผลในการตอบกลับ จากนั้นระบบจะเรียกเก็บเงินเฉพาะข้อมูลที่ขอเท่านั้น การใช้การมาสก์ช่องเป็นแนวทางปฏิบัติแนะนำในการออกแบบเพื่อให้แน่ใจว่าคุณไม่ได้ขอข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยหลีกเลี่ยงเวลาในการประมวลผลและการเรียกเก็บเงินที่ไม่จำเป็น
ข้อมูลการตอบกลับที่สอดคล้องกันสำหรับสถานที่
เมื่อใช้ API เดิม API รายละเอียดสถานที่ (เดิม), การค้นหาในบริเวณใกล้เคียง (เดิม) และการค้นหาข้อความ (เดิม) จะแสดงข้อมูลการตอบกลับที่แตกต่างกันสำหรับสถานที่หนึ่งๆ Places API (ใหม่) จะกำหนดมาตรฐานการตอบกลับเพื่อให้ API เหล่านี้แสดงผลข้อมูลเดียวกันสำหรับสถานที่หนึ่งๆ
ประเภทสถานที่ที่ขยาย
ตอนนี้การตอบกลับจาก API สามารถมีประเภทหลักของสถานที่ได้แล้ว สถานที่ทุกแห่งสามารถมีค่าประเภทเดียวที่ระบุเป็นประเภทหลักของสถานที่ตามที่แสดงในตาราง ก
นอกจากนี้ API ใหม่ยังมีประเภทใหม่ๆ อีกหลายประเภท คุณสามารถใช้ประเภทใหม่เหล่านี้และประเภทที่มีอยู่ในการค้นหาด้วยการค้นหาในบริเวณใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) ประเภทใหม่ทั้งหมดจะรวมอยู่ในตาราง ก
ข้อมูลสถานที่แบบไดนามิก
Places API (ใหม่) รองรับข้อมูลการตอบกลับแบบไดนามิก เช่น ความพร้อมให้บริการของสถานีชาร์จ EV หรือราคาน้ำมันล่าสุดของปั๊มน้ำมัน ใช้ช่องการตอบกลับเหล่านี้เพื่อสร้างประสบการณ์การใช้งานแบบไดนามิกให้แก่ผู้ใช้