ผลิตภัณฑ์หรือฟีเจอร์นี้อยู่ในสถานะเดิม ดูข้อมูลเพิ่มเติมเกี่ยวกับสถานะเดิมได้ที่ผลิตภัณฑ์และฟีเจอร์เดิม หากต้องการย้ายข้อมูลไปยัง Places API (ใหม่) โปรดดูคำแนะนำในการย้ายข้อมูล

ค้นหาสถานที่ (เดิม)

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

หมายเหตุ: ไลบรารีฝั่งเซิร์ฟเวอร์ และฝั่งไคลเอ็นต์

นอกจากนี้ Places API ยังพร้อมใช้งานกับไคลเอ็นต์ Java, ไคลเอ็นต์ Python, ไคลเอ็นต์ Go และไคลเอ็นต์ Node.js สำหรับบริการของ Google Maps ด้วย Places API และไลบรารีของไคลเอ็นต์มีไว้สำหรับ ใช้ในแอปพลิเคชันเซิร์ฟเวอร์

หากคุณกำลังสร้างแอปพลิเคชันฝั่งไคลเอ็นต์ โปรดดู Places SDK สำหรับ Android (ใหม่), Places SDK สำหรับ iOS (ใหม่) และ Places Library, Maps JavaScript API

คำขอค้นหาสถานที่ (เดิม) จะรับข้อมูลข้อความและแสดงผลสถานที่ อินพุต อาจเป็นข้อมูลข้อความของ Places ทุกชนิด เช่น ชื่อ ที่อยู่ หรือหมายเลข โทรศัพท์ คำขอต้องเป็นสตริง คำขอค้นหาสถานที่ (เดิม) ที่ใช้ข้อมูลที่ไม่ใช่สตริง เช่น พิกัดละติจูด/ลองจิจูดหรือ Plus Code จะทำให้เกิดข้อผิดพลาด

คำขอค้นหาสถานที่ (เดิม) จะแสดงผลชุดย่อยของฟิลด์ที่คำขอ รายละเอียดสถานที่ (เดิม) แสดงผล ดูข้อมูลเพิ่มเติมเกี่ยวกับฟิลด์ที่ใช้ไม่ได้ในคำขอ ค้นหาสถานที่ (เดิม) ได้ที่ การรองรับฟิลด์ของ Places API หากระบบไม่แสดงช่องที่ต้องการ คุณสามารถใช้ ค้นหาสถานที่ (เดิม) เพื่อรับ place_id, จากนั้นใช้รหัสดังกล่าวเพื่อส่งคำขอ รายละเอียดสถานที่ (เดิม)

คำขอค้นหาสถานที่ (เดิม)

คำขอค้นหาสถานที่ (เดิม) คือ HTTP URL ในรูปแบบต่อไปนี้

https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters

โดย output อาจมีค่าใดค่าหนึ่งต่อไปนี้

json (แนะนํา) ระบุเอาต์พุตใน JavaScript Object Notation (JSON)
xml ระบุเอาต์พุตเป็น XML

ต้องระบุพารามิเตอร์บางอย่างเพื่อเริ่มคำขอค้นหาสถานที่ (เดิม) พารามิเตอร์ทั้งหมดจะคั่นด้วยเครื่องหมายแอมเพอร์แซนด์ (&) ตาม มาตรฐานใน URL

พารามิเตอร์ที่จำเป็น

อินพุต

สตริงข้อความที่จะค้นหา เช่น "ร้านอาหาร" หรือ "123 ถนนเมน" ต้องเป็นชื่อสถานที่ ที่อยู่ หรือหมวดหมู่ของ สถานประกอบการ อินพุตประเภทอื่นๆ อาจทำให้เกิดข้อผิดพลาดและไม่รับประกันว่าจะแสดงผลลัพธ์ที่ถูกต้อง Places API จะแสดงรายการที่ตรงกัน โดยอิงตามสตริงนี้ และจัดลำดับผลลัพธ์ตาม ความเกี่ยวข้องที่รับรู้
inputtype

ประเภทของอินพุต ซึ่งอาจเป็น textquery หรือ phonenumber หมายเลขโทรศัพท์ต้องอยู่ในรูปแบบระหว่างประเทศ (มีเครื่องหมายบวก ("+") นำหน้า ตามด้วยรหัสประเทศ แล้วจึงเป็น หมายเลขโทรศัพท์) ดูข้อมูลเพิ่มเติมได้ที่ คำแนะนำ E.164 ของ ITU

พารามิเตอร์ที่ไม่บังคับ

Fields

ข้อควรระวัง: คำขอการค้นหาสถานที่ และคำขอรายละเอียดสถานที่ จะไม่แสดงฟิลด์เดียวกัน คำขอการค้นหาสถานที่จะแสดงผลชุดย่อยของฟิลด์ที่คำขอรายละเอียดสถานที่แสดงผล หากฟิลด์ที่ต้องการไม่ได้ แสดงผลโดยการค้นหาสถานที่ คุณสามารถใช้การค้นหาสถานที่เพื่อรับ place_id จากนั้นใช้รหัสสถานที่ดังกล่าวเพื่อส่งคำขอรายละเอียดสถานที่ ดูข้อมูลเพิ่มเติมเกี่ยวกับฟิลด์ที่ใช้ไม่ได้ในคำขอการค้นหาสถานที่ได้ที่ การรองรับฟิลด์ของ Places API

