Autocomplete Data (new)

AutocompleteRequest อินเทอร์เฟซ

google.maps.places.AutocompleteRequest อินเทอร์เฟซ

อินเทอร์เฟซคำขอสำหรับ AutocompleteSuggestion.fetchAutocompleteSuggestions
input
ประเภท:  string
สตริงข้อความที่จะค้นหา
includedPrimaryTypes optional
ประเภท:  Array<string> optional
ประเภทสถานที่หลักที่รวมอยู่ด้วย (เช่น "restaurant" หรือ "gas_station")

ระบบจะแสดงสถานที่ก็ต่อเมื่อประเภทหลักของสถานที่นั้นอยู่ในรายการนี้ โดยระบุได้สูงสุด 5 ค่า หากไม่ได้ระบุประเภท ระบบจะแสดงสถานที่ทุกประเภท
includedRegionCodes optional
ประเภท:  Array<string> optional
รวมเฉพาะผลการค้นหาในภูมิภาคที่ระบุ ซึ่งระบุเป็นรหัสภูมิภาค CLDR 2 อักขระได้สูงสุด 15 รหัส ชุดว่างจะไม่จํากัดผลลัพธ์ หากตั้งค่าทั้ง locationRestriction และ includedRegionCodes ไว้ ผลลัพธ์จะอยู่ในบริเวณที่ตัดกัน
inputOffset optional
ประเภท:  number optional
ออฟเซตอักขระ Unicode แบบนับจากศูนย์ของ input ที่ระบุตำแหน่งเคอร์เซอร์ใน input ตำแหน่งเคอร์เซอร์อาจส่งผลต่อผลการคาดการณ์ที่แสดง หากไม่ได้ระบุไว้ ค่าเริ่มต้นจะเป็นความยาว input
language optional
ประเภท:  string optional
ภาษาที่จะแสดงผลลัพธ์ ระบบจะตั้งค่าเริ่มต้นตามค่ากำหนดภาษาของเบราว์เซอร์ ผลการค้นหาอาจมีทั้งภาษาไทยและอังกฤษหากภาษาที่ใช้ใน input แตกต่างจาก language หรือหากสถานที่ที่แสดงไม่มีคำแปลจากภาษาท้องถิ่นเป็น language
locationBias optional
ประเภท:  LocationBias optional
ปรับผลลัพธ์ให้เหมาะกับสถานที่ที่ระบุ

ควรตั้งค่า locationBias หรือ locationRestriction ไม่เกิน 1 รายการ หากไม่ได้ตั้งค่าใดเลย ผลลัพธ์จะมีความลำเอียงตามที่อยู่ IP ซึ่งหมายความว่าระบบจะแมปที่อยู่ IP กับตำแหน่งที่ไม่แม่นยำและใช้เป็นสัญญาณที่มีอคติ
locationRestriction optional
ประเภท:  LocationRestriction optional
จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ที่ระบุ

ควรตั้งค่า locationBias หรือ locationRestriction ไม่เกิน 1 รายการ หากไม่ได้ตั้งค่าใดเลย ผลลัพธ์จะมีความลำเอียงตามที่อยู่ IP ซึ่งหมายความว่าระบบจะแมปที่อยู่ IP กับตำแหน่งที่ไม่แม่นยำและใช้เป็นสัญญาณที่มีอคติ
origin optional
ประเภท:  LatLng|LatLngLiteral optional
จุดเริ่มต้นที่จะคำนวณระยะทางเชิงเรขาคณิตไปยังปลายทาง (แสดงผลเป็น PlacePrediction.distanceMeters) หากละเว้นค่านี้ ระบบจะไม่แสดงผลระยะทางเชิงเรขาคณิต
region optional
ประเภท:  string optional
รหัสภูมิภาคที่ระบุเป็นรหัสภูมิภาค 2 อักขระ CLDR ซึ่งส่งผลต่อการจัดรูปแบบที่อยู่ การจัดอันดับผลการค้นหา และอาจส่งผลต่อผลการค้นหาที่แสดง ซึ่งจะไม่จำกัดผลการค้นหาให้แสดงเฉพาะในภูมิภาคที่ระบุ
sessionToken optional
ประเภท:  AutocompleteSessionToken optional
โทเค็นที่ระบุเซสชันการเติมข้อความอัตโนมัติเพื่อวัตถุประสงค์ในการเรียกเก็บเงิน สร้างโทเค็นเซสชันใหม่ผ่าน AutocompleteSessionToken

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

เราขอแนะนำให้ทำตามหลักเกณฑ์ต่อไปนี้
  • ใช้โทเค็นเซสชันสำหรับการเรียกใช้ฟีเจอร์ป้อนข้อความอัตโนมัติของสถานที่ทั้งหมด
  • สร้างโทเค็นใหม่สำหรับเซสชันแต่ละรายการ
  • อย่าลืมส่งโทเค็นเซสชันที่ไม่ซ้ำกันสำหรับเซสชันใหม่แต่ละรายการ การใช้โทเค็นเดียวกันในเซสชันมากกว่า 1 รายการจะทำให้มีการเรียกเก็บเงินสำหรับคำขอแต่ละรายการแยกกัน

AutocompleteSessionToken class

google.maps.places.AutocompleteSessionToken class

แสดงโทเค็นเซสชันที่ใช้ติดตามเซสชันการเติมข้อความอัตโนมัติ

