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
fields
ประเภท:  Array<string>
ฟิลด์ที่จะรวมไว้ในการตอบกลับ ซึ่งจะมีการเรียกเก็บเงิน หากส่ง ['ALL'] ระบบจะแสดงผลและเรียกเก็บเงินสำหรับช่องที่มีอยู่ทั้งหมด (ไม่แนะนำสำหรับการติดตั้งใช้งานจริง) ดูรายการช่องได้ที่ PlaceResult ระบุช่องที่ซ้อนกันได้ด้วยเส้นทางแบบจุด (เช่น "geometry.location")
phoneNumber
ประเภท:  string
หมายเลขโทรศัพท์ของสถานที่ที่ต้องการค้นหา รูปแบบต้องเป็น E.164
language optional
ประเภท:  string optional
ตัวระบุภาษาสำหรับภาษาที่ควรส่งคืนชื่อและที่อยู่ หากเป็นไปได้ ดูรายการภาษาที่รองรับ
locationBias optional
ประเภท:  LocationBias optional
อคติที่ใช้เมื่อค้นหาสถานที่ ผลลัพธ์จะเอนเอียงไปทาง LocationBias ที่ระบุ แต่จะไม่จำกัดอยู่เพียงเท่านั้น

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

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

คำขอค้นหาสถานที่จากข้อความที่จะส่งไปยัง PlacesService.findPlaceFromQuery
fields
ประเภท:  Array<string>
ฟิลด์ที่จะรวมไว้ในการตอบกลับ ซึ่งจะมีการเรียกเก็บเงิน หากส่ง ['ALL'] ระบบจะแสดงผลและเรียกเก็บเงินสำหรับช่องที่มีอยู่ทั้งหมด (ไม่แนะนำสำหรับการติดตั้งใช้งานจริง) ดูรายการช่องได้ที่ PlaceResult ระบุช่องที่ซ้อนกันได้ด้วยเส้นทางแบบจุด (เช่น "geometry.location")
query
ประเภท:  string
คำค้นหาของคำขอ เช่น ชื่อหรือที่อยู่ของสถานที่
language optional
ประเภท:  string optional
ตัวระบุภาษาสำหรับภาษาที่ควรส่งคืนชื่อและที่อยู่ หากเป็นไปได้ ดูรายการภาษาที่รองรับ
locationBias optional
ประเภท:  LocationBias optional
อคติที่ใช้เมื่อค้นหาสถานที่ ผลลัพธ์จะเอนเอียงไปทาง LocationBias ที่ระบุ แต่จะไม่จำกัดอยู่เพียงเท่านั้น

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

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

คำค้นหาเกี่ยวกับสถานที่ที่จะส่งไปยัง PlacesService
bounds optional
ประเภท:  LatLngBounds|LatLngBoundsLiteral optional
ขอบเขตที่จะค้นหาสถานที่ ระบบจะไม่สนใจทั้ง location และ radius หากตั้งค่า bounds
keyword optional
ประเภท:  string optional
คำที่จะใช้จับคู่กับช่องที่มีอยู่ทั้งหมด ซึ่งรวมถึงแต่ไม่จำกัดเพียงชื่อ ประเภท และที่อยู่ รวมถึงรีวิวจากลูกค้าและเนื้อหาอื่นๆ ของบุคคลที่สาม
language optional
ประเภท:  string optional
ตัวระบุภาษาสำหรับภาษาที่ควรส่งคืนชื่อและที่อยู่ หากเป็นไปได้ ดูรายการภาษาที่รองรับ
location optional
ประเภท:  LatLng|LatLngLiteral optional
ตำแหน่งที่จะค้นหาสถานที่
maxPriceLevel optional
ประเภท:  number optional
จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ที่มีระดับราคาตามที่ระบุหรือต่ำกว่า ค่าที่ใช้ได้อยู่ในช่วงตั้งแต่ 0 (ราคาถูกที่สุด) ถึง 4 (แพงที่สุด) ต้องมากกว่าหรือเท่ากับ minPrice หากมีการระบุ
minPriceLevel optional
ประเภท:  number optional
จำกัดผลการค้นหาให้แสดงเฉพาะสถานที่ที่มีระดับราคาตามที่ระบุหรือสูงกว่า ค่าที่ใช้ได้อยู่ในช่วงตั้งแต่ 0 (ราคาถูกที่สุด) ถึง 4 (แพงที่สุด) ต้องน้อยกว่าหรือเท่ากับ maxPrice หากมีการระบุ
name optional
ประเภท:  string optional
เทียบเท่ากับ keyword ระบบจะรวมค่าในช่องนี้กับค่าในช่อง keyword และส่งเป็นส่วนหนึ่งของสตริงการค้นหาเดียวกัน
openNow optional
ประเภท:  boolean optional
จำกัดผลการค้นหาเฉพาะสถานที่ที่เปิดอยู่ตอนนี้
radius optional
ประเภท:  number optional
ระยะทางจากตำแหน่งที่ระบุซึ่งใช้ค้นหาสถานที่ หน่วยเป็นเมตร ค่าสูงสุดที่อนุญาตคือ 50,000
rankBy optional
ประเภท:  RankBy optional
ค่าเริ่มต้น: RankBy.PROMINENCE
ระบุวิธีการจัดอันดับที่จะใช้เมื่อแสดงผลลัพธ์ โปรดทราบว่าเมื่อตั้งค่า rankBy เป็น DISTANCE คุณต้องระบุ location แต่จะระบุ radius หรือ bounds ไม่ได้
type optional
ประเภท:  string optional
ค้นหาสถานที่ประเภทที่ระบุ ระบบจะแปลประเภทเป็นภาษาท้องถิ่นของสถานที่ตั้งเป้าหมายของคำขอและใช้เป็นสตริงการค้นหา หากมีการระบุคำค้นหาด้วย ระบบจะต่อคำค้นหากับสตริงประเภทที่แปลแล้ว ระบบจะทิ้งผลลัพธ์ประเภทอื่นออกจากคำตอบ ใช้ช่องนี้เพื่อทำการค้นหาตามหมวดหมู่โดยไม่ขึ้นอยู่กับภาษาและภูมิภาค ดูประเภทที่ใช้ได้ที่นี่

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

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

คำขอค้นหาข้อความที่จะส่งไปยัง PlacesService
bounds optional
ประเภท:  LatLngBounds|LatLngBoundsLiteral optional
ขอบเขตที่ใช้เพื่อเอนเอียงผลลัพธ์เมื่อค้นหาสถานที่ (ไม่บังคับ) ระบบจะไม่สนใจทั้ง location และ radius หากตั้งค่า bounds ผลการค้นหาจะไม่จำกัดเฉพาะผลการค้นหาที่อยู่ภายในขอบเขตเหล่านี้ แต่ผลการค้นหาที่อยู่ภายในขอบเขตจะได้รับการจัดอันดับสูงกว่า