ใช้พารามิเตอร์ฟิลด์เพื่อระบุรายการประเภทข้อมูลสถานที่ที่คั่นด้วยคอมมาเพื่อแสดงผล ตัวอย่างเช่น fields=formatted_address,name,geometry ใช้เครื่องหมายทับ เมื่อระบุค่าแบบผสม ตัวอย่างเช่น opening_hours/open_now

ฟิลด์แบ่งออกเป็น 3 หมวดหมู่การเรียกเก็บเงิน ได้แก่ พื้นฐาน รายชื่อติดต่อ และ บรรยากาศ ระบบจะเรียกเก็บเงินสำหรับฟิลด์พื้นฐานตามราคาฐาน และเรียกเก็บเงินสำหรับฟิลด์รายชื่อติดต่อและฟิลด์บรรยากาศในอัตราที่สูงกว่า ระบบจะเรียกเก็บเงิน SKU พื้นฐาน, SKU รายชื่อติดต่อ และ SKU บรรยากาศเพิ่มเติมจาก SKU พื้นฐาน (รายละเอียดสถานที่, ค้นหาสถานที่, การค้นหาในบริเวณใกล้เคียง หรือการค้นหาข้อความ) สำหรับคำขอที่ทริกเกอร์ SKU เหล่านี้ ดูข้อมูลเพิ่มเติมได้ที่ตารางราคา

พื้นฐาน

หมวดหมู่พื้นฐานมีช่องต่อไปนี้ address_components, adr_address business_status, formatted_address geometry, icon, icon_mask_base_uri icon_background_color, name permanently_closed (เลิกใช้งานแล้ว), photo, place_id, plus_code type, url, utc_offset vicinity, wheelchair_accessible_entrance

การติดต่อ

หมวดหมู่ "ติดต่อ" มีช่องต่อไปนี้ current_opening_hours, formatted_phone_number international_phone_number, opening_hours secondary_opening_hours, website

บรรยากาศ

หมวดหมู่บรรยากาศมีช่องต่อไปนี้ curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total

หมายเหตุ: ระบบจะแสดงการแสดงที่มา html_attributions พร้อมกับการเรียกใช้ทุกครั้งเสมอ ไม่ว่าคุณจะขอฟิลด์ดังกล่าวหรือไม่ก็ตาม
ภาษา

ภาษาที่จะแสดงผลลัพธ์
- ดู รายการภาษาที่รองรับ Google มักจะอัปเดตภาษาที่รองรับอยู่เสมอ ดังนั้นรายการนี้อาจไม่ครอบคลุมทั้งหมด
- หากไม่ได้ระบุ language API จะพยายามใช้ภาษาที่ต้องการตามที่ระบุไว้ในส่วนหัว Accept-Language
- API จะพยายามอย่างเต็มที่เพื่อให้ที่อยู่ที่อ่านง่ายสำหรับทั้งผู้ใช้และคนในพื้นที่ เพื่อให้บรรลุเป้าหมายดังกล่าว ระบบจะแสดงที่อยู่ในภาษาท้องถิ่น โดยแปลงเป็นสคริปต์ที่ผู้ใช้อ่านได้หากจำเป็น ตามภาษาที่ต้องการ ส่วนที่อยู่อื่นๆ จะแสดงในภาษาที่ต้องการ คอมโพเนนต์ของที่อยู่ ทั้งหมดจะแสดงในภาษาเดียวกัน ซึ่งเลือกจากคอมโพเนนต์แรก
- หากชื่อไม่มีในภาษาที่ต้องการ API จะใช้ชื่อที่ใกล้เคียงที่สุด
- ภาษาที่ต้องการมีผลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกที่จะแสดงผล และลำดับที่แสดงผล Geocoder จะตีความตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อสำหรับประเภทถนน หรือคำพ้องความหมายที่อาจ ใช้ได้ในภาษาหนึ่งแต่ใช้ไม่ได้ในอีกภาษาหนึ่ง เช่น utca และ tér เป็นคำพ้องความหมายของถนนในภาษาฮังการี
locationbias

ต้องการผลลัพธ์ในพื้นที่ที่ระบุโดยการระบุรัศมีและ lat/lng หรือคู่ lat/lng 2 คู่ที่แสดงจุดของสี่เหลี่ยมผืนผ้า หากไม่ได้ระบุพารามิเตอร์นี้ API จะใช้การให้น้ำหนักพิเศษตามที่อยู่ IP โดยค่าเริ่มต้น
- ความเอนเอียงของ IP: สั่งให้ API ใช้การปรับที่อยู่ IP ส่งสตริง ipbias (ตัวเลือกนี้ไม่มีพารามิเตอร์เพิ่มเติม)
- Circular: สตริงที่ระบุรัศมีเป็นเมตร รวมถึงละติจูด/ลองจิจูดในรูปแบบทศนิยม องศา โปรดใช้รูปแบบต่อไปนี้ circle:radius@lat,lng
- สี่เหลี่ยมผืนผ้า: สตริงที่ระบุคู่ละติจูด/ลองจิจูด 2 คู่ในหน่วยองศาทศนิยม ซึ่งแสดงจุดใต้/ตะวันตกและเหนือ/ตะวันออกของสี่เหลี่ยมผืนผ้า ใช้ รูปแบบต่อไปนี้rectangle:south,west|north,east โปรดทราบ ว่าค่าตะวันออก/ตะวันตกจะอยู่ในช่วง -180, 180 และ ค่าเหนือ/ใต้จะอยู่ในช่วง -90, 90

