Places Service (deprecated)

คลาส PlacesService

ชั้นเรียน google.maps.places.PlacesService
ห้องสมุด "places"

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

const {PlacesService} = await google.maps.importLibrary("places");
PlacesService
PlacesService(attrContainer)
พารามิเตอร์
สร้างอินสแตนซ์ใหม่ของ PlacesService ที่แสดงผลการระบุแหล่งที่มาในคอนเทนเนอร์ที่ระบุ
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
พารามิเตอร์
ผลลัพธ์: ไม่มี
ดึงข้อมูลรายการสถานที่ตามหมายเลขโทรศัพท์ ในกรณีส่วนใหญ่ ควรมีรายการเดียวในรายการผลลัพธ์ แต่หากคำขอไม่ชัดเจน ระบบอาจแสดงผลลัพธ์มากกว่า 1 รายการ PlaceResult ที่ส่งไปยัง Callback เป็นชุดย่อยของ PlaceResult แบบเต็ม แอปของคุณจะได้รับ PlaceResult ที่ละเอียดยิ่งขึ้นสำหรับสถานที่แต่ละแห่งโดยการเรียกใช้ PlacesService.getDetails และส่ง PlaceResult.place_id สำหรับสถานที่ที่ต้องการ
findPlaceFromQuery
findPlaceFromQuery(request, callback)
พารามิเตอร์
ผลลัพธ์: ไม่มี
ดึงข้อมูลรายการสถานที่ตามสตริงการค้นหา ในกรณีส่วนใหญ่ ควรมีรายการเดียวในรายการผลลัพธ์ แต่หากคำขอไม่ชัดเจน ระบบอาจแสดงผลลัพธ์มากกว่า 1 รายการ PlaceResult ที่ส่งไปยัง Callback เป็นชุดย่อยของ PlaceResult แบบเต็ม แอปของคุณจะได้รับ PlaceResult ที่ละเอียดยิ่งขึ้นสำหรับสถานที่แต่ละแห่งโดยการเรียกใช้ PlacesService.getDetails และส่ง PlaceResult.place_id สำหรับสถานที่ที่ต้องการ
getDetails
getDetails(request, callback)
พารามิเตอร์
ผลลัพธ์: ไม่มี
ดึงข้อมูลรายละเอียดเกี่ยวกับสถานที่ที่ระบุโดย placeId ที่ระบุ
nearbySearch
nearbySearch(request, callback)
พารามิเตอร์
ผลลัพธ์: ไม่มี
ดึงข้อมูลรายการสถานที่ใกล้กับสถานที่หนึ่งๆ โดยอิงตามคีย์เวิร์ดหรือประเภท ต้องระบุสถานที่ตั้งเสมอ โดยส่งพารามิเตอร์ LatLngBounds หรือ location และ radius PlaceResult ที่ส่งไปยัง Callback เป็นชุดย่อยของ PlaceResult แบบเต็ม แอปของคุณจะได้รับPlaceResultที่ละเอียดยิ่งขึ้นสำหรับสถานที่แต่ละแห่งโดยการส่งคำขอรายละเอียดสถานที่ที่ส่งPlaceResult.place_idสำหรับสถานที่ที่ต้องการ คุณใช้ออบเจ็กต์ PlaceSearchPagination เพื่อดึงข้อมูลหน้าผลลัพธ์เพิ่มเติมได้ (ค่าจะเป็น Null หากเป็นหน้าผลลัพธ์สุดท้ายหรือมีผลลัพธ์เพียงหน้าเดียว)
textSearch
textSearch(request, callback)
พารามิเตอร์
ผลลัพธ์: ไม่มี
ดึงข้อมูลรายการสถานที่ตามสตริงการค้นหา (เช่น "พิซซ่าในนิวยอร์ก" หรือ "ร้านรองเท้าใกล้กรุงเทพ") พารามิเตอร์ตำแหน่งเป็นพารามิเตอร์ที่ไม่บังคับ เมื่อระบุตำแหน่ง ผลลัพธ์จะให้น้ำหนักกับผลลัพธ์ที่อยู่ใกล้เคียงเท่านั้น แทนที่จะจำกัดเฉพาะสถานที่ภายในพื้นที่ ใช้ textSearch เมื่อต้องการค้นหาสถานที่โดยใช้สตริงที่กำหนดเอง และในกรณีที่คุณอาจไม่ต้องการจำกัดผลการค้นหาไว้ที่สถานที่หนึ่งๆ คุณใช้ออบเจ็กต์ PlaceSearchPagination เพื่อดึงข้อมูลหน้าผลลัพธ์เพิ่มเติมได้ (ค่าจะเป็น Null หากเป็นหน้าผลลัพธ์สุดท้ายหรือมีผลลัพธ์เพียงหน้าเดียว)

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

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

