Places Service

PlacesService class

google.maps.places.PlacesService class

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

เข้าถึงโดยการโทรหา 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 เพื่อดึงข้อมูลหน้าอื่นๆ เพิ่มเติม (เป็นค่าว่างหากหน้านี้เป็นหน้าสุดท้ายของผลการค้นหาหรือมีเพียงหน้าเดียว)
textSearch
textSearch(request, callback)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
ดึงข้อมูลรายการสถานที่ตามสตริงการค้นหา (เช่น "พิซซ่าในนิวยอร์ก" หรือ "ร้านรองเท้าใกล้กับออตตาวา") พารามิเตอร์ตำแหน่งเป็นตัวเลือก เมื่อระบุตำแหน่งแล้ว ผลการค้นหาจะเน้นที่ผลการค้นหาใกล้เคียงเท่านั้น โดยไม่จำกัดเฉพาะสถานที่ภายในพื้นที่ ใช้ textSearch เมื่อต้องการค้นหาสถานที่โดยใช้สตริงที่กำหนดเอง และในกรณีที่คุณอาจไม่ต้องการจำกัดผลการค้นหาให้แสดงเฉพาะสถานที่หนึ่งๆ คุณสามารถใช้ออบเจ็กต์ PlaceSearchPagination เพื่อดึงข้อมูลหน้าอื่นๆ เพิ่มเติม (เป็นค่าว่างหากหน้านี้เป็นหน้าสุดท้ายของผลการค้นหาหรือมีเพียงหน้าเดียว)

PlaceDetailsRequest interface

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 ที่ระบุ แต่ไม่ได้จํากัดเพียง LocationBias ดังกล่าว

FindPlaceFromQueryRequest interface

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

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

PlaceSearchRequest interface

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

RankBy constants

google.maps.places.RankBy constants

ตัวเลือกการจัดอันดับสําหรับ 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 constants

google.maps.places.PlacesServiceStatus constants

สถานะที่ 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 interface

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

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

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
กำหนด Open Location Codes หรือ "Plus Code" สำหรับสถานที่
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 ของเขตเวลาปัจจุบันของสถานที่เป็นนาที เช่น ซิดนีย์ ออสเตรเลียในช่วงที่เปลี่ยนเวลาเป็นออมแสงจะเร็วกว่า UTC 11 ชั่วโมง ดังนั้น utc_offset จะเท่ากับ 660 สำหรับเขตเวลาที่ช้ากว่า UTC ออฟเซ็ตจะเป็นค่าลบ เช่น utc_offset สำหรับเคปเวิร์ดคือ -60 ใช้ได้กับ PlacesService.getDetails เท่านั้น
utc_offset_minutes optional
ประเภท:  number optional
การชดเชยจากเขตเวลา UTC ของเขตเวลาปัจจุบันของสถานที่เป็นนาที เช่น ซิดนีย์ ออสเตรเลียในช่วงที่เปลี่ยนเวลาเป็นออมแสงจะเร็วกว่า UTC 11 ชั่วโมง ดังนั้น 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 constants

google.maps.places.BusinessStatus constants

สถานะการทํางานของสถานที่ (หากเป็นธุรกิจ) ที่แสดงใน PlaceResult (ระบุว่าสถานที่ทํางานอยู่ หรือปิดชั่วคราวหรือถาวร) ระบุค่าเหล่านี้ตามค่าหรือชื่อของค่าคงที่ (เช่น '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 อินเทอร์เฟซ

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

PlaceOpeningHoursTime interface

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

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

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

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

กำหนด Open Location Codes หรือ "Plus Code" สำหรับสถานที่ คุณสามารถใช้ Plus Codes แทนที่อยู่ซึ่งไม่มีอยู่ (ในกรณีที่ไม่มีเลขที่อาคารหรือไม่มีชื่อถนน)
global_code
ประเภท:  string
โค้ด Plus ที่มีพื้นที่ 1/8000 องศาคูณด้วย 1/8000 องศา เช่น "8FVC9G8F+5W"
compound_code optional
ประเภท:  string optional
Plus Code ที่มีพื้นที่ 1/8000 องศาคูณด้วย 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 interface

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

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

PlaceReview interface

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 (รวม)