หมายเหตุ: หากคุณละเว้นพารามิเตอร์ fields จากคำขอ ค้นหาสถานที่ (เดิม) ระบบจะแสดงผลเฉพาะ place_id สำหรับผลลัพธ์

ตัวอย่าง ค้นหาสถานที่ (เดิม)

ตัวอย่างต่อไปนี้แสดงคำขอค้นหาสถานที่ (เดิม) สำหรับ "Museum of Contemporary Art Australia" ซึ่งรวมถึงฟิลด์ photos, formatted_address, name, rating, opening_hours และ geometry

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

ตัวอย่างต่อไปนี้แสดงคำขอ ค้นหาสถานที่ (เดิม) สำหรับ "Mongolian Grill" โดยใช้ พารามิเตอร์ locationbias เพื่อให้แสดงผลลัพธ์ภายใน 2,000 เมตรจากพิกัดที่ระบุ

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

ตัวอย่างต่อไปนี้แสดงคำขอค้นหาสถานที่ (เดิม) สำหรับหมายเลขโทรศัพท์ โปรดทราบว่าระบบได้เข้ารหัส คำนำหน้าการโทรระหว่างประเทศ "+" เป็น %2B เพื่อให้คำขอนี้เป็น URL ที่เป็นไปตามข้อกำหนด หากไม่ได้เข้ารหัสไว้ คำนำหน้า + จะถอดรหัสเป็นช่องว่างในเซิร์ฟเวอร์ ซึ่งจะทำให้การค้นหาหมายเลขโทรศัพท์ไม่ถูกต้อง

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

การตอบกลับของ ค้นหาสถานที่ (เดิม)

การตอบกลับ ค้นหาสถานที่ (เดิม) จะมีเฉพาะประเภทข้อมูลที่ระบุโดยใช้พารามิเตอร์fields และhtml_attributions ตัวอย่างต่อไปนี้แสดงการตอบกลับคำขอค้นหาสถานที่ (เดิม) สำหรับ "Museum of Contemporary Art Australia" ซึ่งรวมถึงฟิลด์ formatted_address, geometry, name, opening_hours, photos, rating

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

PlacesFindPlaceFromTextResponse

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`candidates`	ต้องระบุ	Array<Place>	มีอาร์เรย์ของตัวเลือกสถานที่ คำขอการค้นหาสถานที่ จะแสดงผลชุดย่อยของฟิลด์ที่คำขอรายละเอียดสถานที่แสดงผล หากการค้นหาสถานที่ ไม่แสดงฟิลด์ที่ต้องการ คุณสามารถใช้การค้นหาสถานที่ เพื่อรับ place_id แล้วใช้รหัสสถานที่ดังกล่าวเพื่อส่งคำขอรายละเอียดสถานที่ ดูข้อมูลเพิ่มเติมได้ที่สถานที่
`status`	ต้องระบุ	PlacesSearchStatus	มีสถานะของคำขอ และอาจมีข้อมูลการแก้ไขข้อบกพร่อง เพื่อช่วยคุณติดตามหาสาเหตุที่คำขอไม่สำเร็จ ดูข้อมูลเพิ่มเติมได้ที่ PlacesSearchStatus
`error_message`	ไม่บังคับ	สตริง	เมื่อบริการแสดงรหัสสถานะอื่นที่ไม่ใช่ `OK<` อาจมีฟิลด์ `error_message` เพิ่มเติมภายในออบเจ็กต์การตอบกลับ ฟิลด์นี้ มีข้อมูลโดยละเอียดเกี่ยวกับสาเหตุที่อยู่เบื้องหลังรหัสสถานะ ที่ระบุ ระบบอาจไม่แสดงช่องนี้เสมอไป และเนื้อหาของช่องอาจมีการเปลี่ยนแปลง
`info_messages`	ไม่บังคับ	Array<string>	เมื่อบริการแสดงข้อมูลเพิ่มเติมเกี่ยวกับข้อกำหนดของคำขอ อาจมี`info_messages`ฟิลด์เพิ่มเติมภายในออบเจ็กต์การตอบกลับ ระบบจะแสดงฟิลด์นี้ สําหรับคําขอที่สําเร็จเท่านั้น แอตทริบิวต์นี้อาจไม่แสดงเสมอไปและเนื้อหาอาจมีการเปลี่ยนแปลง

PlacesSearchStatus

รหัสสถานะที่บริการส่งกลับ

