ย้ายข้อมูลไปยังการค้นหาใกล้เคียง (ใหม่)

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

บทนำ

Places API รองรับการค้นหาในบริเวณใกล้เคียง (เดิม) หากคุ้นเคยกับการค้นหาในบริเวณใกล้เคียง (เดิม) การค้นหาในบริเวณใกล้เคียง (ใหม่) จะทำการเปลี่ยนแปลงต่อไปนี้

  • การค้นหาในบริเวณใกล้เคียง (ใหม่) ใช้คำขอ HTTP POST ส่งพารามิเตอร์ในเนื้อหาคำขอหรือในส่วนหัวโดยเป็นส่วนหนึ่งของคำขอ HTTP POST ในทางตรงกันข้าม เมื่อใช้การค้นหาในบริเวณใกล้เคียง (เดิม) คุณจะส่งพารามิเตอร์ของ URL โดยใช้คำขอ GET ของ HTTP
  • ต้องมีการมาสก์ฟิลด์ คุณต้องระบุช่องที่ต้องการให้แสดงผล ในการตอบกลับ ไม่มีรายการฟิลด์ที่แสดงผลเริ่มต้น หากคุณละเว้น รายการนี้ เมธอดจะแสดงข้อผิดพลาด ดูข้อมูลเพิ่มเติมได้ที่ FieldMask
  • การค้นหาในบริเวณใกล้เคียง (ใหม่) รองรับทั้งคีย์ API และโทเค็น OAuth เป็นกลไกการตรวจสอบสิทธิ์
  • เฉพาะ JSON เท่านั้นที่รองรับเป็นรูปแบบการตอบกลับในการค้นหาในบริเวณใกล้เคียง (ใหม่)
  • ตอนนี้คำขอทั้งหมดที่มีการค้นหาข้อความควรใช้การค้นหาข้อความ (ใหม่) เนื่องจาก การค้นหาในบริเวณใกล้เคียง (ใหม่) ไม่รองรับการป้อนข้อความ
  • รูปแบบการตอบกลับ JSON สำหรับการค้นหาในบริเวณใกล้เคียง (ใหม่) มีการเปลี่ยนแปลงจากรูปแบบของ API เดิม ดูรายละเอียดเพิ่มเติมได้ที่ ย้ายข้อมูลการตอบกลับของ Places API

ตารางต่อไปนี้แสดงพารามิเตอร์ในการค้นหาในบริเวณใกล้เคียง (เดิม) ที่เปลี่ยนชื่อหรือแก้ไขสำหรับการค้นหาในบริเวณใกล้เคียง (ใหม่) หรือพารามิเตอร์ที่ไม่รองรับอีกต่อไป

พารามิเตอร์ปัจจุบัน พารามิเตอร์ใหม่ หมายเหตุ
keyword ไม่รองรับ โปรดใช้ การค้นหาข้อความ (ใหม่) แทน
language languageCode
location locationRestriction ต้องระบุ
maxprice/minprice ไม่รองรับ
maxResultCount พารามิเตอร์ใหม่
opennow ไม่รองรับ
pagetoken ไม่รองรับ
radius ใช้ locationRestriction เลย
rankby rankPreference
regionCode พารามิเตอร์ใหม่
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes 		พารามิเตอร์ใหม่ยังยอมรับค่าประเภทต่างๆ ด้วย API เดิม ยอมรับค่าเดียวเท่านั้น

ตัวอย่างคำขอ

คำขอ GET ตัวอย่างต่อไปนี้ใช้การค้นหาในบริเวณใกล้เคียง (เดิม) ในตัวอย่างนี้ คุณขอการตอบกลับ JSON ที่มีข้อมูลเกี่ยวกับสถานที่ประเภท restaurant และส่งพารามิเตอร์ทั้งหมดเป็นพารามิเตอร์ของ URL ดังนี้

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'

เมื่อใช้การค้นหาในบริเวณใกล้เคียง (ใหม่) คุณจะส่งคำขอ POST และส่งพารามิเตอร์ทั้งหมดในเนื้อหาคำขอ JSON หรือในส่วนหัวโดยเป็นส่วนหนึ่งของคำขอ POST ตัวอย่างนี้ยังใช้มาสก์ฟิลด์เพื่อให้การตอบกลับมีเฉพาะชื่อที่แสดงและที่อยู่ที่จัดรูปแบบของสถานที่ด้วย

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby