Places Service

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

สถานที่ PlacesService

google.maps.places.PlacesService คลาส

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

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

เมื่อใช้ v=beta ให้เข้าถึงได้โดยการโทรหา const {PlacesService} = await google.map.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

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

การค้นหารายละเอียดสถานที่จะส่งไปยัง PlacesService

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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

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

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

การค้นหาสถานที่ที่จะส่งไปยัง PlacesService

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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 ค่าคงที่

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

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

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

เมื่อใช้ v=beta ให้เข้าถึงได้โดยการโทรหา const {RankBy} = await google.map.importLibrary("places") โปรดดูไลบรารีใน Maps JavaScript API

DISTANCE อันดับจะแสดงผลการค้นหาตามระยะทางจากตําแหน่งนั้น
PROMINENCE อันดับจะแสดงผลการค้นหาตามความโดดเด่น

ประเภท LocationBias

google.maps.places.LocationBias ประเภทการพิมพ์

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

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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

ประเภท LocationRestriction

google.maps.places.LocationRestriction ประเภทการพิมพ์

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

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

LatLngBounds|LatLngBoundsLiteral

ค่าคงที่ PlacesServiceStatus

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

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

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

เมื่อใช้ v=beta ให้เข้าถึงได้โดยการโทรหา const {PlacesServiceStatus} = await google.map.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

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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

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

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

กําหนดข้อมูลเกี่ยวกับสถานที่

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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

กําหนดข้อมูลเกี่ยวกับแง่มุมของสถานที่ที่ผู้ใช้ได้รีวิว

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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

ค่าคงที่ BusinessStatus

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

สถานะการดําเนินการของสถานที่ หากเป็นธุรกิจ ส่งคืนใน PlaceResult (ระบุว่าสถานที่ดังกล่าวดําเนินการหรือปิดชั่วคราวหรือถาวร) ระบุข้อมูลเหล่านี้ตามค่าหรือชื่อค่าคงที่ (เช่น 'OPERATIONAL' หรือ google.maps.places.BusinessStatus.OPERATIONAL)

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

เมื่อใช้ v=beta ให้เข้าถึงได้โดยการโทรหา const {BusinessStatus} = await google.map.importLibrary("places") โปรดดูไลบรารีใน Maps JavaScript API

CLOSED_PERMANENTLY ธุรกิจนี้ปิดถาวร
CLOSED_TEMPORARILY ธุรกิจปิดชั่วคราว
OPERATIONAL ธุรกิจเปิดทําการปกติ

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

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

กําหนดข้อมูลเกี่ยวกับเรขาคณิตของสถานที่

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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

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

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

กําหนดข้อมูลเกี่ยวกับเวลาทําการของสถานที่หนึ่งๆ

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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])
พารามิเตอร์:
  • dateDate 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

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

open
ประเภท: PlaceOpeningHoursTime
เวลาเปิดทําการของสถานที่
close optional
ประเภท: PlaceOpeningHoursTime optional
เวลาปิดสําหรับสถานที่

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

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

กําหนดเวลาที่เปิดหรือปิดสถานที่

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

day
ประเภท: number
วันของสัปดาห์เป็นตัวเลขในช่วง [0, 6] โดยเริ่มจากวันอาทิตย์ เช่น 2 หมายถึงวันอังคาร
hours
ประเภท: number
เวลาทําการของ PlaceOpeningHoursTime.time เป็นตัวเลขในช่วง [0, 23] ซึ่งจะรายงานในเขตเวลาของสถานที่
minutes
ประเภท: number
นาทีที่ PlaceOpeningHoursTime.time เป็นตัวเลข อยู่ในช่วง [0, 59] ซึ่งจะรายงานในเขตเวลาของสถานที่
time
ประเภท: string
เวลาของวันในรูปแบบ "ชั่วโมง" ค่าอยู่ในช่วง ["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 สามารถใช้แทนที่ที่อยู่ในสถานที่ที่ไม่มีที่อยู่ (ในกรณีที่อาคารไม่ได้ใส่หมายเลขหรือไม่ได้ตั้งชื่อถนน)

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

global_code
ประเภท: string
Plus Code ที่มีอุณหภูมิ 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

แสดงองค์ประกอบรูปภาพของสถานที่

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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

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

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

กําหนดตัวเลือกคําขอรูปภาพ

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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

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

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

หมายถึงรีวิวสถานที่เดียว

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

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 (รวมทั้งหมด)