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 ผลการค้นหาจะไม่จำกัดเฉพาะผลการค้นหาที่อยู่ภายในขอบเขตเหล่านี้ แต่ผลการค้นหาที่อยู่ภายในขอบเขตจะได้รับการจัดอันดับสูงกว่า
language optional
ประเภท:  string optional
ตัวระบุภาษาสำหรับภาษาที่ควรส่งคืนชื่อและที่อยู่ หากเป็นไปได้ ดูรายการภาษาที่รองรับ
location optional
ประเภท:  LatLng|LatLngLiteral optional
จุดกึ่งกลางของพื้นที่ที่ใช้เพื่อปรับผลการค้นหาเมื่อค้นหาสถานที่
query optional
ประเภท:  string optional
คำค้นหาของคำขอ เช่น ชื่อสถานที่ ("หอไอเฟล") หมวดหมู่ตามด้วยชื่อสถานที่ ("พิซซ่าในนิวยอร์ก") หรือชื่อสถานที่ตามด้วยตัวระบุสถานที่ ("Starbucks ในซิดนีย์")
radius optional
ประเภท:  number optional
รัศมีของพื้นที่ที่ใช้เพื่อเอนเอียงผลการค้นหาเมื่อค้นหาสถานที่ หน่วยเป็นเมตร
region optional
ประเภท:  string optional
รหัสภูมิภาคเพื่อกำหนดค่าผลลัพธ์ รหัสภูมิภาคยอมรับค่า ccTLD ("โดเมนระดับบนสุด") ที่มีอักขระ 2 ตัว รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 แต่ก็มีข้อยกเว้นที่สำคัญบางประการ เช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับนิติบุคคล "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
type optional
ประเภท:  string optional
ค้นหาสถานที่ประเภทที่ระบุ ระบบจะแปลประเภทเป็นภาษาท้องถิ่นของสถานที่ตั้งเป้าหมายของคำขอและใช้เป็นสตริงการค้นหา หากมีการระบุคำค้นหาด้วย ระบบจะต่อคำค้นหากับสตริงประเภทที่แปลแล้ว ระบบจะทิ้งผลลัพธ์ประเภทอื่นออกจากคำตอบ ใช้ช่องนี้เพื่อทำการค้นหาตามหมวดหมู่โดยไม่ขึ้นอยู่กับภาษาและภูมิภาค ดูประเภทที่ใช้ได้ที่นี่

RankBy ค่าคงที่

google.maps.places.RankBy ค่าคงที่

ตัวเลือกการจัดอันดับสำหรับ PlaceSearchRequest

เข้าถึงได้โดยโทรไปที่ const {RankBy} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API
DISTANCE จัดอันดับผลการค้นหาสถานที่ตามระยะทางจากตำแหน่ง
PROMINENCE จัดอันดับผลการค้นหาสถานที่ตามความโดดเด่น

LocationBias typedef

google.maps.places.LocationBias typedef

LocationBias แสดงถึงขอบเขตหรือคำแนะนำแบบคร่าวๆ ที่จะใช้เมื่อค้นหาสถานที่ ผลการค้นหาอาจมาจากภายนอกพื้นที่ที่ระบุ หากต้องการใช้ที่อยู่ IP ของผู้ใช้ปัจจุบันเป็นอคติ ให้ระบุสตริง "IP_BIAS" หมายเหตุ: หากใช้ Circle คุณต้องกำหนดศูนย์กลางและรัศมี

LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

LocationRestriction แสดงขอบเขตที่แน่นอนที่จะใช้เมื่อค้นหาสถานที่

LatLngBounds|LatLngBoundsLiteral

PlacesServiceStatus ค่าคงที่

google.maps.places.PlacesServiceStatus ค่าคงที่

สถานะที่ PlacesService แสดงเมื่อการค้นหาเสร็จสมบูรณ์ ระบุค่าเหล่านี้ตามค่าหรือโดยใช้ชื่อของค่าคงที่ เช่น 'OK' หรือ google.maps.places.PlacesServiceStatus.OK