คำค้นหารายละเอียดสถานที่ที่จะส่งไปยัง PlacesService
placeId
ประเภท: string
รหัสสถานที่ของสถานที่ที่ขอรายละเอียด
fields
ไม่บังคับ
ประเภท: Array<string> optional
ช่องที่จะรวมอยู่ในการตอบกลับรายละเอียด ซึ่งจะมีการเรียกเก็บเงิน หากไม่ได้ระบุช่องหรือส่ง ['ALL'] เข้ามา ระบบจะแสดงผลและเรียกเก็บเงินสำหรับช่องที่ใช้ได้ทั้งหมด (ไม่แนะนำสำหรับการใช้งานจริง) ดูรายการช่องได้ที่ PlaceResult คุณระบุฟิลด์ที่ฝังได้ด้วยเส้นทางแบบจุด (เช่น "geometry.location")
language
ไม่บังคับ
ประเภท: string optional
ตัวระบุภาษาสำหรับภาษาที่ควรแสดงรายละเอียด ดูรายการภาษาที่รองรับ
region
ไม่บังคับ
ประเภท: string optional
รหัสภูมิภาคของผู้ใช้ ซึ่งอาจส่งผลต่อรูปภาพที่อาจแสดงผล และอาจส่งผลต่อสิ่งอื่นๆ ด้วย รหัสภูมิภาคยอมรับค่า ccTLD ("โดเมนระดับบนสุด") แบบ 2 อักขระ รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นที่สำคัญบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับหน่วยงาน "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
sessionToken
ไม่บังคับ
ประเภท: AutocompleteSessionToken optional
ข้อมูลอ้างอิงที่ไม่ซ้ำกันซึ่งใช้เพื่อรวมคำขอรายละเอียดเข้ากับเซสชันการเติมข้อความอัตโนมัติ

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

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

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

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

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

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

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

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

