Places Service

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

ชั้น PlacesService

google.maps.places.PlacesService ชั้น

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

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

PlacesService
PlacesService(attrContainer)
พารามิเตอร์:
สร้างอินสแตนซ์ใหม่ของ PlacesService ที่แสดงการระบุแหล่งที่มาในคอนเทนเนอร์ที่ระบุ
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
พารามิเตอร์:
ค่าที่ส่งคืน: ไม่มี
เรียกดูรายการสถานที่ตามหมายเลขโทรศัพท์ ในกรณีส่วนใหญ่ ควรมีเพียง 1 รายการเท่านั้นในผลการค้นหา แต่หากมีคําขอกํากวมมากกว่า 1 รายการก็อาจแสดงผลได้ PlaceResult ที่ส่งไปยังโค้ดเรียกกลับเป็นชุดย่อยของ PlaceResult แบบเต็ม แอปสามารถรับ PlaceResult ที่ละเอียดมากขึ้นสําหรับแต่ละสถานที่โดยโทรไปที่ PlacesService.getDetails และส่ง PlaceResult.place_id ของสถานที่ที่ต้องการ
findPlaceFromQuery
findPlaceFromQuery(request, callback)
พารามิเตอร์:
ค่าที่ส่งคืน: ไม่มี
เรียกรายการสถานที่ตามสตริงการค้นหา ในกรณีส่วนใหญ่ ควรมีเพียง 1 รายการเท่านั้นในผลการค้นหา แต่หากมีคําขอกํากวมมากกว่า 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

ต้องระบุพารามิเตอร์ของ 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 โดยมีข้อยกเว้นบางประการที่ชัดเจน ตัวอย่างเช่น สหราชอาณาจักร's 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
คําค้นหาของคําขอ เช่น ชื่อสถานที่ ('Eiffel Tower') หมวดหมู่ตามด้วยชื่อสถานที่ ('pizza in New York') หรือชื่อสถานที่ตามด้วยเครื่องหมายระบุตําแหน่งของที่ตั้ง ('Starbucks ในซิดนีย์')
radius optional
ประเภท: number optional
รัศมีของพื้นที่ที่ใช้ในการการให้น้ําหนักผลลัพธ์เมื่อค้นหาสถานที่ มีหน่วยเป็นเมตร
region optional
ประเภท: string optional
รหัสภูมิภาคที่จะลําเอียงไปยังผลลัพธ์ รหัสภูมิภาคยอมรับค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") รหัส ccTLD ส่วนใหญ่เหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นบางประการที่ชัดเจน ตัวอย่างเช่น สหราชอาณาจักร's ccTLD คือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสําหรับนิติบุคคลของ "สหราชอาณาจักรและไอร์แลนด์เหนือ")
type optional
ประเภท: string optional
ค้นหาสถานที่ในประเภทที่ระบุไว้ ระบบจะแปลประเภทดังกล่าวเป็นภาษาท้องถิ่นของสถานที่เป้าหมายของคําขอและใช้เป็นสตริงการค้นหา หากมีการระบุคําค้นหาด้วย คําค้นหานี้ก็จะเชื่อมต่อกับสตริงประเภทที่แปลแล้ว ระบบจะนําผลการค้นหาประเภทอื่นออกจากคําตอบ ใช้ช่องนี้เพื่อทําการค้นหาตามหมวดหมู่ที่ไม่เกี่ยวข้องกับภาษาและภูมิภาค ดูประเภทที่ถูกต้องได้ที่นี่

RankBy (ค่าคงที่)

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

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

ต้องระบุพารามิเตอร์ของ URL &libraries=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 เมื่อเสร็จสิ้นการค้นหา ระบุค่าด้วยค่า หรือโดยใช้ชื่อคงที่&#39 เช่น 'OK' หรือ google.maps.places.PlacesServiceStatus.OK

ต้องระบุพารามิเตอร์ของ URL &libraries=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
ธงระบุสถานะการดําเนินการของสถานที่ หากเป็นธุรกิจ (ระบุว่าสถานที่ดังกล่าวเปิดทําการหรือปิดชั่วคราวหรือถาวร) หากไม่มีข้อมูลอยู่ จะไม่มีการแสดงค่าสถานะในการตอบสนองการค้นหาหรือรายละเอียด
formatted_address optional
ประเภท: string optional
ที่อยู่แบบเต็มของสถานที่
formatted_phone_number optional
ประเภท: string optional
หมายเลขโทรศัพท์ของสถานที่ในรูปแบบตามรูปแบบภูมิภาคของหมายเลข #39 ใช้ได้เฉพาะกับ 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 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 ของเขตเวลาปัจจุบันของสถานที่ในหน่วยนาที เช่น ซิดนีย์ ออสเตรเลีย เวลาออมแสงคือ 11 ชั่วโมงก่อน UTC ดังนั้น utc_offset จะเป็น 660 สําหรับเขตเวลาที่อยู่เบื้องหลัง UTC ออฟเซ็ตเป็นค่าลบ ตัวอย่างเช่น utc_offset คือ -60 สําหรับเคปเวิร์ด ใช้ได้เฉพาะกับ PlacesService.getDetails
utc_offset_minutes optional
ประเภท: number optional
ออฟเซ็ตจากเขตเวลา UTC ของเขตเวลาปัจจุบันของสถานที่ในหน่วยนาที เช่น ซิดนีย์ ออสเตรเลีย เวลาออมแสงคือ 11 ชั่วโมงก่อน UTC ดังนั้น 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

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

อินเทอร์เฟซ Place Geometry

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

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

ต้องระบุพารามิเตอร์ของ 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" หากไม่มีย่านที่เหมาะสมที่สามารถย่อโค้ดได้ ระบบจะไม่สนใจช่องนี้

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

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

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

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

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

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

อินเทอร์เฟซ 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 ไปยังรูปโปรไฟล์ของ Revwer'
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 (รวมเลขตัวแรกและตัวสุดท้าย)