OK ซึ่งหมายความว่าคำขอ API สำเร็จ
ZERO_RESULTS ซึ่งหมายความว่าการค้นหาสำเร็จแต่ ไม่พบผลลัพธ์ ปัญหานี้อาจเกิดขึ้นหากการค้นหาผ่าน latlng ในสถานที่ตั้งระยะไกล
INVALID_REQUEST แสดงว่าคำขอ API มีรูปแบบไม่ถูกต้อง โดยทั่วไปเกิดจากไม่มีพารามิเตอร์การค้นหาที่จำเป็น (location หรือ radius)
OVER_QUERY_LIMIT ที่ระบุข้อมูลต่อไปนี้
- คุณส่งคำขอเกินขีดจำกัด QPS
- บัญชีของคุณไม่ได้เปิดใช้การเรียกเก็บเงิน
- ใช้เครดิต $200 รายเดือนหรือโควต้าการใช้งานที่กำหนดเองเกินแล้ว
- วิธีการชำระเงินที่ระบุใช้ไม่ได้อีกต่อไป (เช่น บัตรเครดิตหมดอายุ)
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีแก้ไขข้อผิดพลาดนี้ได้ที่ คำถามที่พบบ่อยเกี่ยวกับ Maps
REQUEST_DENIED ซึ่งระบุว่าคำขอของคุณถูกปฏิเสธ โดยทั่วไปเนื่องจากสาเหตุต่อไปนี้
- คำขอไม่มีคีย์ API
- พารามิเตอร์ key ไม่ถูกต้อง
UNKNOWN_ERROR แสดงว่าเกิดข้อผิดพลาดที่ไม่รู้จัก

สถานที่

