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

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

บทนำ

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

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