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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

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

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

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

คำขอ Find Place (เดิม) คือ 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 หมวดหมู่การเรียกเก็บเงิน ดังนี้ พื้นฐาน รายชื่อติดต่อ และ บรรยากาศ ระบบจะเรียกเก็บเงินสำหรับฟิลด์พื้นฐานตามราคาฐาน และเรียกเก็บเงินสำหรับฟิลด์ Contact และ Atmosphere ในอัตราที่สูงกว่า ระบบจะเรียกเก็บเงิน 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

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

หมายเหตุ: หากคุณละเว้นพารามิเตอร์ fields จากคำขอ Find Place (เดิม) ระบบจะแสดงผลเฉพาะ 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

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

การตอบกลับ Find Place (เดิม) จะมีเฉพาะประเภทข้อมูลที่ระบุโดยใช้พารามิเตอร์fields และhtml_attributions ตัวอย่างต่อไปนี้แสดงการตอบกลับสำหรับคำขอ Find Place (เดิม) สำหรับ "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`ผลการค้นหา โดยปกติแล้วจะเป็น ชื่อธุรกิจที่จัดรูปแบบมาตรฐาน
`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`	ไม่บังคับ	สตริง	ภาษาของฟิลด์ก่อนหน้า อาจไม่มีอยู่เสมอไป
`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

รูปภาพของสถานที่ คุณเข้าถึงรูปภาพได้โดยใช้ Place Photo API โดยใช้ 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`	ต้องระบุ	สตริง	สตริงที่ใช้ระบุรูปภาพเมื่อคุณทำการร้องขอรูปภาพ
`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`