เข้าถึงได้โดยโทรไปที่ const {PlacesServiceStatus} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API
INVALID_REQUEST คำขอนี้ไม่ถูกต้อง
NOT_FOUND ไม่พบสถานที่ที่อ้างอิง
OK การตอบกลับมีผลลัพธ์ที่ถูกต้อง
OVER_QUERY_LIMIT แอปพลิเคชันใช้โควต้าคำขอเกินขีดจำกัดแล้ว
REQUEST_DENIED แอปพลิเคชันไม่ได้รับอนุญาตให้ใช้ PlacesService
UNKNOWN_ERROR ประมวลผลคำขอ PlacesService ไม่ได้เนื่องจากเซิร์ฟเวอร์เกิดข้อผิดพลาด คำขออาจสำเร็จหากคุณลองอีกครั้ง
ZERO_RESULTS ไม่พบผลลัพธ์สำหรับคำขอนี้

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

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

ออบเจ็กต์ที่ใช้เพื่อดึงข้อมูลหน้าผลลัพธ์ของสถานที่เพิ่มเติม
hasNextPage
ประเภท:  boolean
ระบุว่ามีผลลัพธ์เพิ่มเติมหรือไม่ true เมื่อมีหน้าผลการค้นหาเพิ่มเติม
nextPage
nextPage()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  void
ดึงข้อมูลผลการค้นหาหน้าถัดไป ใช้ฟังก์ชันเรียกกลับเดียวกันกับที่ระบุไว้ในคำขอค้นหาแรก

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

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

กำหนดข้อมูลเกี่ยวกับสถานที่
address_components optional
ประเภท:  Array<GeocoderAddressComponent> optional
ชุดคอมโพเนนต์ที่อยู่สำหรับสถานที่ตั้งของสถานที่นี้ ใช้ได้กับ PlacesService.getDetails เท่านั้น
adr_address optional
ประเภท:  string optional
การแสดงที่อยู่ของสถานที่ในรูปแบบขนาดเล็ก adr ใช้ได้กับ PlacesService.getDetails เท่านั้น
aspects optional
ประเภท:  Array<PlaceAspectRating> optional
ลักษณะของสถานที่นี้ที่ได้รับการจัดอันดับโดยอิงตามรีวิวของผู้ใช้ Google และ Zagat คะแนนจะอยู่ในช่วง 0-30
business_status optional
ประเภท:  BusinessStatus optional
แฟล็กที่ระบุสถานะการดำเนินงานของสถานที่ หากเป็นธุรกิจ (ระบุว่าสถานที่เปิดทำการหรือปิดทำการชั่วคราวหรือถาวร) หากไม่มีข้อมูล ธงจะไม่ปรากฏในการค้นหาหรือการตอบกลับรายละเอียด
formatted_address optional
ประเภท:  string optional
ที่อยู่แบบเต็มของสถานที่
formatted_phone_number optional
ประเภท:  string optional
หมายเลขโทรศัพท์ของสถานที่ ซึ่งจัดรูปแบบตาม รูปแบบของหมายเลขในภูมิภาค ใช้ได้กับ PlacesService.getDetails เท่านั้น
geometry optional
ประเภท:  PlaceGeometry optional
ข้อมูลที่เกี่ยวข้องกับรูปเรขาคณิตของสถานที่
html_attributions optional
ประเภท:  Array<string> optional
ข้อความการระบุแหล่งที่มาที่จะแสดงสำหรับผลลัพธ์สถานที่นี้ ระบบจะแสดง html_attributions ที่พร้อมใช้งานเสมอ ไม่ว่าคุณจะขอ fields ใดก็ตาม และต้องแสดง html_attributions
icon optional
ประเภท:  string optional
URL ไปยังแหล่งข้อมูลรูปภาพที่ใช้แสดงหมวดหมู่ของสถานที่นี้ได้
icon_background_color optional
ประเภท:  string optional
สีพื้นหลังสำหรับใช้กับไอคอนของสถานที่ ดู PlaceResult.icon_mask_base_uri เพิ่มเติม
icon_mask_base_uri optional
ประเภท:  string optional
URL ที่ถูกตัดทอนไปยังมาสก์ไอคอน เข้าถึงไอคอนประเภทต่างๆ ได้โดยต่อท้ายนามสกุลไฟล์ที่ส่วนท้าย (เช่น .svg หรือ .png)