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

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 ที่มีอยู่

  • ทั้งสองอย่าง: เปิดใช้ฟีเจอร์และ API ทั้งหมดสำหรับทั้ง 2 อย่าง 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 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
ที่ปรึกษา ลานเฮลิคอปเตอร์ สนามเด็กเล่น 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 ใหม่และที่มีอยู่ผสมกันได้

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

    สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูล โปรดดูที่การย้ายข้อมูล ภาพรวม