แอตทริบิวต์ที่อธิบายสถานที่ แอตทริบิวต์บางอย่างอาจไม่พร้อมใช้งานสำหรับสถานที่บางประเภท

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`address_components`	ไม่บังคับ	Array<`AddressComponent`>	อาร์เรย์ที่มีคอมโพเนนต์แยกต่างหากที่ใช้ได้กับที่อยู่นี้ ดูข้อมูลเพิ่มเติมได้ที่ `AddressComponent`
`adr_address`	ไม่บังคับ	สตริง	การแสดงที่อยู่ของสถานที่ใน รูปแบบขนาดเล็ก adr
`business_status`	ไม่บังคับ	สตริง	ระบุสถานะการดำเนินงานของสถานที่ หากเป็นธุรกิจ หากไม่มีข้อมูลอยู่ ระบบจะไม่แสดง `business_status` The allowed values include: `OPERATIONAL`, `CLOSED_TEMPORARILY`, and `CLOSED_PERMANENTLY`
`curbside_pickup`	ไม่บังคับ	บูลีน	ระบุว่าธุรกิจรองรับการรับสินค้าโดยไม่ต้องลงจากรถหรือไม่
`current_opening_hours`	ไม่บังคับ	PlaceOpeningHours	มีเวลาทำการในอีก 7 วันถัดไป (รวมถึงวันนี้) ระยะเวลาจะเริ่มตั้งแต่เที่ยงคืนของวันที่ส่งคำขอ และสิ้นสุดเวลา 23:59 น. ในอีก 6 วันต่อมา ฟิลด์นี้ประกอบด้วย `special_days`ฟิลด์ย่อยของเวลาทำการทั้งหมด ซึ่งตั้งค่าสำหรับวันที่ มีเวลาทำการพิเศษ ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHours
`delivery`	ไม่บังคับ	บูลีน	ระบุว่าธุรกิจรองรับการนำส่งหรือไม่
`dine_in`	ไม่บังคับ	บูลีน	ระบุว่าธุรกิจรองรับตัวเลือกที่นั่งในร่มหรือกลางแจ้ง หรือไม่
`editorial_summary`	ไม่บังคับ	PlaceEditorialSummary	มีสรุปของสถานที่ ข้อมูลสรุปประกอบด้วยภาพรวมที่เป็นข้อความ และยังมีรหัสภาษาสำหรับภาพรวมเหล่านี้ด้วย (หากมี) ข้อความสรุปต้องแสดงตามที่ระบุไว้และจะ แก้ไขหรือเปลี่ยนแปลงไม่ได้ ดูข้อมูลเพิ่มเติมได้ที่ PlaceEditorialSummary
`formatted_address`	ไม่บังคับ	สตริง	สตริงที่มีที่อยู่ที่มนุษย์อ่านได้ของสถานที่นี้ โดยส่วนใหญ่แล้วที่อยู่นี้จะเทียบเท่ากับที่อยู่ทางไปรษณีย์ โปรดทราบว่า บางประเทศ เช่น สหราชอาณาจักร ไม่อนุญาตให้เผยแพร่ที่อยู่ไปรษณีย์จริงเนื่องจากข้อจำกัดด้านการอนุญาตให้ใช้สิทธิ ที่อยู่ที่จัดรูปแบบแล้วประกอบด้วยคอมโพเนนต์ที่อยู่อย่างน้อย 1 รายการ ตามตรรกะ เช่น ที่อยู่ "111 8th Avenue, New York, NY" ประกอบด้วยคอมโพเนนต์ต่อไปนี้ "111" (หมายเลขถนน), "8th Avenue" (เส้นทาง), "New York" (เมือง) และ "NY" (รัฐในสหรัฐอเมริกา) อย่าแยกวิเคราะห์ที่อยู่ที่จัดรูปแบบแล้วโดยใช้โปรแกรม แต่คุณควรใช้คอมโพเนนต์ของที่อยู่แต่ละรายการ ซึ่งการตอบกลับจาก API จะรวมไว้ด้วยนอกเหนือจากฟิลด์ที่อยู่ที่จัดรูปแบบแล้ว
`formatted_phone_number`	ไม่บังคับ	สตริง	มีหมายเลขโทรศัพท์ของสถานที่ใน รูปแบบท้องถิ่น
`geometry`	ไม่บังคับ	`Geometry`	มีตำแหน่งและวิวพอร์ตสำหรับตำแหน่ง ดูข้อมูลเพิ่มเติมได้ที่ `Geometry`
`icon`	ไม่บังคับ	สตริง	มี URL ของไอคอนที่แนะนำซึ่งอาจแสดงต่อผู้ใช้ เมื่อระบุผลลัพธ์นี้บนแผนที่
`icon_background_color`	ไม่บังคับ	สตริง	มีรหัสสี HEX เริ่มต้นสำหรับหมวดหมู่ของสถานที่
`icon_mask_base_uri`	ไม่บังคับ	สตริง	มี URL ของไอคอนที่แนะนำ โดยไม่รวมนามสกุลประเภทไฟล์ `.svg` หรือ `.png`
`international_phone_number`	ไม่บังคับ	สตริง	มีหมายเลขโทรศัพท์ของสถานที่ในรูปแบบระหว่างประเทศ รูปแบบระหว่างประเทศจะมีรหัสประเทศและนำหน้าด้วยเครื่องหมายบวก (+) ตัวอย่างเช่น international_phone_number สำหรับ สำนักงานของ Google ในซิดนีย์ ออสเตรเลีย คือ `+61 2 9374 4000`
`name`	ไม่บังคับ	สตริง	มีชื่อที่มนุษย์อ่านได้สำหรับผลลัพธ์ที่แสดง สำหรับ`establishment`ผลการค้นหา โดยปกติแล้วจะเป็น ชื่อธุรกิจที่กำหนดเป็น Canonical
`opening_hours`	ไม่บังคับ	PlaceOpeningHours	มีเวลาทำการปกติ ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHours
`permanently_closed`	ไม่บังคับ	บูลีน	`permanently_closed` เลิกใช้งานแล้ว ใช้ `business_status` เพื่อดูสถานะการดำเนินงานของ ธุรกิจ
`photos`	ไม่บังคับ	Array<PlacePhoto>	อาร์เรย์ของออบเจ็กต์รูปภาพ ซึ่งแต่ละออบเจ็กต์มีข้อมูลอ้างอิงถึงรูปภาพ คำขออาจแสดงรูปภาพได้สูงสุด 10 รูป ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปภาพสถานที่และวิธีใช้รูปภาพในแอปพลิเคชันได้ในเอกสารประกอบรูปภาพสถานที่ ดูข้อมูลเพิ่มเติมได้ที่ PlacePhoto
`place_id`	ไม่บังคับ	สตริง	ตัวระบุที่เป็นข้อความซึ่งระบุสถานที่ที่ไม่ซ้ำกัน หากต้องการดึงข้อมูลเกี่ยวกับสถานที่ ให้ส่งตัวระบุนี้ใน ฟิลด์ `place_id` ของคำขอ Places API ดูข้อมูลเพิ่มเติม เกี่ยวกับรหัสสถานที่ได้ที่ ภาพรวมรหัสสถานที่
`plus_code`	ไม่บังคับ	`PlusCode`	การอ้างอิงตำแหน่งที่เข้ารหัสซึ่งได้มาจากพิกัดละติจูดและลองจิจูด ซึ่งแสดงถึงพื้นที่: 1/8000 ขององศาโดย 1/8000 ขององศา (ประมาณ 14 ม. x 14 ม. ที่เส้นศูนย์สูตร) หรือเล็กกว่า คุณใช้ Plus Codes แทนที่อยู่ได้ใน สถานที่ที่ไม่มีที่อยู่ (ไม่มีการระบุหมายเลขอ้างอิงอาคารหรือ ไม่มีการตั้งชื่อถนน) ดู Open Location Code และ Plus Code ดูข้อมูลเพิ่มเติมได้ที่ `PlusCode`
`price_level`	ไม่บังคับ	ตัวเลข	ระดับราคาของสถานที่ในระดับ 0 ถึง 4 จำนวนเงินที่แน่นอน ซึ่งระบุด้วยค่าที่เฉพาะเจาะจงจะแตกต่างกันไปในแต่ละภูมิภาค ระดับราคา จะตีความดังนี้ 0 ฟรี 1 ไม่แพง 2 ปานกลาง 3 แพง 4 แพงมาก
`rating`	ไม่บังคับ	ตัวเลข	มีการให้คะแนนสถานที่ตั้งแต่ 1.0 ถึง 5.0 โดยอิงตามรีวิวของผู้ใช้ที่รวบรวมไว้
`reference`	ไม่บังคับ	สตริง	`reference` เลิกใช้งานแล้ว
`reservable`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่รองรับการจองหรือไม่
`reviews`	ไม่บังคับ	Array<PlaceReview>	อาร์เรย์ JSON ของรีวิวสูงสุด 5 รายการ โดยค่าเริ่มต้น ระบบจะจัดเรียงรีวิว ตามลำดับความเกี่ยวข้อง ใช้พารามิเตอร์คำขอ `reviews_sort` เพื่อควบคุมการจัดเรียง สำหรับ `most_relevant` (ค่าเริ่มต้น) รีวิวจะจัดเรียงตาม ความเกี่ยวข้อง โดยบริการจะให้ความสำคัญกับผลลัพธ์เพื่อแสดงรีวิวที่ เขียนเป็นภาษาที่ต้องการเป็นภาษาแรก สำหรับ `newest` ระบบจะจัดเรียงรีวิวตามลำดับเวลา และภาษาที่ต้องการจะไม่ส่งผลต่อลำดับการจัดเรียง Google ขอแนะนำให้ระบุให้ผู้ใช้ทราบว่าผลการค้นหาจัดเรียงตาม `most_relevant` หรือ `newest` ดูข้อมูลเพิ่มเติมได้ที่ PlaceReview
`scope`	ไม่บังคับ	สตริง	`scope` เลิกใช้งานแล้ว
`secondary_opening_hours`	ไม่บังคับ	Array<PlaceOpeningHours>	มีอาร์เรย์ของรายการสำหรับ 7 วันถัดไป ซึ่งรวมถึง ข้อมูลเกี่ยวกับเวลาทำการรองของธุรกิจ เวลาทำการรองจะ แตกต่างจากเวลาทำการหลักของธุรกิจ เช่น ร้านอาหาร สามารถระบุเวลาทำการของไดรฟ์ทรูหรือเวลาทำการของบริการนำส่งเป็นเวลาทำการรองได้ ฟิลด์นี้จะป้อนข้อมูลในฟิลด์ย่อย `type` ซึ่ง ดึงมาจากรายการประเภทเวลาทำการที่กำหนดไว้ล่วงหน้า (เช่น `DRIVE_THROUGH`, `PICKUP` หรือ `TAKEOUT`) ตามประเภทของสถานที่ ฟิลด์นี้ มี`special_days`ฟิลด์ย่อยของเวลาทำการทั้งหมด ซึ่งตั้งค่า สำหรับวันที่ที่มีเวลาทำการพิเศษ ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHours
`serves_beer`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่นั้นเสิร์ฟเบียร์หรือไม่
`serves_breakfast`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่ให้บริการอาหารเช้าหรือไม่
`serves_brunch`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่ให้บริการอาหารมื้อสายหรือไม่
`serves_dinner`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่ให้บริการอาหารเย็นหรือไม่
`serves_lunch`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่ให้บริการอาหารกลางวันหรือไม่
`serves_vegetarian_food`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่นี้เสิร์ฟอาหารมังสวิรัติหรือไม่
`serves_wine`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่นี้เสิร์ฟไวน์หรือไม่
`takeout`	ไม่บังคับ	บูลีน	ระบุว่าธุรกิจรองรับการสั่งกลับบ้านหรือไม่
`types`	ไม่บังคับ	Array<string>	มีอาร์เรย์ของประเภทฟีเจอร์ที่อธิบายผลลัพธ์ที่ระบุ ดูรายการ ประเภทที่รองรับ
`url`	ไม่บังคับ	สตริง	มี URL ของหน้า Google อย่างเป็นทางการของสถานที่นี้ ซึ่งจะเป็นหน้าของ Google ที่มีข้อมูลที่ดีที่สุดเกี่ยวกับสถานที่นั้นๆ แอปพลิเคชันต้องลิงก์ไปยังหรือฝังหน้านี้ ในหน้าจอที่แสดงผลลัพธ์โดยละเอียดเกี่ยวกับสถานที่แก่ผู้ใช้
`user_ratings_total`	ไม่บังคับ	ตัวเลข	จำนวนรีวิวทั้งหมดของสถานที่นี้ ไม่ว่าจะมีหรือไม่มีข้อความก็ตาม
`utc_offset`	ไม่บังคับ	ตัวเลข	มีจำนวนนาทีที่เขตเวลาปัจจุบันของสถานที่นี้ ออฟเซ็ตจาก UTC เช่น สำหรับสถานที่ในซิดนีย์ ออสเตรเลียในช่วง เวลาออมแสง ค่านี้จะเป็น 660 (+11 ชั่วโมงจาก UTC) และสำหรับ สถานที่ในแคลิฟอร์เนียที่อยู่นอกช่วงเวลาออมแสง ค่านี้จะเป็น -480 (-8 ชั่วโมงจาก UTC)
`vicinity`	ไม่บังคับ	สตริง	สำหรับสถานประกอบการ (`types:["establishment", ...])` ผลลัพธ์เท่านั้น) ฟิลด์ `vicinity` จะมีที่อยู่ที่ เรียบง่ายของสถานที่ ซึ่งรวมถึงชื่อถนน หมายเลขถนน และ ย่าน แต่ไม่มีจังหวัด/รัฐ รหัสไปรษณีย์ หรือประเทศ สำหรับผลลัพธ์อื่นๆ ทั้งหมด ฟิลด์ `vicinity` จะมี ชื่อของสถานที่ราชการ (`types:["political", ...]`) ที่แคบที่สุดซึ่งอยู่ในที่อยู่ของผลลัพธ์ เนื้อหานี้มีไว้ให้อ่านตามที่แสดง อย่าแยกวิเคราะห์ที่อยู่ที่จัดรูปแบบแล้วแบบเป็นโปรแกรม
`website`	ไม่บังคับ	สตริง	เว็บไซต์ที่เชื่อถือได้ของสถานที่นี้ เช่น หน้าแรกของธุรกิจ
`wheelchair_accessible_entrance`	ไม่บังคับ	บูลีน	ระบุว่าสถานที่นั้นมีทางเข้าที่ รองรับเก้าอี้รถเข็นหรือไม่