เข้าถึงโดยการโทรหา const {AutocompleteSessionToken} = await google.maps.importLibrary("places") โปรดดูไลบรารีใน Maps JavaScript API
AutocompleteSessionToken
AutocompleteSessionToken()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ AutocompleteSessionToken

AutocompleteSuggestion class

google.maps.places.AutocompleteSuggestion class

ผลการค้นหาของคำแนะนำที่เติมข้อความอัตโนมัติ

เข้าถึงโดยการโทรหา const {AutocompleteSuggestion} = await google.maps.importLibrary("places") โปรดดูไลบรารีใน Maps JavaScript API
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
พารามิเตอร์: 
ผลลัพธ์:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
ดึงข้อมูลรายการ AutocompleteSuggestions
placePrediction
ประเภท:  PlacePrediction optional
มีชื่อที่มนุษย์อ่านได้สำหรับผลลัพธ์ที่แสดง สำหรับผลการค้นหาสถานที่ตั้ง ข้อมูลนี้มักจะเป็นชื่อและที่อยู่ของธุรกิจ

PlacePrediction class

google.maps.places.PlacePrediction class

ผลการคาดการณ์สําหรับการคาดคะเนการเติมข้อความอัตโนมัติของสถานที่

เข้าถึงโดยการโทรหา const {PlacePrediction} = await google.maps.importLibrary("places") โปรดดูไลบรารีใน Maps JavaScript API
distanceMeters
ประเภท:  number optional
ความยาวของเส้น geodesic เป็นเมตรจาก origin หากมีการระบุ origin
mainText
ประเภท:  FormattableText optional
แสดงชื่อของสถานที่
placeId
ประเภท:  string
ตัวระบุที่ไม่ซ้ำกันของสถานที่ที่แนะนำ ตัวระบุนี้ใช้ได้ใน API อื่นๆ ที่ยอมรับรหัสสถานที่
secondaryText
ประเภท:  FormattableText optional
แสดงสถานที่เพิ่มเติมที่จะช่วยคลายความกำกวม (เช่น เมืองหรือภูมิภาค) เพื่อระบุสถานที่เพิ่มเติม
text
ประเภท:  FormattableText
มีชื่อที่มนุษย์อ่านได้สำหรับผลลัพธ์ที่แสดง สำหรับผลการค้นหาสถานที่ตั้ง ข้อมูลนี้มักจะเป็นชื่อและที่อยู่ของธุรกิจ เราขอแนะนำให้นักพัฒนาแอปที่ต้องการแสดงองค์ประกอบ UI รายการเดียวใช้

text นักพัฒนาแอปที่ต้องการแสดงองค์ประกอบ UI 2 รายการแยกกันแต่มีความเกี่ยวข้องกันอาจต้องใช้ PlacePrediction.mainText และ PlacePrediction.secondaryText แทน
types
ประเภท:  Array<string>
รายการประเภทที่ใช้กับสถานที่นี้จากตาราง ก หรือตาราง ข ใน https://developers.google.com/maps/documentation/places/web-service/place-types
toPlace
toPlace()
พารามิเตอร์: ไม่มี
ผลลัพธ์:  Place
แสดงผลสถานที่ของ PlacePrediction นี้ คุณต้องโทรหา Place.fetchFields อีกครั้งเพื่อรับรายละเอียดสถานที่อย่างเต็มรูปแบบ

คลาส StringRange

google.maps.places.StringRange class

ระบุสตริงย่อยภายในข้อความที่ระบุ

เข้าถึงโดยการโทรหา const {StringRange} = await google.maps.importLibrary("places") โปรดดูไลบรารีใน Maps JavaScript API
endOffset
ประเภท:  number
ส่วนเพิ่มที่อิงจาก 0 ของอักขระ Unicode ตัวสุดท้ายของสตริงย่อย (ไม่รวม)
startOffset
ประเภท:  number
ส่วนเพิ่มแบบนับจาก 0 ของอักขระ Unicode ตัวแรกของสตริงย่อย (รวม)

คลาส FormattableText

google.maps.places.FormattableText class

ข้อความที่แสดงการคาดคะเนสถานที่ โดยอาจใช้ข้อความตามที่เป็นอยู่หรือจัดรูปแบบก็ได้

เข้าถึงโดยการโทรหา const {FormattableText} = await google.maps.importLibrary("places") โปรดดูไลบรารีใน Maps JavaScript API
matches
ประเภท:  Array<StringRange>
รายการช่วงสตริงที่ระบุตําแหน่งที่คำขออินพุตตรงกันใน FormattableText.text คุณสามารถใช้ช่วงเพื่อจัดรูปแบบบางส่วนของ text ได้ สตริงย่อยอาจไม่ตรงกันทุกประการกับ AutocompleteRequest.input หากการจับคู่นั้นพิจารณาจากเกณฑ์อื่นที่ไม่ใช่การจับคู่สตริง (เช่น การแก้ไขตัวสะกดหรือการถอดเสียง) ค่าเหล่านี้คือออฟเซตอักขระ Unicode ของ FormattableText.text ระบบจะจัดเรียงช่วงตามค่าออฟเซ็ตที่เพิ่มขึ้น
text
ประเภท:  string
ข้อความที่อาจใช้ตามที่เป็นอยู่หรือจัดรูปแบบด้วย FormattableText.matches