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

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

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

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

พารามิเตอร์ปัจจุบัน	พารามิเตอร์ใหม่	หมายเหตุ
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