PlaceEditorialSummary

มีสรุปของสถานที่ ข้อมูลสรุปประกอบด้วยภาพรวมที่เป็นข้อความ และยังมีรหัสภาษาสำหรับข้อมูลเหล่านี้ด้วย (หากมี) ข้อความสรุปต้อง แสดงตามที่เป็นอยู่ และจะแก้ไขหรือเปลี่ยนแปลงไม่ได้

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`language`	ไม่บังคับ	สตริง	ภาษาของฟิลด์ก่อนหน้า May not always be present.
`overview`	ไม่บังคับ	สตริง	ข้อความสรุปความยาวปานกลางของสถานที่

PlaceOpeningHours

ออบเจ็กต์ที่อธิบายเวลาทำการของสถานที่

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`open_now`	ไม่บังคับ	บูลีน	ค่าบูลีนที่ระบุว่าสถานที่เปิดอยู่หรือไม่ในเวลาปัจจุบัน
`periods`	ไม่บังคับ	Array<PlaceOpeningHoursPeriod>	อาร์เรย์ของช่วงเวลาเปิดทำการที่ครอบคลุม 7 วัน โดยเริ่มจาก วันอาทิตย์ตามลำดับเวลา ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHoursPeriod
`special_days`	ไม่บังคับ	Array<PlaceSpecialDay>	อาร์เรย์ของรายการสูงสุด 7 รายการที่สอดคล้องกับ 7 วันถัดไป ดูข้อมูลเพิ่มเติมได้ที่ PlaceSpecialDay
`type`	ไม่บังคับ	สตริง	สตริงประเภทที่ใช้ระบุประเภทของเวลาทำการรอง (เช่น `DRIVE_THROUGH`, `HAPPY_HOUR`, `DELIVERY`, `TAKEOUT`, `KITCHEN`, `BREAKFAST`, `LUNCH`, `DINNER`, `BRUNCH`, `PICKUP`, `SENIOR_HOURS`) ตั้งค่าสำหรับ `secondary_opening_hours` เท่านั้น
`weekday_text`	ไม่บังคับ	Array<string>	อาร์เรย์ของสตริงที่อธิบายเวลาทำการของสถานที่ในรูปแบบข้อความที่มนุษย์อ่านได้