คำค้นหาการค้นหาสถานที่ที่จะส่งไปยัง PlacesService
bounds
ไม่บังคับ
ประเภท: LatLngBounds|LatLngBoundsLiteral optional
ขอบเขตที่จะค้นหา Places ระบบจะไม่สนใจทั้ง location และ radius หากตั้งค่า bounds ไว้
keyword
ไม่บังคับ
ประเภท: string optional
คำที่ใช้จับคู่กับช่องที่ใช้ได้ทั้งหมด ซึ่งรวมถึงแต่ไม่จำกัดเพียงชื่อ ประเภท และที่อยู่ ตลอดจนรีวิวจากลูกค้าและเนื้อหาอื่นๆ ของบุคคลที่สาม
language
ไม่บังคับ
ประเภท: string optional
ตัวระบุภาษาสำหรับภาษาที่ควรแสดงชื่อและที่อยู่ หากเป็นไปได้ ดูรายการภาษาที่รองรับ
location
ไม่บังคับ
ประเภท: LatLng|LatLngLiteral optional
ตำแหน่งที่ต้องการค้นหา Places รอบๆ
maxPriceLevel
ไม่บังคับ
ประเภท: number optional
จำกัดผลการค้นหาเฉพาะสถานที่ที่มีระดับราคาที่ระบุหรือต่ำกว่า ค่าที่ถูกต้องอยู่ในช่วงตั้งแต่ 0 (ราคาถูกที่สุด) ถึง 4 (ราคาแพงที่สุด) ต้องมากกว่าหรือเท่ากับ minPrice หากระบุไว้
minPriceLevel
ไม่บังคับ
ประเภท: number optional
จำกัดผลการค้นหาเฉพาะสถานที่ที่มีระดับราคาที่ระบุหรือสูงกว่า ค่าที่ถูกต้องอยู่ในช่วงตั้งแต่ 0 (ราคาถูกที่สุด) ถึง 4 (ราคาแพงที่สุด) ต้องน้อยกว่าหรือเท่ากับ maxPrice หากระบุไว้
name
ไม่บังคับ
ประเภท: string optional
เทียบเท่ากับ keyword ค่าในช่องนี้จะรวมกับค่าในช่อง keyword และส่งเป็นส่วนหนึ่งของสตริงการค้นหาเดียวกัน
openNow
ไม่บังคับ
ประเภท: boolean optional
จำกัดผลการค้นหาเฉพาะสถานที่ที่เปิดอยู่ในขณะนี้
radius
ไม่บังคับ
ประเภท: number optional
ระยะทางจากสถานที่ตั้งที่ระบุซึ่งจะใช้ค้นหาสถานที่ โดยมีหน่วยเป็นเมตร ค่าสูงสุดที่อนุญาตคือ 50,000
rankBy
ไม่บังคับ
ประเภท: RankBy optional
ค่าเริ่มต้น: RankBy.PROMINENCE
ระบุวิธีการจัดอันดับที่จะใช้เมื่อแสดงผลลัพธ์ โปรดทราบว่าเมื่อตั้งค่า rankBy เป็น DISTANCE คุณต้องระบุ location แต่จะระบุ radius หรือ bounds ไม่ได้
type
ไม่บังคับ
ประเภท: string optional
ค้นหาสถานที่ตามประเภทที่ระบุ ระบบจะแปลประเภทเป็นภาษาท้องถิ่นของสถานที่เป้าหมายของคำขอและใช้เป็นสตริงคำค้นหา หากมีการระบุคำค้นหาด้วย ระบบจะเชื่อมโยงคำค้นหากับสตริงประเภทที่แปลแล้ว ระบบจะตัดผลลัพธ์ประเภทอื่นออกจากคำตอบ ใช้ช่องนี้เพื่อทำการค้นหาตามหมวดหมู่โดยไม่ขึ้นอยู่กับภาษาและภูมิภาค ดูประเภทที่ถูกต้องได้ที่นี่

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

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

คำขอการค้นหาข้อความที่จะส่งไปยัง PlacesService
bounds
ไม่บังคับ
ประเภท: LatLngBounds|LatLngBoundsLiteral optional
ขอบเขตที่ใช้เพื่อให้น้ำหนักผลการค้นหาเมื่อค้นหา Places (ไม่บังคับ) ระบบจะไม่สนใจทั้ง location และ radius หากตั้งค่า bounds ไว้ ผลการค้นหาจะไม่จำกัดเฉพาะผลการค้นหาที่อยู่ภายในขอบเขตเหล่านี้ แต่ผลการค้นหาที่อยู่ภายในขอบเขตจะอยู่ในอันดับที่สูงกว่า
language
ไม่บังคับ
ประเภท: string optional
ตัวระบุภาษาสำหรับภาษาที่ควรแสดงชื่อและที่อยู่ หากเป็นไปได้ ดูรายการภาษาที่รองรับ
location
ไม่บังคับ
ประเภท: LatLng|LatLngLiteral optional
ศูนย์กลางของพื้นที่ที่ใช้เพื่อให้น้ำหนักพิเศษกับผลการค้นหาเมื่อค้นหา Places
query
ไม่บังคับ
ประเภท: string optional
คำค้นหาของคำขอ เช่น ชื่อสถานที่ ("หอไอเฟล") หมวดหมู่ตามด้วยชื่อสถานที่ตั้ง ("พิซซ่าในนิวยอร์ก") หรือชื่อสถานที่ตามด้วยคำอธิบายสถานที่ตั้ง ("สตาร์บัคส์ในซิดนีย์")
radius
ไม่บังคับ
ประเภท: number optional
รัศมีของพื้นที่ที่ใช้เพื่อให้น้ำหนักผลการค้นหาเมื่อค้นหาสถานที่ (หน่วยเป็นเมตร)
region
ไม่บังคับ
ประเภท: string optional
รหัสภูมิภาคเพื่อให้น้ำหนักกับผลการค้นหา รหัสภูมิภาคยอมรับค่า ccTLD ("โดเมนระดับบนสุด") แบบ 2 อักขระ รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นที่สำคัญบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับหน่วยงาน "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
type
ไม่บังคับ
ประเภท: string optional
ค้นหาสถานที่ตามประเภทที่ระบุ ระบบจะแปลประเภทเป็นภาษาท้องถิ่นของสถานที่เป้าหมายของคำขอและใช้เป็นสตริงคำค้นหา หากมีการระบุคำค้นหาด้วย ระบบจะเชื่อมโยงคำค้นหากับสตริงประเภทที่แปลแล้ว ระบบจะตัดผลลัพธ์ประเภทอื่นออกจากคำตอบ ใช้ช่องนี้เพื่อทำการค้นหาตามหมวดหมู่โดยไม่ขึ้นอยู่กับภาษาและภูมิภาค ดูประเภทที่ถูกต้องได้ที่นี่

