Places Service

PlacesService class

google.maps.places.PlacesService ชั้นเรียน

มีเมธอดที่เกี่ยวข้องกับการค้นหาสถานที่และการดึงรายละเอียดเกี่ยวกับสถานที่

เข้าถึงได้โดยโทรไปที่ const {PlacesService} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

PlacesService
PlacesService(attrContainer)
พารามิเตอร์: 
สร้างอินสแตนซ์ใหม่ของ PlacesService ที่แสดงผลการระบุแหล่งที่มาในคอนเทนเนอร์ที่ระบุ
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
พารามิเตอร์: 
ค่าที่ส่งคืน: ไม่มี
ดึงข้อมูลรายการสถานที่ตามหมายเลขโทรศัพท์ ในกรณีส่วนใหญ่ ควรมีรายการเพียงรายการเดียวในรายการผลลัพธ์ แต่หากคำขอไม่ชัดเจน ระบบอาจแสดงผลลัพธ์มากกว่า 1 รายการ PlaceResult ที่ส่งไปยังการเรียกกลับเป็นชุดย่อยของ PlaceResult แบบเต็ม แอปจะได้รับ PlaceResult ที่ละเอียดยิ่งขึ้นสำหรับแต่ละสถานที่โดยการเรียกใช้ PlacesService.getDetails และส่ง PlaceResult.place_id สำหรับสถานที่ที่ต้องการ
findPlaceFromQuery
findPlaceFromQuery(request, callback)
พารามิเตอร์: 
ค่าที่ส่งคืน: ไม่มี
ดึงข้อมูลรายการสถานที่ตามสตริงการค้นหา ในกรณีส่วนใหญ่ ควรมีรายการเพียงรายการเดียวในรายการผลลัพธ์ แต่หากคำขอไม่ชัดเจน ระบบอาจแสดงผลลัพธ์มากกว่า 1 รายการ PlaceResult ที่ส่งไปยังการเรียกกลับเป็นชุดย่อยของ PlaceResult แบบเต็ม แอปจะได้รับ PlaceResult ที่ละเอียดยิ่งขึ้นสำหรับแต่ละสถานที่โดยการเรียกใช้ PlacesService.getDetails และส่ง PlaceResult.place_id สำหรับสถานที่ที่ต้องการ
getDetails
getDetails(request, callback)
พารามิเตอร์: 
ค่าที่ส่งคืน: ไม่มี
เรียกข้อมูลรายละเอียดเกี่ยวกับสถานที่ที่ระบุโดย placeId ที่ระบุ
nearbySearch
nearbySearch(request, callback)
พารามิเตอร์: 
ค่าที่ส่งคืน: ไม่มี
ดึงข้อมูลรายการสถานที่ใกล้กับสถานที่ตั้งหนึ่งๆ โดยอิงตามคีย์เวิร์ดหรือประเภท ต้องระบุสถานที่เสมอ ไม่ว่าจะโดยการส่งพารามิเตอร์ LatLngBounds หรือ location และ radius PlaceResult ที่ส่งไปยังการเรียกกลับเป็นส่วนย่อยของ PlaceResult แบบเต็ม แอปของคุณจะได้รับ PlaceResult ที่ละเอียดยิ่งขึ้นสำหรับแต่ละสถานที่โดยการส่งคำขอรายละเอียดสถานที่ที่ส่ง PlaceResult.place_id สำหรับสถานที่ที่ต้องการ ออบเจ็กต์ PlaceSearchPagination สามารถใช้เพื่อดึงข้อมูลผลลัพธ์ในหน้าอื่นๆ (เป็น Null หากเป็นหน้าผลลัพธ์สุดท้ายหรือมีผลลัพธ์เพียงหน้าเดียว)
textSearch
textSearch(request, callback)
พารามิเตอร์: 
ค่าที่ส่งคืน: ไม่มี
ดึงข้อมูลรายการสถานที่ตามสตริงการค้นหา (เช่น "พิซซ่าในนิวยอร์ก" หรือ "ร้านรองเท้าใกล้ออตตาวา") พารามิเตอร์ตำแหน่งเป็นพารามิเตอร์ที่ไม่บังคับ เมื่อระบุตำแหน่ง ผลลัพธ์จะเอนเอียงไปทางผลลัพธ์ที่อยู่ใกล้เคียงเท่านั้น ไม่ได้จำกัดเฉพาะสถานที่ภายในพื้นที่ ใช้ textSearch เมื่อต้องการค้นหาสถานที่โดยใช้สตริงที่กำหนดเอง และในกรณีที่คุณอาจไม่ต้องการจำกัดผลการค้นหาเฉพาะสถานที่ใดที่หนึ่ง ออบเจ็กต์ PlaceSearchPagination สามารถใช้เพื่อดึงข้อมูลผลลัพธ์ในหน้าอื่นๆ (เป็น Null หากเป็นหน้าผลลัพธ์สุดท้ายหรือมีผลลัพธ์เพียงหน้าเดียว)

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

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

คำค้นหารายละเอียดสถานที่ที่จะส่งไปยัง PlacesService

placeId
ประเภท:  string
รหัสสถานที่ของสถานที่ที่ขอรายละเอียด
fields optional
ประเภท:  Array<string> optional
ฟิลด์ที่จะรวมไว้ในการตอบกลับแบบละเอียด ซึ่งจะมีการเรียกเก็บเงิน หากไม่ได้ระบุฟิลด์หรือส่ง ['ALL'] ระบบจะแสดงผลและเรียกเก็บเงินสำหรับฟิลด์ที่มีอยู่ทั้งหมด (ไม่แนะนำสำหรับการติดตั้งใช้งานจริง) ดูรายการช่องได้ที่ PlaceResult ระบุช่องที่ซ้อนกันได้ด้วยเส้นทางแบบจุด (เช่น "geometry.location")
language optional
ประเภท:  string optional
ตัวระบุภาษาสำหรับภาษาที่ควรแสดงรายละเอียด ดูรายการภาษาที่รองรับ
region optional
ประเภท:  string optional
รหัสภูมิภาคของภูมิภาคของผู้ใช้ ซึ่งอาจส่งผลต่อรูปภาพที่ระบบแสดงและอาจส่งผลต่อสิ่งอื่นๆ ด้วย รหัสภูมิภาคยอมรับค่า ccTLD ("โดเมนระดับบนสุด") ที่มีอักขระ 2 ตัว รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 แต่ก็มีข้อยกเว้นที่สำคัญบางประการ เช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับนิติบุคคล "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
sessionToken optional
ประเภท:  AutocompleteSessionToken optional
ข้อมูลอ้างอิงที่ไม่ซ้ำกันซึ่งใช้เพื่อรวมคำขอรายละเอียดกับเซสชันการเติมข้อความอัตโนมัติ

FindPlaceFromPhoneNumberRequest interface

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

คำขอค้นหาสถานที่จากข้อความที่จะส่งไปยัง PlacesService.findPlaceFromPhoneNumber