PlaceOpeningHoursPeriod

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`open`	ต้องระบุ	PlaceOpeningHoursPeriodDetail	มีออบเจ็กต์วันและเวลา 2 รายการที่อธิบายเวลาที่สถานที่ เปิดทำการ ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHoursPeriodDetail
`close`	ไม่บังคับ	PlaceOpeningHoursPeriodDetail	อาจมีออบเจ็กต์วันและเวลา 1 คู่ที่อธิบายเวลาที่สถานที่ ปิด หากสถานที่เปิดตลอดเวลา ส่วนปิดจะหายไปจากการตอบกลับ ไคลเอ็นต์สามารถใช้การระบุว่าเปิดตลอดเวลา เป็นช่วงเวลาที่เปิดซึ่งมีวันที่มีค่า `0` และเวลา ที่มีค่า `0000` โดยไม่มี `close` ดูข้อมูลเพิ่มเติมได้ที่ PlaceOpeningHoursPeriodDetail

PlaceSpecialDay

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`date`	ไม่บังคับ	สตริง	วันที่ที่แสดงในรูปแบบ RFC3339 ในเขตเวลาท้องถิ่นของสถานที่ เช่น 2010-12-31
`exceptional_hours`	ไม่บังคับ	บูลีน	จริงหากมีเวลาทำการพิเศษสำหรับวันนี้ หาก `true` แสดงว่ามีข้อยกเว้นอย่างน้อย 1 รายการ สำหรับวันนี้ ข้อยกเว้นทำให้ค่าต่างๆ เกิดขึ้นใน ฟิลด์ย่อยของ `current_opening_hours` และ `secondary_opening_hours` เช่น `periods`, `weekday_text`, `open_now` ข้อยกเว้น มีผลกับเวลาทำการ และระบบจะใช้เวลาทำการเพื่อสร้างฟิลด์อื่นๆ

PlaceOpeningHoursPeriodDetail

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`day`	ต้องระบุ	ตัวเลข	ตัวเลขตั้งแต่ 0-6 ซึ่งสอดคล้องกับวันในสัปดาห์ โดยเริ่ม ในวันอาทิตย์ เช่น 2 หมายถึงวันอังคาร
`time`	ต้องระบุ	สตริง	อาจมีเวลาของวันในรูปแบบ hhmm แบบ 24 ชั่วโมง ค่าอยู่ในช่วง 0000–2359 ระบบจะรายงานเวลาในเขตเวลาของสถานที่
`date`	ไม่บังคับ	สตริง	วันที่ที่แสดงในรูปแบบ RFC3339 ในเขตเวลาท้องถิ่นของสถานที่ เช่น 2010-12-31
`truncated`	ไม่บังคับ	บูลีน	เป็นจริงหากมีการตัดช่วงเวลาที่ระบุเนื่องจากกำหนดเวลา 7 วัน โดยช่วงเวลาเริ่มต้นก่อนเที่ยงคืนในวันที่ส่งคำขอ และ/หรือสิ้นสุดตั้งแต่เที่ยงคืนเป็นต้นไปในวันสุดท้าย พร็อพเพอร์ตี้นี้ บ่งบอกว่าระยะเวลาเปิดหรือปิดอาจขยายออกไปหลังจาก กำหนดเวลา 7 วันนี้

