Places Service

PlacesService class

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

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

เข้าถึงได้โดยโทรไปที่ const {PlacesService} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

ผู้ผลิต
PlacesService	PlacesService(attrContainer) พารามิเตอร์:  attrContainer:  HTMLDivElement|Map สร้างอินสแตนซ์ใหม่ของ PlacesService ที่แสดงผลการระบุแหล่งที่มาในคอนเทนเนอร์ที่ระบุ

เมธอด
findPlaceFromPhoneNumber	findPlaceFromPhoneNumber(request, callback) พารามิเตอร์:  request:  FindPlaceFromPhoneNumberRequest callback:  function(Array<PlaceResult> optional, PlacesServiceStatus): void ค่าที่ส่งคืน: ไม่มี ดึงข้อมูลรายการสถานที่ตามหมายเลขโทรศัพท์ ในกรณีส่วนใหญ่ ควรมีรายการเพียงรายการเดียวในรายการผลลัพธ์ แต่หากคำขอไม่ชัดเจน ระบบอาจแสดงผลลัพธ์มากกว่า 1 รายการ PlaceResult ที่ส่งไปยังการเรียกกลับเป็นชุดย่อยของ PlaceResult แบบเต็ม แอปจะได้รับ PlaceResult ที่ละเอียดยิ่งขึ้นสำหรับแต่ละสถานที่โดยการเรียกใช้ PlacesService.getDetails และส่ง PlaceResult.place_id สำหรับสถานที่ที่ต้องการ
findPlaceFromQuery	findPlaceFromQuery(request, callback) พารามิเตอร์:  request:  FindPlaceFromQueryRequest callback:  function(Array<PlaceResult> optional, PlacesServiceStatus): void ค่าที่ส่งคืน: ไม่มี ดึงข้อมูลรายการสถานที่ตามสตริงการค้นหา ในกรณีส่วนใหญ่ ควรมีรายการเพียงรายการเดียวในรายการผลลัพธ์ แต่หากคำขอไม่ชัดเจน ระบบอาจแสดงผลลัพธ์มากกว่า 1 รายการ PlaceResult ที่ส่งไปยังการเรียกกลับเป็นชุดย่อยของ PlaceResult แบบเต็ม แอปจะได้รับ PlaceResult ที่ละเอียดยิ่งขึ้นสำหรับแต่ละสถานที่โดยการเรียกใช้ PlacesService.getDetails และส่ง PlaceResult.place_id สำหรับสถานที่ที่ต้องการ
getDetails	getDetails(request, callback) พารามิเตอร์:  request:  PlaceDetailsRequest callback:  function(PlaceResult optional, PlacesServiceStatus): void ค่าที่ส่งคืน: ไม่มี เรียกข้อมูลรายละเอียดเกี่ยวกับสถานที่ที่ระบุโดย placeId ที่ระบุ
nearbySearch	nearbySearch(request, callback) พารามิเตอร์:  request:  PlaceSearchRequest callback:  function(Array<PlaceResult> optional, PlacesServiceStatus, PlaceSearchPagination optional): void ค่าที่ส่งคืน: ไม่มี ดึงข้อมูลรายการสถานที่ใกล้กับสถานที่ตั้งหนึ่งๆ โดยอิงตามคีย์เวิร์ดหรือประเภท ต้องระบุสถานที่เสมอ ไม่ว่าจะโดยการส่งพารามิเตอร์ LatLngBounds หรือ location และ radius PlaceResult ที่ส่งไปยังการเรียกกลับเป็นส่วนย่อยของ PlaceResult แบบเต็ม แอปของคุณจะได้รับ PlaceResult ที่ละเอียดยิ่งขึ้นสำหรับแต่ละสถานที่โดยการส่งคำขอรายละเอียดสถานที่ที่ส่ง PlaceResult.place_id สำหรับสถานที่ที่ต้องการ ออบเจ็กต์ PlaceSearchPagination สามารถใช้เพื่อดึงข้อมูลผลลัพธ์ในหน้าอื่นๆ (เป็น Null หากเป็นหน้าผลลัพธ์สุดท้ายหรือมีผลลัพธ์เพียงหน้าเดียว)
textSearch	textSearch(request, callback) พารามิเตอร์:  request:  TextSearchRequest callback:  function(Array<PlaceResult> optional, PlacesServiceStatus, PlaceSearchPagination optional): void ค่าที่ส่งคืน: ไม่มี ดึงข้อมูลรายการสถานที่ตามสตริงการค้นหา (เช่น "พิซซ่าในนิวยอร์ก" หรือ "ร้านรองเท้าใกล้ออตตาวา") พารามิเตอร์ตำแหน่งเป็นพารามิเตอร์ที่ไม่บังคับ เมื่อระบุตำแหน่ง ผลลัพธ์จะเอนเอียงไปทางผลลัพธ์ที่อยู่ใกล้เคียงเท่านั้น ไม่ได้จำกัดเฉพาะสถานที่ภายในพื้นที่ ใช้ 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	เลิกใช้งานแล้ว: ใช้ keyword แทน ประเภท:  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	เลิกใช้งาน: permanently_closed เลิกใช้งานแล้วตั้งแต่เดือนพฤษภาคม 2020 และจะปิดให้บริการในเดือนพฤษภาคม 2021 โปรดใช้ PlaceResult.business_status แทน เนื่องจาก permanently_closed ไม่ได้แยกความแตกต่างระหว่างการปิดชั่วคราวกับการปิดถาวร ประเภท:  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	เลิกใช้งาน: utc_offset เลิกใช้งานแล้วตั้งแต่เดือนพฤศจิกายน 2019 โปรดใช้ PlaceResult.utc_offset_minutes แทน ดู https://goo.gle/js-open-now ประเภท:  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	เลิกใช้งาน: open_now เลิกใช้งานแล้วตั้งแต่เดือนพฤศจิกายน 2019 โปรดใช้วิธี PlaceOpeningHours.isOpen จากผลลัพธ์ PlacesService.getDetails แทน ดู https://goo.gle/js-open-now ประเภท:  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]) พารามิเตอร์:  opts:  PhotoOptions optional ค่าที่ส่งคืน:  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 (รวมค่าแรกและค่าสุดท้าย)