Place Autocomplete (เดิม)

Place Autocomplete (เดิม) เป็นเว็บเซอร์วิสที่แสดงผลการคาดคะเนสถานที่เพื่อตอบสนองต่อคำขอ HTTP คำขอระบุสตริงการค้นหาที่เป็นข้อความ และขอบเขตทางภูมิศาสตร์ที่ไม่บังคับ บริการนี้ใช้เพื่อมอบฟังก์ชันการเติมข้อความอัตโนมัติสำหรับการค้นหาทางภูมิศาสตร์แบบข้อความได้ โดยจะแสดงสถานที่ต่างๆ เช่น ธุรกิจ ที่อยู่ และจุดที่น่าสนใจขณะที่ผู้ใช้พิมพ์

คำขอ Place Autocomplete (เดิม)

Place Autocomplete (เดิม) เป็นส่วนหนึ่งของ Places API และใช้คีย์ API และโควต้าเดียวกันกับ Places API

Place Autocomplete (เดิม) สามารถจับคู่คำและสตริงย่อยทั้งหมด เพื่อระบุชื่อสถานที่ ที่อยู่ และ Plus Code ดังนั้น แอปพลิเคชันจึงสามารถส่งการค้นหาขณะที่ผู้ใช้พิมพ์เพื่อแสดงการคาดคะเนสถานที่แบบเรียลไทม์

คุณต้องจัดรูปแบบ Plus Code อย่างถูกต้อง ซึ่งหมายความว่าคุณต้องหลีกเลี่ยงเครื่องหมายบวกใน URL เป็น %2B และต้องหลีกเลี่ยงการเว้นวรรคใน URL เป็น %20

• รหัสสากลคือรหัสพื้นที่ 4 หลักและรหัสท้องถิ่น 6 หลักขึ้นไป ตัวอย่างเช่น รหัสส่วนกลางที่ใช้หลีกเลี่ยงอักขระพิเศษใน URL 849VCWC8+R9 คือ 849VCWC8%2BR9
• รหัสผสมคือรหัสท้องถิ่น 6 หลัก (หรือมากกว่า) ที่มีการระบุตำแหน่งชัดเจน ตัวอย่างเช่น รหัสผสมที่หลีกเลี่ยง URL CWC8+R9 Mountain View, CA, USA คือ CWC8%2BR9%20Mountain%20View%20CA%20USA

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

คำขอ Place Autocomplete (เดิม) คือ HTTP URL ในรูปแบบต่อไปนี้

https://maps.googleapis.com/maps/api/place/autocomplete/output?parameters

โดย output อาจมีค่าใดค่าหนึ่งต่อไปนี้

• json (แนะนํา) ระบุเอาต์พุตใน JavaScript Object Notation (JSON)
• xml ระบุเอาต์พุตเป็น XML

ต้องใช้พารามิเตอร์บางอย่างเพื่อเริ่มต้นคำขอ Place Autocomplete (เดิม) พารามิเตอร์ทั้งหมดจะแยกกันโดยใช้อักขระแอมเพอร์แซนด์ (&) ตามมาตรฐานใน URL รายการพารามิเตอร์และค่าที่เป็นไปได้ แสดงอยู่ด้านล่าง

พารามิเตอร์ที่จำเป็น

• อินพุต

  สตริงข้อความที่จะค้นหา บริการ Place Autocomplete จะ แสดงผลการจับคู่ที่เกี่ยวข้องตามสตริงนี้ และจัดลำดับผลลัพธ์ตาม ความเกี่ยวข้องที่รับรู้

พารามิเตอร์ที่ไม่บังคับ