PlacePhoto

รูปภาพของสถานที่ คุณเข้าถึงรูปภาพได้โดยใช้ API Place Photo โดยใช้ URL ในรูปแบบต่อไปนี้

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

ดูข้อมูลเพิ่มเติมได้ที่ รูปภาพสถานที่

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`height`	ต้องระบุ	ตัวเลข	ความสูงของรูปภาพ
`html_attributions`	ต้องระบุ	Array<string>	การระบุแหล่งที่มาของ HTML สำหรับรูปภาพ
`photo_reference`	ต้องระบุ	สตริง	สตริงที่ใช้ระบุรูปภาพเมื่อคุณส่งคำขอ Photo
`width`	ต้องระบุ	ตัวเลข	ความกว้างของรูปภาพ

PlaceReview

รีวิวสถานที่ที่ผู้ใช้ส่ง

ช่อง	ต้องระบุ	ประเภท	คำอธิบาย
`author_name`	ต้องระบุ	สตริง	ชื่อของผู้ใช้ที่ส่งรีวิว รีวิวที่ไม่ระบุชื่อจะ ระบุแหล่งที่มาเป็น "ผู้ใช้ Google"
`rating`	ต้องระบุ	ตัวเลข	คะแนนโดยรวมของผู้ใช้สำหรับสถานที่นี้ ซึ่งเป็นเลขจำนวนเต็ม ตั้งแต่ 1 ถึง 5
`relative_time_description`	ต้องระบุ	สตริง	เวลาที่ส่งรีวิวเป็นข้อความ โดยอิงตามเวลาปัจจุบัน
`time`	ต้องระบุ	ตัวเลข	เวลาที่ส่งรีวิว โดยวัดเป็นจำนวน วินาทีนับตั้งแต่เที่ยงคืนของวันที่ 1 มกราคม 1970 UTC
`author_url`	ไม่บังคับ	สตริง	URL ของโปรไฟล์ Local Guide ใน Google Maps ของผู้ใช้ หากมี
`language`	ไม่บังคับ	สตริง	รหัสภาษา IETF ที่ระบุภาษาของรีวิวที่แสดงผล ช่องนี้มีเฉพาะแท็กภาษาหลักเท่านั้น ไม่มีแท็กรองที่ระบุประเทศหรือภูมิภาค เช่น รีวิวภาษาอังกฤษทั้งหมดจะติดแท็กเป็น 'en' ไม่ใช่ 'en-AU' หรือ 'en-UK' และอื่นๆ ฟิลด์นี้จะว่างเปล่าหากมีเฉพาะคะแนนที่ไม่มีข้อความรีวิว
`original_language`	ไม่บังคับ	สตริง	รหัสภาษา IETF ที่ระบุภาษาต้นฉบับของรีวิว หากรีวิวได้รับการแปลแล้ว `original_language` != `language` ฟิลด์นี้มีเฉพาะแท็กภาษาหลักเท่านั้น ไม่มีแท็กรองที่ระบุประเทศหรือภูมิภาค เช่น รีวิวภาษาอังกฤษทั้งหมด จะติดแท็กเป็น "en" ไม่ใช่ "en-AU" หรือ "en-UK" เป็นต้น ฟิลด์นี้ จะว่างเปล่าหากมีเฉพาะคะแนนที่ไม่มีข้อความรีวิว
`profile_photo_url`	ไม่บังคับ	สตริง	URL ไปยังรูปโปรไฟล์ของผู้ใช้ (หากมี)
`text`	ไม่บังคับ	สตริง	รีวิวของผู้ใช้ เมื่อรีวิวสถานที่ด้วย Google Places ระบบจะถือว่ารีวิวที่เป็นข้อความเป็นตัวเลือก ดังนั้น ช่องนี้อาจ ว่างเปล่า โปรดทราบว่าฟิลด์นี้อาจมีมาร์กอัป HTML พื้นฐาน ตัวอย่างเช่น การอ้างอิงเอนทิตี `&` อาจแสดงถึง อักขระเครื่องหมายแอมเพอร์แซนด์
`translated`	ไม่บังคับ	บูลีน	ค่าบูลีนที่ระบุว่ารีวิวได้รับการแปลจากภาษาต้นฉบับที่เขียนหรือไม่ หากรีวิวได้รับการแปลซึ่งสอดคล้องกับค่าเป็นจริง Google ขอแนะนำให้คุณระบุข้อมูลนี้ต่อผู้ใช้ เช่น คุณสามารถเพิ่มสตริง "แปลโดย Google" ลงในรีวิวได้

คำขอค้นหาสถานที่ (เดิม)

พารามิเตอร์ที่จำเป็น

อินพุต

inputtype

พารามิเตอร์ที่ไม่บังคับ

Fields

ภาษา

locationbias

ตัวอย่าง ค้นหาสถานที่ (เดิม)

curl

HTTP

curl

HTTP

curl

HTTP

การตอบกลับของ ค้นหาสถานที่ (เดิม)

JSON

XML

PlacesFindPlaceFromTextResponse

candidates

status

error_message

info_messages

PlacesSearchStatus

สถานที่

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

close

`candidates`

`status`

`error_message`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`