เลือกเวอร์ชัน API

Places API รองรับ API 2 เวอร์ชัน ได้แก่ Places API ซึ่งเป็น API ที่มีอยู่ และ Places API (ใหม่) ซึ่งเป็น API เวอร์ชันถัดไป

เมื่อมีการเปิดตัว Places API (ใหม่) งานแรกของคุณคือเลือกชุด API ที่จะใช้ กรณีนี้เกิดขึ้นหากคุณเป็นลูกค้าใหม่หรือลูกค้าเดิมที่ใช้ API อยู่แล้ว ใช้คู่มือนี้เพื่อทําความเข้าใจความแตกต่างที่สําคัญระหว่าง API 2 รายการนี้

รายการ API

ตารางต่อไปนี้แสดง API ทั้ง 2 ชุด หากคุณเป็นลูกค้าเดิม ให้ใช้ตารางนี้เพื่อดู API ใหม่ที่จะใช้แทน API ที่คุณใช้อยู่

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

เวอร์ชันของบริการ 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
ที่ปรึกษา ลานเฮลิคอปเตอร์ สนามเด็กเล่น 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 โรงแรม rest_stop

นอกจากประเภทใหม่เหล่านี้แล้ว Places API (ใหม่) ยังย้ายประเภทต่อไปนี้จากตารางที่ 2 ของ Places API ไปยังตาราง ก ของ Places API (ใหม่) ด้วย ซึ่งหมายความว่าตอนนี้คุณใช้ประเภทต่อไปนี้เป็นส่วนหนึ่งของการค้นหาได้

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

ข้อมูลสถานที่แบบไดนามิก

Places API (ใหม่) รองรับข้อมูลการตอบกลับแบบไดนามิก เช่น ความพร้อมให้บริการของสถานีชาร์จ EV หรือราคาน้ำมันล่าสุดของปั๊มน้ำมัน ใช้ช่องคำตอบเหล่านี้เพื่อสร้างประสบการณ์การใช้งานแบบไดนามิก

คุณเลือก API ใด

คุณต้องเลือก API ก่อนจึงจะเริ่มพัฒนาแอปได้ โดยทำดังนี้

  1. หากคุณเป็นลูกค้าใหม่ที่เพิ่งเริ่มต้นใช้งาน Places API ให้เริ่มต้นด้วย API ใหม่

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

  3. หากเป็นลูกค้าเดิม คุณจะใช้ API ที่มีอยู่ต่อไปได้ อย่างไรก็ตาม หากต้องการใช้ประโยชน์จากการปรับปรุงประสิทธิภาพและการเพิ่มฟีเจอร์ของ Places API (ใหม่) คุณสามารถย้ายข้อมูลไปยัง API ใหม่ได้

    ดูข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูลได้ที่ภาพรวมการย้ายข้อมูล