• คอมโพเนนต์

  การจัดกลุ่มสถานที่ที่คุณต้องการจำกัดผลลัพธ์ คุณใช้คอมโพเนนต์เพื่อกรองตามประเทศได้สูงสุด 5 ประเทศ ต้องส่งประเทศเป็นรหัสประเทศแบบ 2 อักขระที่เข้ากันได้กับ ISO 3166-1 Alpha-2 เช่น components=country:fr จะ จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ในฝรั่งเศส ต้องส่งหลายประเทศเป็นตัวกรอง country:XX หลายตัว โดยมีอักขระไปป์ | เป็นตัวคั่น ตัวอย่างเช่น components=country:us|country:pr|country:vi|country:gu|country:mp จะจำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ในสหรัฐอเมริกาและ เขตแดนที่จัดตั้งขึ้นแต่ไม่ได้จดทะเบียน

  หมายเหตุ: หากได้รับผลลัพธ์ที่ไม่คาดคิดพร้อมรหัสประเทศ โปรดตรวจสอบว่าคุณใช้รหัสที่มีประเทศ เขตแดนขึ้นอยู่ และพื้นที่พิเศษที่น่าสนใจทางภูมิศาสตร์ที่คุณ ต้องการ คุณดูข้อมูลรหัสได้ที่ Wikipedia: รายการรหัสประเทศ ISO 3166 หรือ แพลตฟอร์มการเรียกดูออนไลน์ของ ISO

• ภาษา

  ภาษาที่จะแสดงผลลัพธ์

  • ดูรายการภาษาที่รองรับ Google อัปเดตภาษาที่รองรับอยู่บ่อยครั้ง รายการนี้จึงอาจไม่ครบถ้วนสมบูรณ์
  • หากไม่ได้ระบุ language ไว้ API จะพยายามใช้ภาษาที่ต้องการตามที่ระบุไว้ในส่วนหัว Accept-Language
  • API จะพยายามอย่างเต็มที่เพื่อให้ที่อยู่ที่อ่านง่ายสำหรับทั้งผู้ใช้และคนในพื้นที่ เพื่อให้บรรลุเป้าหมายดังกล่าว ระบบจะแสดงที่อยู่ในภาษาท้องถิ่น โดยแปลงเป็นสคริปต์ที่ผู้ใช้อ่านได้หากจำเป็น ตามภาษาที่ต้องการ ส่วนที่อยู่อื่นๆ จะแสดงในภาษาที่ต้องการ คอมโพเนนต์ของที่อยู่ ทั้งหมดจะแสดงในภาษาเดียวกัน ซึ่งเลือกจากคอมโพเนนต์แรก
  • หากชื่อไม่มีในภาษาที่ต้องการ API จะใช้ชื่อที่ใกล้เคียงที่สุด
  • ภาษาที่ต้องการมีผลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกที่จะแสดง และลำดับที่แสดง โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์ จะตีความตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อของประเภทถนน หรือคำพ้องความหมายที่อาจ ใช้ได้ในภาษาหนึ่งแต่ใช้ไม่ได้ในอีกภาษาหนึ่ง ตัวอย่างเช่น utca และ tér เป็นคำพ้องความหมายของคำว่าถนนในภาษาฮังการี

• สถานที่

  จุดที่ต้องการดึงข้อมูลสถานที่ ต้องระบุเป็น latitude,longitude ต้องระบุพารามิเตอร์ radius ด้วยเมื่อระบุสถานที่ตั้ง หากไม่ได้ระบุ radius ระบบจะไม่สนใจพารามิเตอร์ location

  เมื่อใช้ Text Search API ระบบอาจลบล้างพารามิเตอร์ `location` หาก `query` มีตำแหน่งที่ชัดเจน เช่น `Market in Barcelona`

• locationbias

  ต้องการผลลัพธ์ในพื้นที่ที่ระบุโดยการระบุรัศมีและ lat/lng หรือคู่ lat/lng 2 คู่ที่แสดงจุดของสี่เหลี่ยมผืนผ้า หากไม่ได้ระบุพารามิเตอร์นี้ API จะใช้การปรับที่อยู่ IP ตามค่าเริ่มต้น

  • อคติของ IP: สั่งให้ API ใช้การปรับที่อยู่ IP ส่งสตริง ipbias (ตัวเลือกนี้ไม่มีพารามิเตอร์เพิ่มเติม)
  • วงกลม: สตริงที่ระบุรัศมีเป็นเมตร พร้อมละติจูด/ลองจิจูดในรูปแบบทศนิยม องศา โดยใช้รูปแบบต่อไปนี้ circle:radius@lat,lng
  • สี่เหลี่ยมผืนผ้า: สตริงที่ระบุคู่ละติจูด/ลองจิจูด 2 คู่ในรูปแบบองศาทศนิยม ซึ่งแสดงจุดใต้/ตะวันตกและเหนือ/ตะวันออกของสี่เหลี่ยมผืนผ้า ใช้รูปแบบต่อไปนี้ rectangle:south,west|north,east โปรดทราบว่าค่าตะวันออก/ตะวันตกจะรวมอยู่ในช่วง -180, 180 และค่าเหนือ/ใต้จะจำกัดอยู่ในช่วง -90, 90

