Places API รองรับ API 2 เวอร์ชัน ได้แก่ Places API คือ API ที่มีอยู่ และ Places API (ใหม่) เป็น API รุ่นถัดไป
เมื่อเปิดตัว Places API (ใหม่) งานแรกของคุณคือการตัดสินใจว่าจะใช้ API ชุดใด กรณีนี้จะเกิดขึ้นหากคุณเป็นลูกค้าใหม่หรือลูกค้าเดิมที่ใช้ API อยู่แล้ว ใช้คำแนะนำนี้เพื่อทำความเข้าใจ ความแตกต่างสำคัญระหว่าง API ทั้งสอง
รายการ API
ตารางต่อไปนี้แสดง API ทั้ง 2 ชุด หากคุณเป็นลูกค้าเดิม โปรดใช้ตารางนี้เพื่อระบุ API ใหม่ที่จะแทนที่ API ที่คุณใช้งานอยู่ในปัจจุบัน
Places API | Places API (ใหม่) | หมายเหตุ |
---|---|---|
ค้นหาสถานที่ | การค้นหาข้อความ (ใหม่) | ไม่มีเวอร์ชันใหม่ของ "ค้นหาสถานที่" การค้นหาข้อความ (ใหม่) ได้มาแทนที่แล้ว |
การค้นหาใกล้เคียง | การค้นหาใกล้เคียง (ใหม่) | คำขอทั้งหมดที่ใช้ API ที่มีอยู่ซึ่งมีข้อความค้นหาควรใช้ Text Search (ใหม่) เนื่องจากการค้นหาใกล้เคียง (ใหม่) ไม่รองรับการป้อนข้อความ |
การค้นหาข้อความ | การค้นหาข้อความ (ใหม่) | |
รายละเอียดสถานที่ | รายละเอียดสถานที่ (ใหม่) | |
รูปภาพสถานที่ | รูปภาพสถานที่ (ใหม่) | |
สถานที่ในการเติมข้อความอัตโนมัติ | เติมข้อความอัตโนมัติ (ใหม่) | กำลังแสดงตัวอย่าง |
เติมข้อความค้นหาอัตโนมัติ | เติมข้อความอัตโนมัติ (ใหม่) | เพิ่มความสามารถในการเติมข้อความอัตโนมัติเวอร์ชันดูตัวอย่าง (ใหม่) |
เวอร์ชันของบริการ 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 สามารถมีประเภทหลักของสถานที่ได้แล้ว สถานที่ทุกแห่งสามารถมีค่าประเภทเดียวที่ระบุเป็นประเภทหลักของสถานที่ตามที่ระบุไว้ในตาราง ก
นอกจากนี้ API ใหม่จะเพิ่มประเภทสถานที่ที่แสดงในตารางด้านล่างด้วย คุณสามารถใช้ประเภทใหม่เหล่านี้และประเภทที่มีอยู่ในการค้นหาด้วยการค้นหาใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) ประเภทใหม่จะรวมอยู่ในตาราง ก ทั้งหมด
ประเภท | |||
---|---|---|---|
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 | การเข้าพักในฟาร์ม | 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 |
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality
ข้อมูลสถานที่แบบไดนามิก
Places API (ใหม่) รองรับข้อมูลการตอบสนองแบบไดนามิก เช่น ความพร้อมใช้งานของสถานีชาร์จ EV หรือราคาเชื้อเพลิงล่าสุดของปั๊มน้ำมัน ใช้ช่องคำตอบเหล่านี้เพื่อสร้างประสบการณ์ของผู้ใช้แบบไดนามิก
คุณจะเลือก API ใด
ก่อนที่จะเริ่มพัฒนาแอป คุณต้องเลือก API ของคุณดังนี้
หากคุณเป็นลูกค้าใหม่ที่เพิ่งเริ่มต้นใช้งาน Places API ให้เริ่มต้นด้วย API ใหม่
หากคุณเป็นลูกค้าใหม่และยังไม่มีสิ่งที่มาแทน API ที่มีอยู่ เช่น Place Autocomplete หรือการเติมข้อความอัตโนมัติในคำค้นหา คุณก็ใช้ API ใหม่ร่วมกับ API ที่มีอยู่ได้
หากคุณเป็นลูกค้าเดิม คุณจะใช้ API เดิมต่อไปได้ อย่างไรก็ตาม คุณสามารถย้ายข้อมูลไปยัง API ใหม่เพื่อใช้ประโยชน์จากการปรับปรุงประสิทธิภาพและการปรับปรุงฟีเจอร์ของ Places API (ใหม่) ได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูลได้ที่ภาพรวมการย้ายข้อมูล