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)
พารามิเตอร์: 
ค่าการคืนสินค้า: ไม่มี
ดึงข้อมูลรายการสถานที่ตามสตริงการค้นหา ในกรณีส่วนใหญ่ ควรมีผลลัพธ์เพียงรายการเดียวในรายการผลลัพธ์ แต่ถ้าคำขอนั้นไม่ชัดเจน อาจมีผลลัพธ์มากกว่าหนึ่งรายการ 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 เพื่อดึงผลการค้นหาหน้าอื่นๆ ได้ (Null หากนี่เป็นหน้าสุดท้ายของผลการค้นหาหรือหากมีผลการค้นหาเพียงหน้าเดียว)

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

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 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

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

LatLngBounds|LatLngBoundsLiteral

ค่าคงที่ PlacesServiceStatus

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

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

ออบเจ็กต์ที่ใช้ดึงข้อมูลหน้าเพิ่มเติมของผลการค้นหาสถานที่
hasNextPage
ประเภท:  boolean
ระบุว่ามีผลการค้นหาเพิ่มเติมหรือไม่ true เมื่อมีหน้าผลการค้นหาเพิ่มเติม
nextPage
nextPage()
พารามิเตอร์: ไม่มี
ผลลัพธ์:  void
ดึงผลลัพธ์หน้าถัดไป ใช้ฟังก์ชัน 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
หมายเลขโทรศัพท์ของ The Place ในรูปแบบระหว่างประเทศ รูปแบบระหว่างประเทศประกอบด้วยรหัสประเทศ โดยมีเครื่องหมายบวก (+) นำหน้า ใช้ได้กับ 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 ของเขตเวลาปัจจุบันของสถานที่เป็นนาที เช่น ซิดนีย์ ออสเตรเลียในช่วงที่เปลี่ยนเวลาเป็นออมแสงจะเร็วกว่า 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 interface

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

กําหนด Structured Data เกี่ยวกับเวลาทําการของสถานที่ หมายเหตุ: หากสถานที่เปิดตลอด ส่วน 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
เวลาของวันในรูปแบบ 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

กำหนดรหัสสถานที่ตั้งแบบเปิดหรือ "โค้ด Plus" สำหรับสถานที่ คุณสามารถใช้ 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 (รวมเลขตัวแรกและตัวสุดท้าย)