• locationrestriction

  จำกัดผลลัพธ์ให้อยู่ในพื้นที่ที่ระบุโดยการระบุรัศมีบวก lat/lng หรือคู่ lat/lng 2 คู่ที่แสดงจุดของสี่เหลี่ยมผืนผ้า

  • วงกลม: สตริงที่ระบุรัศมีเป็นเมตร พร้อมละติจูด/ลองจิจูดในรูปแบบทศนิยม องศา ใช้รูปแบบต่อไปนี้ circle:radius@lat,lng
  • สี่เหลี่ยมผืนผ้า: สตริงที่ระบุคู่ละติจูด/ลองจิจูด 2 คู่ในรูปแบบองศาทศนิยม ซึ่งแสดงจุดใต้/ตะวันตกและเหนือ/ตะวันออกของสี่เหลี่ยมผืนผ้า โดยใช้รูปแบบต่อไปนี้rectangle:south,west|north,east โปรดทราบ ว่าค่าตะวันออก/ตะวันตกจะอยู่ในช่วง -180 ถึง 180 และ ค่าเหนือ/ใต้จะอยู่ในช่วง -90 ถึง 90

• ออฟเซ็ต

  ตำแหน่งในคำที่ป้อนของอักขระสุดท้ายที่บริการ ใช้เพื่อจับคู่คำที่คาดคะเน เช่น หากอินพุตคือ Google และออฟเซ็ตคือ 3 บริการจะจับคู่กับ Goo ระบบจะจับคู่สตริงที่กำหนดโดยออฟเซ็ตกับ คำแรกในคำที่ป้อนเท่านั้น เช่น หากคำที่ป้อนคือ Google abc และออฟเซ็ตคือ 3 บริการจะพยายามจับคู่กับ Goo abc หากไม่ได้ระบุออฟเซ็ต บริการ จะใช้ทั้งคำ โดยทั่วไปแล้ว ควรกำหนดออฟเซ็ตเป็นตำแหน่งของเคอร์เซอร์ข้อความ

• origin

  จุดต้นทางที่จะใช้คำนวณระยะทางแบบเส้นตรงไปยัง ปลายทาง (แสดงเป็น distance_meters) หากไม่ระบุค่านี้ ระบบจะไม่แสดงระยะทางแบบเส้นตรง ต้องระบุเป็น latitude,longitude

• รัศมี

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

  ระบบจะจำกัดรัศมีโดยอัตโนมัติให้มีค่าสูงสุดตามประเภทการค้นหาและพารามิเตอร์อื่นๆ

  • เติมข้อความอัตโนมัติ: 50,000 เมตร
  • การค้นหาในบริเวณใกล้เคียง
    • เมื่อใช้ keyword หรือ name: 50,000 เมตร
    • ไม่มี keyword หรือ name
      • สูงสุด 50,000 เมตร โดยปรับแบบไดนามิกตามความหนาแน่นของพื้นที่ โดยไม่ขึ้นอยู่กับพารามิเตอร์ rankby
      • เมื่อใช้ rankby=distance ระบบจะไม่ยอมรับพารามิเตอร์รัศมี และจะส่งผลให้เกิด INVALID_REQUEST
  • การเติมข้อความค้นหาอัตโนมัติ: 50,000 เมตร
  • การค้นหาข้อความ: 50,000 เมตร

• ภูมิภาค

  รหัสภูมิภาคที่ระบุเป็นค่าccTLD ("โดเมนระดับบนสุด") 2 อักขระ รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นที่สำคัญบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับ นิติบุคคล "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")

