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|LatLngAltitude|LatLngAltitudeLiteral|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)
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 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

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

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

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 (รวมค่าแรกและค่าสุดท้าย)