Places Service

คลาส PlacesService

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

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

เข้าถึงโดยโทรไปที่ const {PlacesService} = await google.maps.importLibrary("places") ดูไลบรารีใน Maps JavaScript API
PlacesService
PlacesService(attrContainer)
พารามิเตอร์: 
สร้างอินสแตนซ์ใหม่ของ PlacesService ที่แสดงผลการระบุแหล่งที่มาในคอนเทนเนอร์ที่ระบุ
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
เรียกรายชื่อสถานที่โดยใช้หมายเลขโทรศัพท์ ในกรณีส่วนใหญ่ รายการผลลัพธ์ควรมีเพียง 1 รายการ แต่หากคำขอนั้นไม่ชัดเจน อาจมีผลลัพธ์มากกว่า 1 รายการ PlaceResult ที่ส่งไปยังโค้ดเรียกกลับเป็นชุดย่อยของ PlaceResult แบบเต็ม แอปของคุณจะดูPlaceResultที่ละเอียดมากขึ้นสำหรับแต่ละสถานที่ได้โดยโทรหา PlacesService.getDetails แล้วส่ง PlaceResult.place_id สำหรับสถานที่ที่ต้องการ
findPlaceFromQuery
findPlaceFromQuery(request, callback)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
เรียกรายชื่อสถานที่ตามสตริงการค้นหา ในกรณีส่วนใหญ่ รายการผลลัพธ์ควรมีเพียง 1 รายการ แต่หากคำขอนั้นไม่ชัดเจน อาจมีผลลัพธ์มากกว่า 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 ใช้เพื่อดึงหน้าผลลัพธ์เพิ่มเติมได้ (เป็นค่าว่างหากเป็นหน้าสุดท้ายของผลการค้นหาหรือหากมีผลการค้นหาเพียงหน้าเดียว)
textSearch
textSearch(request, callback)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
เรียกดูรายการสถานที่ตามสตริงการค้นหา (เช่น "พิซซ่าในนิวยอร์ก" หรือ "ร้านรองเท้าใกล้ออตตาวา") พารามิเตอร์ตำแหน่งเป็นตัวเลือก เมื่อระบุตำแหน่งดังกล่าว ผลลัพธ์จะเอนเอียงไปทางผลลัพธ์ใกล้เคียงเท่านั้น แทนที่จะจำกัดอยู่แค่ในสถานที่ภายในพื้นที่ดังกล่าว ใช้ textSearch เมื่อคุณต้องการค้นหาสถานที่โดยใช้สตริงที่กำหนดเอง และในกรณีที่คุณไม่ต้องการจำกัดผลการค้นหาไว้เฉพาะในสถานที่ใดสถานที่หนึ่ง ออบเจ็กต์ PlaceSearchPagination ใช้เพื่อดึงหน้าผลลัพธ์เพิ่มเติมได้ (เป็นค่าว่างหากเป็นหน้าสุดท้ายของผลการค้นหาหรือหากมีผลการค้นหาเพียงหน้าเดียว)

อินเทอร์เฟซ 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
รหัสภูมิภาคของภูมิภาคของผู้ใช้ การตั้งค่านี้อาจส่งผลต่อรูปภาพที่อาจส่งคืนได้และอาจมีสิ่งอื่นๆ รหัสภูมิภาคยอมรับค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") รหัส ccTLD ส่วนใหญ่เหมือนกับรหัส ISO 3166-1 แต่มีข้อยกเว้นบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ในขณะที่รหัส ISO 3166-1 คือ "gb" (ทางเทคนิคสำหรับเอนทิตีของ "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
sessionToken optional
ประเภท:  AutocompleteSessionToken optional
การอ้างอิงที่ไม่ซ้ำกันซึ่งใช้เพื่อรวมกลุ่มคำขอรายละเอียดกับเซสชันการเติมข้อความอัตโนมัติ

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