• sessiontoken

  สตริงแบบสุ่มที่ระบุเซสชันการเติมข้อความอัตโนมัติ เพื่อวัตถุประสงค์ในการเรียกเก็บเงิน

  เซสชันจะเริ่มต้นเมื่อผู้ใช้เริ่มพิมพ์คำค้นหา และสิ้นสุดเมื่อ ผู้ใช้เลือกสถานที่และมีการเรียกรายละเอียดสถานที่ แต่ละเซสชันสามารถ มีการค้นหาหลายรายการ ตามด้วยการเลือกสถานที่ 1 แห่ง คีย์ API ที่ใช้สำหรับคำขอแต่ละรายการภายในเซสชันต้องเป็นของโปรเจ็กต์คอนโซล Google Cloud เดียวกัน เมื่อเซสชันสิ้นสุดลง โทเค็นจะใช้ไม่ได้อีกต่อไป แอปของคุณต้องสร้างโทเค็นใหม่สำหรับแต่ละเซสชัน หากไม่ได้ระบุพารามิเตอร์ sessiontoken หรือหากคุณใช้โทเค็นของเซสชันซ้ำ ระบบจะเรียกเก็บเงินสำหรับเซสชันราวกับว่าไม่มีการระบุโทเค็นของเซสชัน (ระบบจะเรียกเก็บเงินสำหรับคำขอแต่ละรายการแยกกัน)

  เราขอแนะนำให้ปฏิบัติตามหลักเกณฑ์ต่อไปนี้

  • ใช้โทเค็นของเซสชันสำหรับเซสชันการเติมข้อความอัตโนมัติทั้งหมด
  • สร้างโทเค็นใหม่สำหรับแต่ละเซสชัน ขอแนะนำให้ใช้ UUID เวอร์ชัน 4
  • ตรวจสอบว่าคีย์ API ที่ใช้สำหรับคำขอ Place Autocomplete และรายละเอียดสถานที่ทั้งหมดภายในเซสชันเป็นของโปรเจ็กต์ Cloud Console เดียวกัน
  • อย่าลืมส่งโทเค็นของเซสชันที่ไม่ซ้ำกันสำหรับเซสชันใหม่แต่ละรายการ การใช้โทเค็นเดียวกันกับเซสชันมากกว่า 1 เซสชันจะทำให้ระบบเรียกเก็บเงินสำหรับคำขอแต่ละรายการแยกกัน

• strictbounds

  แสดงเฉพาะสถานที่ที่อยู่ภายในภูมิภาคที่กำหนดโดย location และ radius เท่านั้น นี่เป็นข้อจำกัด ไม่ใช่ความลำเอียง ซึ่งหมายความว่าระบบจะไม่แสดงผลการค้นหานอกภูมิภาคนี้ แม้ว่าจะตรงกับข้อมูลที่ผู้ใช้ป้อนก็ตาม

• ประเภท

  คุณสามารถจำกัดผลลัพธ์จากคำขอ Place Autocomplete ให้เป็นประเภทใดประเภทหนึ่งได้โดยส่งพารามิเตอร์ types พารามิเตอร์นี้ ระบุประเภทหรือคอลเล็กชันประเภท ตามที่ระบุไว้ใน ประเภทสถานที่ หากไม่ได้ระบุ ระบบจะแสดงผลทุกประเภท

  สถานที่หนึ่งๆ จะมีประเภทหลักได้เพียงประเภทเดียวจากประเภทที่แสดงในตารางที่ 1 หรือตารางที่ 2 ตัวอย่างเช่น โรงแรมที่มีบริการอาหารจะแสดงได้เฉพาะกับ types=lodging เท่านั้น และไม่แสดงกับ types=restaurant

  สำหรับค่าของพารามิเตอร์ types คุณสามารถระบุค่าใดค่าหนึ่งต่อไปนี้

  • ค่าสูงสุด 5 ค่าจาก ตารางที่ 1 หรือ ตารางที่ 2 หากมีหลายค่า ให้คั่นแต่ละค่าด้วย | (แถบแนวตั้ง) เช่น

    types=book_store|cafe

  • ตัวกรองที่รองรับรายการใดรายการหนึ่งในตารางที่ 3 คุณไม่สามารถผสมคอลเล็กชันประเภทต่างๆ ได้

  ระบบจะปฏิเสธคำขอพร้อมข้อผิดพลาด INVALID_REQUEST ในกรณีต่อไปนี้

  • ระบุประเภทมากกว่า 5 ประเภท
  • มีประเภทที่ไม่รู้จัก
  • ประเภทใดก็ตามจากตารางที่ 1 หรือตารางที่ 2 ผสมกับตัวกรองใดก็ตามในตารางที่ 3