ค่าคงที่ RankBy

constants google.maps.places.RankBy
library "places"

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

const {RankBy} = await google.maps.importLibrary("places");
DISTANCE จัดอันดับผลการค้นหาสถานที่ตามระยะทางจากสถานที่ตั้ง
PROMINENCE จัดอันดับผลการค้นหาสถานที่ตามความโดดเด่น

LocationBias typedef

typedef google.maps.places.LocationBias

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

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

LocationRestriction typedef

typedef google.maps.places.LocationRestriction

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

LatLngBounds|LatLngBoundsLiteral

ค่าคงที่ PlacesServiceStatus

constants google.maps.places.PlacesServiceStatus
library "places"

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท PlacesServiceStatusString

const {PlacesServiceStatus} = await google.maps.importLibrary("places");
INVALID_REQUEST คำขอนี้ไม่ถูกต้อง
NOT_FOUND ไม่พบสถานที่ที่อ้างอิง
OK การตอบกลับมีผลลัพธ์ที่ถูกต้อง
OVER_QUERY_LIMIT แอปพลิเคชันมีคำขอเกินโควต้า
REQUEST_DENIED แอปพลิเคชันไม่ได้รับอนุญาตให้ใช้ PlacesService
UNKNOWN_ERROR ประมวลผลคำขอ PlacesService ไม่ได้เนื่องจากข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ คำขออาจสำเร็จหากคุณลองอีกครั้ง
ZERO_RESULTS ไม่พบผลลัพธ์สำหรับคำขอนี้

PlaceSearchPagination interface

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

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

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

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

