Places API รองรับ API 2 เวอร์ชัน ได้แก่ Places API คือ API ที่มีอยู่แล้ว และ Places API (ใหม่) คือ API รุ่นถัดไป
การเปิดตัว Places API (ใหม่) งานแรกของคุณคือการตัดสินใจว่าจะใช้ API ชุดใด หากคุณเป็นลูกค้าใหม่หรือลูกค้าเดิมที่ใช้ API อยู่แล้ว ให้ใช้คำแนะนำนี้เพื่อทำความเข้าใจ ความแตกต่างที่สำคัญระหว่าง API ทั้งสอง
รายการ API
ตารางต่อไปนี้แสดง API ทั้ง 2 ชุด หากคุณเป็นลูกค้าเดิม ให้ใช้ตารางนี้เพื่อกำหนด API ใหม่ที่จะมาแทนที่ API ที่คุณใช้งานอยู่
Places API | Places API (ใหม่) | หมายเหตุ |
---|---|---|
ค้นหาสถานที่ | การค้นหาข้อความ (ใหม่) | ไม่มีเวอร์ชันใหม่ของ "Find Place" เราแทนที่การค้นหาข้อความ (ใหม่) แล้ว |
การค้นหาใกล้เคียง | การค้นหาใกล้เคียง (ใหม่) | คำขอทั้งหมดที่ใช้ API ที่มีอยู่ซึ่งมีข้อความค้นหาควรใช้การค้นหาข้อความ (ใหม่) เนื่องจากการค้นหาใกล้เคียง (ใหม่) ไม่รองรับการป้อนข้อความ |
การค้นหาข้อความ | การค้นหาข้อความ (ใหม่) | |
รายละเอียดสถานที่ | รายละเอียดสถานที่ (ใหม่) | |
รูปภาพสถานที่ | รูปภาพสถานที่ (ใหม่) | |
เติมข้อความอัตโนมัติเกี่ยวกับสถานที่ | เติมข้อความอัตโนมัติ (ใหม่) | |
เติมคำค้นหาอัตโนมัติ | เติมข้อความอัตโนมัติ (ใหม่) | เพิ่มความสามารถไปยังการเติมข้อความอัตโนมัติ (ใหม่) |
เวอร์ชันของบริการ Places API ที่คุณเปิดใช้ในคีย์ API จะควบคุม API ที่แอปของคุณใช้ ดังนี้
Places API: เปิดใช้ API ที่มีอยู่ หากเปิดใช้แต่ Places API สำหรับโปรเจ็กต์ที่เชื่อมโยงกับคีย์ API ที่ใช้กับแอปของคุณ แอปจะไม่มีสิทธิ์เข้าถึง API ใหม่ดังกล่าว
Places API (ใหม่): เปิดใช้ API และฟีเจอร์ใหม่ทั้งหมดที่อธิบายไว้ในฟีเจอร์สำคัญที่เพิ่มลงใน Places SDK สำหรับ iOS (ใหม่) แอปจะไม่มีสิทธิ์เข้าถึง API ที่มีอยู่
ทั้ง 2 อย่าง: เปิดใช้ฟีเจอร์และ API ทั้งหมดสำหรับทั้ง Places SDK สำหรับ iOS (ใหม่) และ Places SDK สำหรับ iOS
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเลือกบริการ Places API ได้ที่ตั้งค่าโปรเจ็กต์ Google Cloud
ย้ายข้อมูลไปยัง API ใหม่
หากคุณใช้ API ที่มีอยู่และต้องการย้ายข้อมูลไปยัง API ใหม่ ให้ดูคำแนะนำในการย้ายข้อมูลต่อไปนี้สำหรับ API แต่ละรายการ
- ย้ายข้อมูลไปยังการค้นหาใกล้เคียง (ใหม่)
- ย้ายข้อมูลไปยังการค้นหาข้อความ (ใหม่)
- ย้ายข้อมูลไปยังรายละเอียดสถานที่ (ใหม่)
- ย้ายข้อมูลไปยังรูปภาพสถานที่ (ใหม่)
- ย้ายข้อมูลไปยังการเติมข้อความอัตโนมัติ (ใหม่)
คุณลักษณะสำคัญที่เพิ่มเข้ามาใน 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 มีประเภทหลักของสถานที่ได้แล้ว สถานที่ทุกแห่งจะมีค่าประเภทเดียวซึ่งระบุเป็นประเภทหลักของสถานที่ได้ตามที่ระบุไว้ในตาราง A
นอกจากนี้ API ใหม่ยังเพิ่มประเภทสถานที่ที่แสดงในตารางด้านล่าง คุณสามารถใช้ประเภทใหม่เหล่านี้และประเภทที่มีอยู่ในการค้นหาด้วยการค้นหาใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) ประเภทใหม่จะรวมอยู่ใน ตาราง A
ประเภท | |||
---|---|---|---|
american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
amusement_center | dog_park | indian_restaurant | school_district |
athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
auto_parts_store | event_venue | italian_restaurant | ski_resort |
banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
barbecue_restaurant | ฟาร์ม | korean_restaurant | sporting_goods_store |
barber_shop | Farmstay | lebanese_restaurant | sports_club |
bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
brazilian_restaurant | ferry_terminal | ตลาด | steak_house |
breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
bus_stop | gift_shop | mexican_restaurant | ช่างตัดเสื้อ |
camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
cell_phone_store | greek_restaurant | โมเต็ล | thai_restaurant |
child_care_agency | grocery_store | national_park | transit_depot |
chinese_restaurant | guest_house | park_and_ride | truck_stop |
coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
ที่ปรึกษา | ลานเฮลิคอปเตอร์ | playground | vegetarian_restaurant |
convention_center | hiking_area | เด็กก่อนวัยเรียน | vietnamese_restaurant |
บังกะโล | historical_landmark | private_guest_room | visitor_center |
courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
cultural_center | โรงแรมขนาดเล็ก | resort_hotel | ผู้ค้าส่ง |
dental_clinic | hotel | rest_stop |
นอกจากประเภทใหม่เหล่านี้แล้ว Places API (ใหม่) ได้ย้ายประเภทต่อไปนี้จากตาราง 2 สำหรับ Places API ไปยังตาราง A สำหรับ Places API (ใหม่) ซึ่งหมายความว่าตอนนี้คุณจะใช้ประเภทต่อไปนี้ในการค้นหาได้
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality
ข้อมูลสถานที่แบบไดนามิก
Places API (ใหม่) รองรับข้อมูลการตอบสนองแบบไดนามิก เช่น ความพร้อมให้บริการของสถานีชาร์จ EV หรือราคาเชื้อเพลิงล่าสุดของปั๊มน้ำมัน ใช้ช่องคำตอบเหล่านี้เพื่อสร้างประสบการณ์ของผู้ใช้แบบไดนามิก
คุณควรเลือกใช้ API ใด
ก่อนที่จะเริ่มพัฒนาแอป คุณต้องเลือก API ของคุณดังต่อไปนี้
หากคุณเป็นลูกค้าใหม่ที่เพิ่งเริ่มต้นใช้งาน Places API ให้ลองเริ่มต้นด้วย API ใหม่
หากคุณเป็นลูกค้าใหม่และยังไม่ได้มีผลิตภัณฑ์ทดแทนสำหรับ API ที่มีอยู่ เช่น เติมข้อความอัตโนมัติในสถานที่หรือเติมข้อความค้นหาอัตโนมัติ คุณสามารถใช้ทั้ง API ใหม่และที่มีอยู่ได้
หากคุณเป็นลูกค้าเดิม คุณจะใช้ API ที่มีอยู่ต่อไปได้ อย่างไรก็ตาม หากต้องการใช้ประโยชน์จากการปรับปรุงประสิทธิภาพและการปรับปรุงคุณลักษณะของ Places API (ใหม่) คุณสามารถย้ายข้อมูลไปยัง API ใหม่ได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูลได้ในภาพรวมการย้ายข้อมูล