ตัวอย่าง Place Autocomplete (เดิม)

คำขอสำหรับสถานประกอบการที่มีสตริง "Amoeba" ภายใน พื้นที่ที่อยู่ใจกลางซานฟรานซิสโก แคลิฟอร์เนีย

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=amoeba
      &types=establishment
      &location=37.76999%2C-122.44696
      &radius=500
      &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

คำขอเดียวกันซึ่งจำกัดผลการค้นหาให้อยู่ภายในระยะ 500 เมตรจาก Ashbury St & Haight St, San Francisco

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=amoeba
      &types=establishment
      &location=37.76999%2C-122.44696&radius=500
      &strictbounds=true
      &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&strictbounds=true&key=YOUR_API_KEY'

คำขอสำหรับที่อยู่ที่มีคำว่า "Vict" พร้อมผลลัพธ์เป็นภาษาฝรั่งเศส

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=Vict
      &types=geocode
      &language=fr
      &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=Vict&types=geocode&language=fr&key=YOUR_API_KEY'

คำขอสำหรับเมืองที่มี "Vict" พร้อมผลลัพธ์เป็นภาษาโปรตุเกสแบบบราซิล

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=Vict
      &types=(cities)
      &language=pt_BR&key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=Vict&types=(cities)&language=pt_BR&key=YOUR_API_KEY'

โปรดทราบว่าคุณจะต้องแทนที่คีย์ API ในตัวอย่างเหล่านี้ด้วยคีย์ของคุณเอง

การตอบกลับ Place Autocomplete (เดิม)

การตอบกลับ Place Autocomplete (เดิม) จะแสดงในรูปแบบที่ระบุโดย output แฟล็กภายในเส้นทาง URL ของคำขอ ผลลัพธ์ด้านล่าง บ่งบอกถึงสิ่งที่อาจแสดงสําหรับการค้นหาที่มีพารามิเตอร์ต่อไปนี้

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=Paris
      &types=geocode
      &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=Paris&types=geocode&key=YOUR_API_KEY'

{
  "predictions":
    [
      {
        "description": "Paris, France",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
        "reference": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "France",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "France" },
          ],
        "types": ["locality", "political", "geocode"],
      },
      {
        "description": "Paris, TX, USA",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJmysnFgZYSoYRSfPTL2YJuck",
        "reference": "ChIJmysnFgZYSoYRSfPTL2YJuck",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "TX, USA",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "TX" },
            { "offset": 11, "value": "USA" },
          ],
        "types": ["locality", "political", "geocode"],
      },
      {
        "description": "Paris, TN, USA",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJ4zHP-Sije4gRBDEsVxunOWg",
        "reference": "ChIJ4zHP-Sije4gRBDEsVxunOWg",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "TN, USA",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "TN" },
            { "offset": 11, "value": "USA" },
          ],
        "types": ["locality", "political", "geocode"],
      },
      {
        "description": "Paris, Brant, ON, Canada",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJsamfQbVtLIgR-X18G75Hyi0",
        "reference": "ChIJsamfQbVtLIgR-X18G75Hyi0",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "Brant, ON, Canada",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "Brant" },
            { "offset": 14, "value": "ON" },
            { "offset": 18, "value": "Canada" },
          ],
        "types": ["neighborhood", "political", "geocode"],
      },
      {
        "description": "Paris, KY, USA",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJsU7_xMfKQ4gReI89RJn0-RQ",
        "reference": "ChIJsU7_xMfKQ4gReI89RJn0-RQ",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "KY, USA",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "KY" },
            { "offset": 11, "value": "USA" },
          ],
        "types": ["locality", "political", "geocode"],
      },
    ],
  "status": "OK",
}

    
<?xml version="1.0" encoding="UTF-8"?>
<AutocompletionResponse>
 <status>OK</status>
 <prediction>
  <description>Paris, France</description>
  <type>locality</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJD7fiBh9u5kcRYJSMaMOCCwQ</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>France</value>
   <offset>7</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJD7fiBh9u5kcRYJSMaMOCCwQ</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>Paris, TX, USA</description>
  <type>locality</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJmysnFgZYSoYRSfPTL2YJuck</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>TX</value>
   <offset>7</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>11</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJmysnFgZYSoYRSfPTL2YJuck</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>TX, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>Paris, TN, USA</description>
  <type>locality</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJ4zHP-Sije4gRBDEsVxunOWg</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>TN</value>
   <offset>7</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>11</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJ4zHP-Sije4gRBDEsVxunOWg</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>TN, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>Paris, Brant, ON, Canada</description>
  <type>neighborhood</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJsamfQbVtLIgR-X18G75Hyi0</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>Brant</value>
   <offset>7</offset>
  </term>
  <term>
   <value>ON</value>
   <offset>14</offset>
  </term>
  <term>
   <value>Canada</value>
   <offset>18</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJsamfQbVtLIgR-X18G75Hyi0</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>Brant, ON, Canada</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>Paris, KY, USA</description>
  <type>locality</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJsU7_xMfKQ4gReI89RJn0-RQ</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>KY</value>
   <offset>7</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>11</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJsU7_xMfKQ4gReI89RJn0-RQ</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>KY, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