กำหนดข้อมูลเกี่ยวกับสถานที่
address_components
ไม่บังคับ
ประเภท: Array<GeocoderAddressComponent> optional
คอลเล็กชันคอมโพเนนต์ที่อยู่สำหรับตำแหน่งของสถานที่นี้ ใช้ได้เฉพาะกับ PlacesService.getDetails เท่านั้น
adr_address
ไม่บังคับ
ประเภท: string optional
การแสดงที่อยู่ของสถานที่ในไมโครฟอร์แมต adr ใช้ได้เฉพาะกับ PlacesService.getDetails เท่านั้น
aspects
ไม่บังคับ
ประเภท: Array<PlaceAspectRating> optional
แง่มุมที่ได้รับการให้คะแนนของสถานที่นี้ โดยอิงตามรีวิวของผู้ใช้ Google และ Zagat โดยคะแนนจะอยู่ในช่วง 0 ถึง 30
business_status
ไม่บังคับ
ประเภท: BusinessStatus optional
แฟล็กที่ระบุสถานะการดำเนินการของสถานที่ หากเป็นธุรกิจ (ระบุว่าสถานที่นั้นเปิดดำเนินการอยู่ หรือปิดชั่วคราวหรือถาวร) หากไม่มีข้อมูล แฟล็กจะไม่ปรากฏในการค้นหาหรือการตอบกลับรายละเอียด
formatted_address
ไม่บังคับ
ประเภท: string optional
ที่อยู่แบบเต็มของสถานที่
formatted_phone_number
ไม่บังคับ
ประเภท: string optional
หมายเลขโทรศัพท์ของสถานที่ซึ่งจัดรูปแบบตาม รูปแบบหมายเลขของภูมิภาค ใช้ได้เฉพาะกับ PlacesService.getDetails เท่านั้น
geometry
ไม่บังคับ
ประเภท: PlaceGeometry optional
ข้อมูลที่เกี่ยวข้องกับเรขาคณิตของสถานที่
html_attributions
ไม่บังคับ
ประเภท: Array<string> optional
ข้อความแสดงแหล่งที่มาที่จะแสดงสำหรับผลการค้นหาสถานที่นี้ ระบบจะแสดง html_attributions ที่ใช้ได้เสมอไม่ว่าจะมีการขอ fields ใดก็ตาม และต้องแสดง ดังกล่าว
icon
ไม่บังคับ
ประเภท: string optional
URL ไปยังแหล่งข้อมูลรูปภาพที่ใช้แสดงหมวดหมู่ของสถานที่นี้ได้
icon_background_color
ไม่บังคับ
ประเภท: string optional
สีพื้นหลังสำหรับใช้กับไอคอนของสถานที่ ดูเพิ่มเติมที่ PlaceResult.icon_mask_base_uri
icon_mask_base_uri
ไม่บังคับ
ประเภท: string optional
URL ที่ถูกตัดให้สั้นลงซึ่งชี้ไปยังมาสก์ไอคอน เข้าถึงไอคอนประเภทต่างๆ โดยเพิ่มนามสกุลไฟล์ต่อท้าย (เช่น .svg หรือ .png)
international_phone_number
ไม่บังคับ
ประเภท: string optional
หมายเลขโทรศัพท์ของสถานที่ในรูปแบบระหว่างประเทศ รูปแบบระหว่างประเทศประกอบด้วยรหัสประเทศ และมีเครื่องหมายบวก (+) นำหน้า ใช้ได้เฉพาะกับ PlacesService.getDetails เท่านั้น
name
ไม่บังคับ
ประเภท: string optional
ชื่อของสถานที่ หมายเหตุ: ในกรณีที่ผู้ใช้ป้อน Places ข้อมูลนี้จะเป็นข้อความดิบตามที่ผู้ใช้พิมพ์ โปรดใช้ความระมัดระวังเมื่อใช้ข้อมูลนี้ เนื่องจากผู้ใช้ที่เป็นอันตรายอาจพยายามใช้ข้อมูลนี้เป็นเวกเตอร์สำหรับการโจมตีแบบแทรกโค้ด (ดู http://en.wikipedia.org/wiki/Code_injection)
opening_hours
ไม่บังคับ
ประเภท: PlaceOpeningHours optional
กำหนดเวลาที่สถานที่เปิดหรือปิด
permanently_closed
ไม่บังคับ
ประเภท: boolean optional
แฟล็กที่ระบุว่าสถานที่ปิดถาวรหรือชั่วคราว หากสถานที่เปิดให้บริการหรือไม่มีข้อมูล แฟล็กจะไม่อยู่ในการตอบกลับ
photos
ไม่บังคับ
ประเภท: Array<PlacePhoto> optional
รูปภาพของสถานที่นี้ คอลเล็กชันจะมีออบเจ็กต์ PlacePhoto ได้สูงสุด 10 รายการ
place_id
ไม่บังคับ
ประเภท: string optional
ตัวระบุที่ไม่ซ้ำกันสำหรับสถานที่
plus_code
ไม่บังคับ
ประเภท: PlacePlusCode optional
กำหนด Open Location Code หรือ "Plus Code" สำหรับสถานที่
price_level
ไม่บังคับ
ประเภท: number optional
ระดับราคาของสถานที่ในระดับ 0 ถึง 4 ระบบจะตีความระดับราคาดังนี้
  • 0: ฟรี
  • 1: ราคาไม่แพง
  • 2: ปานกลาง
  • 3: แพง
  • 4: แพงมาก
rating
ไม่บังคับ
ประเภท: number optional
คะแนนระหว่าง 1.0 ถึง 5.0 โดยอิงตามรีวิวของผู้ใช้เกี่ยวกับสถานที่นี้
reviews
ไม่บังคับ
ประเภท: Array<PlaceReview> optional
รายการรีวิวของสถานที่นี้ ใช้ได้เฉพาะกับ PlacesService.getDetails เท่านั้น
types
ไม่บังคับ
ประเภท: Array<string> optional
อาร์เรย์ของ ประเภทสำหรับสถานที่นี้ (เช่น ["political", "locality"] หรือ ["restaurant", "establishment"])
url
ไม่บังคับ
ประเภท: string optional
URL ของหน้า Google อย่างเป็นทางการสำหรับสถานที่นี้ นี่คือหน้าเว็บที่ Google เป็นเจ้าของซึ่งมีข้อมูลที่ดีที่สุดเกี่ยวกับสถานที่ ใช้ได้เฉพาะกับ PlacesService.getDetails เท่านั้น
user_ratings_total
ไม่บังคับ
ประเภท: number optional
จำนวนการให้คะแนนของผู้ใช้ที่ส่งผลต่อ PlaceResult.rating ของสถานที่นี้
utc_offset
ไม่บังคับ
ประเภท: number optional
ค่าชดเชยจาก UTC ของเขตเวลาปัจจุบันของสถานที่ (หน่วยเป็นนาที) เช่น ซิดนีย์ ออสเตรเลีย ในช่วงเวลาออมแสงจะเร็วกว่า UTC 11 ชั่วโมง ดังนั้น utc_offset จะเป็น 660 สำหรับเขตเวลาที่ช้ากว่า UTC การชดเชยเวลาจะเป็นค่าลบ ตัวอย่างเช่น utc_offset คือ -60 สำหรับเคปเวิร์ด ใช้ได้เฉพาะกับ PlacesService.getDetails เท่านั้น
utc_offset_minutes
ไม่บังคับ
ประเภท: number optional
ค่าชดเชยจาก UTC ของเขตเวลาปัจจุบันของสถานที่ (หน่วยเป็นนาที) ตัวอย่างเช่น ซิดนีย์ ออสเตรเลีย ในช่วงเวลาออมแสงจะเร็วกว่า UTC 11 ชั่วโมง ดังนั้น utc_offset_minutes จะเป็น 660 สำหรับเขตเวลาที่ช้ากว่า UTC การชดเชยเวลาจะเป็นค่าลบ ตัวอย่างเช่น utc_offset_minutes คือ -60 สำหรับเคปเวิร์ด ใช้ได้เฉพาะกับ PlacesService.getDetails เท่านั้น
vicinity
ไม่บังคับ
ประเภท: string optional
ที่อยู่แบบย่อของสถานที่ ซึ่งรวมถึงชื่อถนน หมายเลขถนน และท้องถิ่น แต่ไม่รวมจังหวัด/รัฐ รหัสไปรษณีย์ หรือประเทศ ตัวอย่างเช่น สำนักงานของ Google ในซิดนีย์ ประเทศออสเตรเลียมีค่าบริเวณใกล้เคียงเป็น "48 Pirrama Road, Pyrmont" ใช้ได้เฉพาะกับ PlacesService.getDetails เท่านั้น
website
ไม่บังคับ
ประเภท: 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
library "places"

สถานะธุรกิจของสถานที่ ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับบริการบนเว็บ

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท BusinessStatusString

const {BusinessStatus} = await google.maps.importLibrary("places");
CLOSED_PERMANENTLY สถานประกอบการปิดถาวรแล้ว ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับบริการบนเว็บ
CLOSED_TEMPORARILY สถานประกอบการปิดชั่วคราว ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับบริการบนเว็บ
FUTURE_OPENING สถานที่ประกอบธุรกิจจะเปิดในอนาคต ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับบริการบนเว็บ
OPERATIONAL สถานประกอบการเปิดให้บริการอยู่ แต่ไม่จำเป็นต้องเปิดอยู่ในขณะนี้ ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับบริการบนเว็บ

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

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

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

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

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

กำหนดข้อมูลเกี่ยวกับเวลาทำการของสถานที่
open_now
ไม่บังคับ
ประเภท: boolean optional
สถานที่เปิดอยู่ ณ เวลาปัจจุบันหรือไม่
periods
ไม่บังคับ
ประเภท: Array<PlaceOpeningHoursPeriod> optional
ระยะเวลาเปิดทำการที่ครอบคลุมแต่ละวันในสัปดาห์ โดยเริ่มตั้งแต่วันอาทิตย์ตามลำดับเวลา โดยจะไม่รวมวันที่สถานที่ปิดทำการ ใช้ได้เฉพาะกับ PlacesService.getDetails เท่านั้น
weekday_text
ไม่บังคับ
ประเภท: Array<string> optional
อาร์เรย์ของสตริง 7 รายการที่แสดงเวลาทำการที่จัดรูปแบบแล้วสำหรับแต่ละวันในสัปดาห์ บริการ Places จะจัดรูปแบบและแปลเวลาทำการให้เหมาะสมกับภาษาปัจจุบัน การจัดลำดับองค์ประกอบในอาร์เรย์นี้ขึ้นอยู่กับภาษา บางภาษาจะเริ่มสัปดาห์ในวันจันทร์ ขณะที่บางภาษาจะเริ่มในวันอาทิตย์ ใช้ได้เฉพาะกับ PlacesService.getDetails เท่านั้น การเรียกอื่นๆ อาจแสดงผลอาร์เรย์ที่ว่างเปล่า
isOpen
isOpen([date])
พารามิเตอร์
  • date: Date optional
ค่าที่แสดงผล: boolean|undefined
ตรวจสอบว่าสถานที่เปิดอยู่หรือไม่ (เมื่อไม่มีการระบุวันที่) หรือเปิดในวันที่ที่ระบุหรือไม่ หากสถานที่นี้ไม่มี PlaceResult.utc_offset_minutes หรือ PlaceOpeningHours.periods ระบบจะแสดงผล undefined (PlaceOpeningHours.periods จะใช้ได้ผ่าน PlacesService.getDetails เท่านั้น) วิธีนี้จะไม่พิจารณาเวลาทำการพิเศษ เช่น เวลาทำการในวันหยุด

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

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

กำหนดข้อมูลที่มีโครงสร้างเกี่ยวกับเวลาทำการของสถานที่ หมายเหตุ: หากสถานที่เปิดตลอดเวลา ส่วน close จะหายไปจากการตอบกลับ ลูกค้าสามารถใช้ระยะเวลา open ที่มี day ซึ่งมีค่า 0 และ time ซึ่งมีค่า "0000" และไม่มี close เพื่อแสดงถึงการเปิดตลอดเวลาได้
open
ประเภท: PlaceOpeningHoursTime
เวลาเปิดทำการของสถานที่
close
ไม่บังคับ
ประเภท: 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
ไม่บังคับ
ประเภท: 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

กำหนด Open Location Code หรือ "Plus Code" สำหรับสถานที่ Plus Code สามารถใช้แทนที่อยู่ได้ในสถานที่ที่ไม่มีที่อยู่ (อาคารไม่มีหมายเลขหรือถนนไม่มีชื่อ)
global_code
ประเภท: string
Plus Code ที่มีพื้นที่ 1/8,000 องศา x 1/8,000 องศา เช่น "8FVC9G8F+5W"
compound_code
ไม่บังคับ
ประเภท: string optional
Plus Code ที่มีพื้นที่ 1/8,000 ขององศา คูณ 1/8,000 ขององศา โดยที่อักขระ 4 ตัวแรก (รหัสพื้นที่) จะถูกตัดออกและแทนที่ด้วยคำอธิบายท้องถิ่น เช่น "9G8F+5W Zurich, Switzerland" หากไม่พบท้องถิ่นที่เหมาะสมในการย่อรหัส ระบบจะไม่แสดงช่องนี้

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

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

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

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

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

กำหนดตัวเลือกการขอรูปภาพ
maxHeight
ไม่บังคับ
ประเภท: number optional
ความสูงสูงสุดเป็นพิกเซลของรูปภาพที่แสดงผล
maxWidth
ไม่บังคับ
ประเภท: 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
ไม่บังคับ
ประเภท: Array<PlaceAspectRating> optional
แง่มุมที่ได้รับการให้คะแนนโดยรีวิว คะแนนในระดับ 0 ถึง 3
author_url
ไม่บังคับ
ประเภท: string optional
URL ไปยังโปรไฟล์ของผู้รีวิว ค่านี้จะเป็น undefined เมื่อโปรไฟล์ของผู้ตรวจสอบไม่พร้อมใช้งาน
rating
ไม่บังคับ
ประเภท: number optional
คะแนนของรีวิวนี้ ซึ่งเป็นตัวเลขระหว่าง 1.0 ถึง 5.0 (รวมค่าแรกและค่าสุดท้าย)