อินเทอร์เฟซ 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
ตำแหน่งรอบๆ ที่จะค้นหา Places
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
กึ่งกลางของพื้นที่ที่ใช้ในการกำหนดน้ำหนักผลลัพธ์เมื่อค้นหาด้วย Places
query optional
ประเภท:  string optional
คำค้นหาของคำขอ เช่น ชื่อสถานที่ ("หอไอเฟล") หมวดหมู่ตามด้วยชื่อสถานที่ ("พิซซ่าในนิวยอร์ก") หรือชื่อสถานที่ตามด้วยตัวชี้แจงสถานที่ตั้ง ("สตาร์บัคส์ในซิดนีย์")
radius optional
ประเภท:  number optional
รัศมีของพื้นที่ซึ่งใช้ในการให้น้ำหนักผลลัพธ์ในการค้นหาสถานที่ หน่วยเป็นเมตร
region optional
ประเภท:  string optional
รหัสภูมิภาคที่จะให้น้ำหนักผลลัพธ์ รหัสภูมิภาคยอมรับค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") รหัส 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

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

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

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

กำหนดข้อมูลเกี่ยวกับสถานที่
address_components optional
ประเภท:  Array<GeocoderAddressComponent> optional
การรวบรวมองค์ประกอบที่อยู่ของสถานที่นี้ ใช้ได้เฉพาะกับ PlacesService.getDetails
adr_address optional
ประเภท:  string optional
การแสดงที่อยู่ของสถานที่ใน adr microformat ใช้ได้เฉพาะกับ 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 ไว้อย่างไร และต้องแสดง
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)
international_phone_number optional
ประเภท:  string optional
หมายเลขโทรศัพท์ของสถานที่นี้ในรูปแบบระหว่างประเทศ รูปแบบระหว่างประเทศจะมีรหัสประเทศ และขึ้นต้นด้วยเครื่องหมายบวก (+) ใช้ได้เฉพาะกับ PlacesService.getDetails
name optional
ประเภท:  string optional
ชื่อสถานที่ หมายเหตุ: ในกรณีที่ผู้ใช้ป้อนสถานที่ นี่คือข้อความดิบตามที่ผู้ใช้พิมพ์ โปรดระมัดระวังเมื่อใช้ข้อมูลนี้ เนื่องจากผู้ใช้ที่ประสงค์ร้ายอาจพยายามใช้ข้อมูลเป็นเวกเตอร์สำหรับการโจมตีโดยการแทรกโค้ด (ดู http://en.wikipedia.org/wiki/Code_injection)
opening_hours optional
ประเภท:  PlaceOpeningHours optional
กำหนดเวลาที่สถานที่เปิดหรือปิด
permanently_closed optional
ประเภท:  boolean optional
ธงระบุว่าสถานที่นี้ปิดถาวรหรือชั่วคราว หากสถานที่ดังกล่าวใช้งานได้หรือไม่มีข้อมูล จะไม่มีแฟล็กในคำตอบ
photos optional
ประเภท:  Array<PlacePhoto> optional
รูปภาพของสถานที่นี้ คอลเล็กชันจะมีออบเจ็กต์ PlacePhoto ได้สูงสุด 10 รายการ
place_id optional
ประเภท:  string optional
ตัวระบุที่ไม่ซ้ำกันสำหรับสถานที่
plus_code optional
ประเภท:  PlacePlusCode optional
กำหนดรหัสสถานที่ตั้งแบบเปิดหรือ "โค้ด Plus" สำหรับสถานที่
price_level optional
ประเภท:  number optional
ระดับราคาของสถานที่ ในระดับ 0 ถึง 4 ระดับราคาจะตีความดังนี้
  • 0: ฟรี
  • 1: ไม่แพง
  • 2: กลั่นกรอง
  • 3: แพง
  • 4: แพงมาก
rating optional
ประเภท:  number optional
คะแนนระหว่าง 1.0 ถึง 5.0 ตามรีวิวของผู้ใช้เกี่ยวกับสถานที่นี้
reviews optional
ประเภท:  Array<PlaceReview> optional
รายการรีวิวของสถานที่นี้ ใช้ได้เฉพาะกับ PlacesService.getDetails
types optional
ประเภท:  Array<string> optional
อาร์เรย์ของ ประเภทสำหรับสถานที่นี้ (เช่น ["political", "locality"] หรือ ["restaurant", "establishment"])
url optional
ประเภท:  string optional
URL ของหน้าเว็บอย่างเป็นทางการของ Google สำหรับสถานที่นี้ นี่คือหน้าเว็บที่ Google เป็นเจ้าของซึ่งมีข้อมูลที่ดีที่สุดเกี่ยวกับสถานที่ดังกล่าว ใช้ได้เฉพาะกับ PlacesService.getDetails
user_ratings_total optional
ประเภท:  number optional
จำนวนการให้คะแนนของผู้ใช้ซึ่งส่งผลต่อPlaceResult.ratingของสถานที่นี้
utc_offset optional
ประเภท:  number optional
ค่าออฟเซ็ตจาก UTC ของเขตเวลาปัจจุบันของสถานที่เป็นนาที เช่น ซิดนีย์ ออสเตรเลียเวลาออมแสง เร็วกว่า 11 ชั่วโมง ตามเวลา UTC ดังนั้น utc_offset จะเป็น 660 สำหรับเขตเวลาที่ช้ากว่า UTC ออฟเซ็ตเป็นค่าลบ ตัวอย่างเช่น utc_offset คือ -60 สำหรับเคปเวิร์ด ใช้ได้เฉพาะกับ PlacesService.getDetails
utc_offset_minutes optional
ประเภท:  number optional
ค่าออฟเซ็ตจาก UTC ของเขตเวลาปัจจุบันของสถานที่เป็นนาที เช่น ซิดนีย์ ออสเตรเลียเวลาออมแสง เร็วกว่า 11 ชั่วโมง ตามเวลา UTC ดังนั้น utc_offset_minutes จะเป็น 660 สำหรับเขตเวลาที่ช้ากว่า UTC ออฟเซ็ตเป็นค่าลบ ตัวอย่างเช่น utc_offset_minutes คือ -60 สำหรับเคปเวิร์ด ใช้ได้เฉพาะกับ PlacesService.getDetails
vicinity optional
ประเภท:  string optional
ที่อยู่แบบย่อของสถานที่นี้ ซึ่งได้แก่ ชื่อถนน เลขที่ถนน และย่าน แต่ไม่ใช่จังหวัด/รัฐ รหัสไปรษณีย์ หรือประเทศ เช่น สำนักงานของ Google ในซิดนีย์ ประเทศออสเตรเลีย มีค่าใกล้เคียง "48 Pirrama Road, Pyrmont" ใช้ได้เฉพาะกับ PlacesService.getDetails
website optional
ประเภท:  string optional
เว็บไซต์ที่เชื่อถือได้ของสถานที่นี้ เช่น หน้าแรกของธุรกิจ ใช้ได้เฉพาะกับ PlacesService.getDetails

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

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

กำหนดข้อมูลเกี่ยวกับด้านหนึ่งของสถานที่ที่ผู้ใช้รีวิว
rating
ประเภท:  number
คะแนนด้านนี้ สำหรับความเห็นแต่ละรายการ ตัวเลขนี้จะเป็นจำนวนเต็มตั้งแต่ 0 ถึง 3 สำหรับคะแนนรวมของสถานที่หนึ่งๆ จะเป็นจำนวนเต็มตั้งแต่ 0 ถึง 30
type
ประเภท:  string
ประเภทของการแสดงผล เช่น "food", "decor", "service" หรือ "overall"

ค่าคงที่ BusinessStatus

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

สถานะการปฏิบัติงานของสถานที่ (ในกรณีที่เป็นธุรกิจ) จะแสดงเป็นสถานที่ผลลัพธ์ (ระบุว่าสถานที่ปฏิบัติงาน หรือปิดทำการชั่วคราวหรือถาวร) ระบุรายการเหล่านี้ตามค่าหรือชื่อค่าคงที่ (เช่น 'OPERATIONAL' หรือ google.maps.places.BusinessStatus.OPERATIONAL)

เข้าถึงโดยโทรไปที่ const {BusinessStatus} = await google.maps.importLibrary("places") ดูไลบรารีใน Maps JavaScript API
CLOSED_PERMANENTLY ธุรกิจปิดถาวร
CLOSED_TEMPORARILY ธุรกิจปิดชั่วคราว
OPERATIONAL ธุรกิจดําเนินการตามปกติ

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

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

กำหนดข้อมูลเกี่ยวกับเรขาคณิตของสถานที่
location optional
ประเภท:  LatLng optional
ตําแหน่งของสถานที่
viewport optional
ประเภท:  LatLngBounds optional
วิวพอร์ตที่ต้องการเมื่อแสดงสถานที่นี้บนแผนที่ คุณสมบัตินี้จะเป็น null หากไม่ทราบวิวพอร์ตที่ต้องการสำหรับสถานที่นี้ ใช้ได้เฉพาะกับ PlacesService.getDetails

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

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

กำหนดข้อมูลเกี่ยวกับเวลาเปิดทำการของสถานที่
open_now optional
ประเภท:  boolean optional
สถานที่นี้เปิดในเวลาปัจจุบันหรือไม่
periods optional
ประเภท:  Array<PlaceOpeningHoursPeriod> optional
ช่วงเวลาเปิดทำการที่ครอบคลุมแต่ละวันในสัปดาห์ โดยเริ่มตั้งแต่วันอาทิตย์ตามลำดับเวลา ไม่รวมวันที่สถานที่ไม่เปิด ใช้ได้เฉพาะกับ PlacesService.getDetails
weekday_text optional
ประเภท:  Array<string> optional
อาร์เรย์ 7 สตริงที่แสดงเวลาทำการที่จัดรูปแบบสำหรับแต่ละวันของสัปดาห์ บริการ Places จะจัดรูปแบบและแปลเวลาทำการให้เหมาะกับภาษาปัจจุบันอย่างเหมาะสม ลำดับขององค์ประกอบในอาร์เรย์นี้ขึ้นอยู่กับภาษา บางภาษาจะเริ่มสัปดาห์ในวันจันทร์ในขณะที่บางภาษาเริ่มต้นในวันอาทิตย์ ใช้ได้เฉพาะกับ PlacesService.getDetails การเรียกอื่นๆ อาจแสดงผลอาร์เรย์ที่ว่างเปล่า
isOpen
isOpen([date])
พารามิเตอร์: 
  • date:  Date optional
ค่าที่ส่งคืน:  boolean|undefined
ตรวจสอบว่าสถานที่ดังกล่าวเปิดให้บริการอยู่ (เมื่อไม่มีวันที่ใดผ่านไปแล้ว) หรือในวันที่ที่ระบุ หากสถานที่นี้ไม่มี PlaceResult.utc_offset_minutes หรือ PlaceOpeningHours.periods ระบบจะส่งคืน undefined (PlaceOpeningHours.periods พร้อมให้บริการผ่าน PlacesService.getDetails เท่านั้น) วิธีนี้ไม่ได้พิจารณาเวลาทำการพิเศษ เช่น เวลาทำการในวันหยุด

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

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

กำหนดข้อมูลที่มีโครงสร้างเกี่ยวกับเวลาทำการของสถานที่ หมายเหตุ: หากสถานที่เปิดตลอดเวลา คำตอบจะไม่มีส่วน close ลูกค้าจะใช้ "การเปิดตลอดเวลา" ซึ่งแสดงเป็นช่วงเวลา open ที่มี day ที่มีค่า 0 และ time ที่มีค่า "0000" และไม่มีclose ได้
open
ประเภท:  PlaceOpeningHoursTime
เวลาเปิดทำการของสถานที่นี้
close optional
ประเภท:  PlaceOpeningHoursTime optional
เวลาปิดทำการของสถานที่

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

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

กำหนดเวลาเปิดหรือปิดสถานที่
day
ประเภท:  number
วันของสัปดาห์ในรูปแบบตัวเลขในช่วง [0, 6] เริ่มตั้งแต่วันอาทิตย์ เช่น 2 หมายถึงวันอังคาร
hours
ประเภท:  number
ชั่วโมงของ PlaceOpeningHoursTime.time เป็นตัวเลขในช่วง [0, 23] ซึ่งจะรายงานในเขตเวลาของสถานที่
minutes
ประเภท:  number
นาทีของ PlaceOpeningHoursTime.time เป็นตัวเลขในช่วง [0, 59] ระบบจะรายงานเวลานี้ตามเขตเวลาของสถานที่
time
ประเภท:  string
เวลาของวันในรูปแบบ "hhmm" แบบ 24 ชั่วโมง ค่าอยู่ในช่วง ["0000", "2359"] ระบบจะรายงานเวลาตามเขตเวลาของสถานที่
nextDate optional
ประเภท:  number optional
การประทับเวลา (เป็นมิลลิวินาทีนับจาก Epoch เหมาะสําหรับใช้กับ new Date()) ที่แสดงถึงรายการถัดไปของ PlaceOpeningHoursTime นี้ ซึ่งคำนวณจาก PlaceOpeningHoursTime.day ของสัปดาห์ PlaceOpeningHoursTime.time และ PlaceResult.utc_offset_minutes หาก PlaceResult.utc_offset_minutes คือ undefined ค่า nextDate จะเป็น undefined

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

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

กำหนดรหัสสถานที่ตั้งแบบเปิดหรือ "โค้ด Plus" สำหรับสถานที่ สามารถใช้ Plus Code แทนที่อยู่ในสถานที่ที่ไม่มีอยู่จริง (อาคารไม่มีเลขกำกับหรือไม่ได้ตั้งชื่อถนน)
global_code
ประเภท:  string
Plus Code ที่มีตัวเลข 1/8000 ขององศา 1/8000 ของพื้นที่องศา เช่น "8FVC9G8F+5W"
compound_code optional
ประเภท:  string optional
เครื่องหมายบวกที่มีค่า 1/8000 ขององศา x 1/8000 ของพื้นที่องศาที่มีการวางอักขระ 4 ตัวแรก (รหัสพื้นที่) แล้วแทนที่ด้วยคำอธิบายย่าน เช่น "9G8F+5W Zurich, Switzerland" หากไม่พบย่านที่เหมาะสมซึ่งสามารถใช้เพื่อย่อรหัส ช่องนี้จะถูกละเว้น

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

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

แสดงองค์ประกอบรูปภาพของสถานที่
height
ประเภท:  number
ความสูงของรูปภาพเป็นพิกเซล
html_attributions
ประเภท:  Array<string>
ข้อความแสดงที่มาสำหรับรูปภาพนี้
width
ประเภท:  number
ความกว้างของรูปภาพเป็นพิกเซล
getUrl
getUrl([opts])
พารามิเตอร์: 
ค่าที่ส่งคืน:  string
แสดงผล URL รูปภาพที่สอดคล้องกับตัวเลือกที่ระบุ

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

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

กำหนดตัวเลือกการขอรูปภาพ
maxHeight optional
ประเภท:  number optional
ความสูงสูงสุดเป็นพิกเซลของรูปภาพที่แสดง
maxWidth optional
ประเภท:  number optional
ความกว้างสูงสุดเป็นพิกเซลของรูปภาพที่แสดง

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

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

แสดงรีวิวของสถานที่เดียว
author_name
ประเภท:  string
ชื่อผู้รีวิว
language
ประเภท:  string
รหัสภาษา IETF ที่ระบุภาษาที่ใช้เขียนรีวิวนี้ โปรดทราบว่าโค้ดนี้จะมีเพียงแท็กภาษาหลักเท่านั้นที่ไม่มีแท็กรองที่ระบุประเทศหรือภูมิภาค เช่น รีวิวภาษาอังกฤษทั้งหมดติดแท็กเป็น 'en' แทนที่จะเป็น "en-AU" หรือ "en-UK"
profile_photo_url
ประเภท:  string
URL ไปยังรูปโปรไฟล์ของผู้ปรับแต่ง
relative_time_description
ประเภท:  string
สตริงเวลาล่าสุดที่จัดรูปแบบ ซึ่งแสดงเวลาในการตรวจสอบที่สัมพันธ์กับเวลาปัจจุบันในแบบฟอร์มที่เหมาะสมสำหรับภาษาและประเทศ เช่น "a month ago"
text
ประเภท:  string
ข้อความของรีวิว
time
ประเภท:  number
การประทับเวลาสำหรับการตรวจสอบ ซึ่งแสดงเป็นวินาทีนับตั้งแต่ Epoch
aspects optional
ประเภท:  Array<PlaceAspectRating> optional
ด้านต่างๆ ที่รีวิวให้คะแนน คะแนนเป็นระดับ 0 ถึง 3
author_url optional
ประเภท:  string optional
URL ไปยังโปรไฟล์ของผู้รีวิว ซึ่งเป็นวันที่ undefined เมื่อโปรไฟล์ของผู้รีวิวไม่พร้อมใช้งาน
rating optional
ประเภท:  number optional
คะแนนของรีวิวนี้ ซึ่งมีตัวเลขตั้งแต่ 1.0 ถึง 5.0 (รวมเลขตัวแรกและตัวสุดท้าย)