</AutocompletionResponse>

   

PlacesAutocompleteResponse

สิ่งที่น่าสนใจเป็นพิเศษในผลลัพธ์คือองค์ประกอบ place_id ซึ่งสามารถใช้เพื่อขอรายละเอียดที่เจาะจงมากขึ้นเกี่ยวกับสถานที่โดยใช้คำค้นหาแยกต่างหาก ดูคำขอรายละเอียดสถานที่ (เดิม)

การตอบกลับ XML ประกอบด้วยองค์ประกอบ <AutocompletionResponse> เดียวที่มีองค์ประกอบย่อย 2 ประเภท ดังนี้

• องค์ประกอบ <status> เดียวมีข้อมูลเมตาในคำขอ ดูรหัสสถานะด้านล่าง
• องค์ประกอบ <prediction> ตั้งแต่ 0 รายการขึ้นไป โดยแต่ละรายการมี ข้อมูลเกี่ยวกับสถานที่เดียว ดูข้อมูลเกี่ยวกับผลลัพธ์เหล่านี้ได้ที่ผลลัพธ์ของ Place Autocomplete (เดิม) Places API จะแสดงผลลัพธ์ได้สูงสุด 5 รายการ

เราขอแนะนำให้ใช้ json เป็นแฟล็กเอาต์พุตที่ต้องการ เว้นแต่แอปพลิเคชันของคุณจะต้องใช้ xml ด้วยเหตุผลบางประการ การประมวลผลทรี XML ต้องใช้ความระมัดระวังเพื่อให้คุณอ้างอิงโหนดและองค์ประกอบที่เหมาะสม ดูการประมวลผล XML ด้วย XPath เพื่อรับความช่วยเหลือในการประมวลผล XML

PlacesAutocompleteStatus

รหัสสถานะที่บริการส่งกลับ

• OK ซึ่งหมายความว่าคำขอ API สำเร็จ
• ZERO_RESULTS แสดงว่าการค้นหาสําเร็จ แต่ ไม่มีผลลัพธ์ ข้อผิดพลาดนี้อาจเกิดขึ้นหากการค้นหามีขอบเขตใน สถานที่ตั้งระยะไกล
• INVALID_REQUEST ซึ่งบ่งชี้ว่าคำขอ API มีรูปแบบไม่ถูกต้อง โดยทั่วไปเกิดจากไม่มีพารามิเตอร์ input
• OVER_QUERY_LIMIT ที่ระบุข้อมูลต่อไปนี้
  • คุณใช้ QPS เกินขีดจำกัดแล้ว
  • บัญชีของคุณไม่ได้เปิดใช้การเรียกเก็บเงิน
  • ใช้เครดิต $200 รายเดือนหรือโควต้าการใช้งานที่กำหนดเองเกินแล้ว
  • วิธีการชำระเงินที่ระบุใช้ไม่ได้อีกต่อไป (เช่น บัตรเครดิตหมดอายุ)
  ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีแก้ไขข้อผิดพลาดนี้ได้ที่ คำถามที่พบบ่อยเกี่ยวกับ Maps
• REQUEST_DENIED ซึ่งระบุว่าคำขอของคุณถูกปฏิเสธ โดยทั่วไปเนื่องจากสาเหตุต่อไปนี้
  • คำขอไม่มีคีย์ API
  • พารามิเตอร์ key ไม่ถูกต้อง
• UNKNOWN_ERROR ซึ่งบ่งบอกถึงข้อผิดพลาดที่ไม่รู้จัก

เมื่อบริการ Places แสดงผลลัพธ์ JSON จากการค้นหา ระบบจะวางผลลัพธ์เหล่านั้นไว้ ภายในpredictionsอาร์เรย์ แม้ว่าบริการจะไม่แสดงผลลัพธ์ (เช่น หาก location อยู่ระยะไกล) บริการก็จะยังแสดงอาร์เรย์ predictions ว่าง การตอบกลับ XML ประกอบด้วยองค์ประกอบ <prediction> ตั้งแต่ 0 รายการขึ้นไป

PlaceAutocompletePrediction

PlaceAutocompleteMatchedSubstring

PlaceAutocompleteStructuredFormat

PlaceAutocompleteTerm

การเพิ่มประสิทธิภาพ Place Autocomplete (เดิม)

ส่วนนี้อธิบายแนวทางปฏิบัติแนะนำที่จะช่วยให้คุณใช้ประโยชน์จากบริการ Place Autocomplete (เดิม) ได้อย่างเต็มที่

หลักเกณฑ์ทั่วไปมีดังนี้

• วิธีที่เร็วที่สุดในการพัฒนาอินเทอร์เฟซผู้ใช้ที่ใช้งานได้คือการใช้ Maps JavaScript API Place Autocomplete (เดิม) Places SDK สำหรับ Android Place Autocomplete (เดิม) หรือ Places SDK สำหรับ iOS ตัวควบคุม UI Place Autocomplete (เดิม)
• ทำความเข้าใจฟิลด์ข้อมูลที่สำคัญของ Place Autocomplete (เดิม) ตั้งแต่เริ่มต้น
• ฟิลด์การเอนเอียงตามสถานที่ตั้งและข้อจำกัดด้านสถานที่ตั้งเป็นฟิลด์ที่ไม่บังคับ แต่ อาจส่งผลต่อประสิทธิภาพการเติมข้อความอัตโนมัติอย่างมาก
• ใช้การจัดการข้อผิดพลาดเพื่อให้แน่ใจว่าแอปของคุณจะลดประสิทธิภาพลงอย่างราบรื่น หาก API แสดงข้อผิดพลาด
• ตรวจสอบว่าแอปของคุณจัดการกรณีที่ไม่มีการเลือกและเสนอวิธีให้ผู้ใช้ดำเนินการต่อ

แนวทางปฏิบัติแนะนำในการเพิ่มประสิทธิภาพต้นทุน

การเพิ่มประสิทธิภาพต้นทุนพื้นฐาน

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

การเพิ่มประสิทธิภาพต้นทุนขั้นสูง

พิจารณาการติดตั้งใช้งาน Place Autocomplete (เดิม) แบบเป็นโปรแกรมเพื่อเข้าถึง SKU: การเติมข้อความอัตโนมัติ - ราคาต่อคำขอ และขอผลลัพธ์ Geocoding API เกี่ยวกับสถานที่ที่เลือกแทนรายละเอียดสถานที่ (เดิม) การกำหนดราคาต่อคำขอที่ใช้ร่วมกับ Geocoding API จะคุ้มค่ากว่าการกำหนดราคาต่อเซสชัน (อิงตามเซสชัน) หากเป็นไปตามเงื่อนไขต่อไปนี้ทั้ง 2 ข้อ

• หากคุณต้องการเพียงละติจูดและลองจิจูดหรือที่อยู่ของสถานที่ที่ผู้ใช้เลือก Geocoding API จะให้ข้อมูลนี้ ในราคาที่ถูกกว่าการเรียก Place Details (เดิม)
• หากผู้ใช้เลือกการคาดคะเนการเติมข้อความอัตโนมัติภายในคำขอ Place Autocomplete (เดิม) โดยเฉลี่ย 4 รายการหรือน้อยกว่า การกำหนดราคาต่อคำขออาจคุ้มค่ากว่าการกำหนดราคาต่อเซสชัน

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

แนวทางปฏิบัติแนะนำด้านประสิทธิภาพ

หลักเกณฑ์ต่อไปนี้อธิบายวิธีเพิ่มประสิทธิภาพ Place Autocomplete (เดิม)

• เพิ่มข้อจำกัดในแต่ละประเทศ การเอนเอียงตำแหน่ง และ (สำหรับการติดตั้งใช้งานแบบเป็นโปรแกรม) ค่ากำหนดภาษาลงในการติดตั้งใช้งาน Place Autocomplete (เดิม) ไม่จำเป็นต้องใช้ค่ากำหนดภาษาสำหรับวิดเจ็ต เนื่องจากวิดเจ็ตจะเลือกค่ากำหนดภาษาจากเบราว์เซอร์หรืออุปกรณ์เคลื่อนที่ของผู้ใช้
• หาก Place Autocomplete (เดิม) มาพร้อมกับแผนที่ คุณสามารถกำหนดตำแหน่งตามวิวพอร์ตของแผนที่ได้
• ในกรณีที่ผู้ใช้ไม่เลือกการคาดคะเนจาก Place Autocomplete (เดิม) โดยทั่วไป เนื่องจากการคาดคะเนเหล่านั้นไม่ใช่ที่อยู่ผลลัพธ์ที่ต้องการ คุณสามารถนำข้อมูลจากผู้ใช้ที่ป้อนไว้เดิมมาใช้ซ้ำเพื่อพยายามรับผลลัพธ์ที่เกี่ยวข้องมากขึ้นได้โดยทำดังนี้
  • หากคาดหวังให้ผู้ใช้ป้อนเฉพาะข้อมูลที่อยู่ ให้นำข้อมูลที่ผู้ใช้ป้อนเดิมมาใช้ซ้ำ ในการเรียก Geocoding API
  • หากคาดว่าผู้ใช้จะป้อนคำค้นหาสถานที่ที่เฉพาะเจาะจงตามชื่อหรือที่อยู่ ให้ใช้คำขอรายละเอียดสถานที่ (เดิม) หากคาดหวังผลลัพธ์ในภูมิภาคที่เฉพาะเจาะจงเท่านั้น ให้ใช้การเอนเอียงตามตำแหน่ง
  สถานการณ์อื่นๆ ที่ควรเปลี่ยนไปใช้ Geocoding API ได้แก่
  • ผู้ใช้ป้อนที่อยู่ย่อย เช่น ที่อยู่ของยูนิตหรืออพาร์ตเมนต์ที่เฉพาะเจาะจงภายในอาคาร ตัวอย่างเช่น ที่อยู่ "Stroupežnického 3191/17, Praha" ในเช็ก จะให้การคาดคะเนบางส่วนในการเติมข้อความอัตโนมัติของสถานที่ (เดิม)
  • ผู้ใช้ที่ป้อนที่อยู่ที่มีคำนำหน้าส่วนของถนน เช่น "23-30 29th St, Queens" ใน นิวยอร์กซิตี้ หรือ "47-380 Kamehameha Hwy, Kaneohe" บนเกาะคาไวในฮาวาย

การให้น้ำหนักพิเศษกับบางตำแหน่ง

เอนเอียงผลลัพธ์ไปยังพื้นที่ที่ระบุโดยส่งพารามิเตอร์ location และพารามิเตอร์ radius ซึ่งจะสั่งให้ Place Autocomplete (เดิม) แสดงผลลัพธ์ภายในพื้นที่ที่กำหนด ระบบอาจยังแสดงผลลัพธ์ที่อยู่นอกพื้นที่ที่กำหนด คุณสามารถใช้พารามิเตอร์ includedRegionCodes เพื่อกรองผลลัพธ์ให้แสดงเฉพาะสถานที่ภายในประเทศที่ระบุได้

การจำกัดตำแหน่ง

จำกัดผลการค้นหาให้อยู่ในพื้นที่ที่ระบุโดยส่งพารามิเตอร์ locationRestriction

นอกจากนี้ คุณยังจำกัดผลการค้นหาให้อยู่ในภูมิภาคที่กำหนดโดย location และพารามิเตอร์ radius ได้ด้วยการเพิ่มพารามิเตอร์ strictbounds ซึ่งจะสั่งให้ Place Autocomplete (เดิม) แสดงผลลัพธ์เฉพาะ ภายในภูมิภาคนั้น