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

Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

การค้นหาข้อความ (เดิม)

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

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

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

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

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

การค้นหาข้อความ (เดิม) จะแสดงข้อมูลเกี่ยวกับชุดสถานที่ตามสตริง เช่น "พิซซ่าในนิวยอร์ก" หรือ "ร้านรองเท้าใกล้กรุงเทพ" หรือ "123 ถนนสุขุมวิท" บริการจะตอบกลับด้วยรายการสถานที่ที่ตรงกับสตริงข้อความและการให้น้ำหนักสถานที่ที่ตั้งไว้

การค้นหาข้อความ (เดิม) ไม่ได้มีไว้สําหรับคําค้นหาที่กํากวม ซึ่งรวมถึงรายการต่อไปนี้

ประเภทคำค้นหา	ตัวอย่าง
มีแนวคิดหรือข้อจำกัดมากเกินไป เช่น ชื่อสถานที่ ถนน หรือเมืองหลายแห่งในคำค้นหาเดียว	"Market Street San Francisco San Jose Airport"
องค์ประกอบของที่อยู่ทางไปรษณีย์ไม่แสดงใน Google Maps	"C/O John Smith 123 Main Street" "P.O. Box 13 San Francisco"
ชื่อธุรกิจ กลุ่มธุรกิจ หรือหมวดหมู่ที่รวมกับสถานที่ตั้งซึ่งไม่มีนิติบุคคลเหล่านี้ให้บริการ	"Tesco ใกล้ Dallas, Texas"
คำค้นหาที่กำกวมซึ่งตีความได้หลายแบบ	"จุดส่งคืนที่ชาร์จ"
ชื่อเดิมที่ไม่ได้ใช้แล้ว	"Middlesex United Kingdom"
องค์ประกอบหรือเจตนาที่ไม่ใช่เชิงภูมิสารสนเทศ	"มีเรือกี่ลำในท่าเรือเวนทูรา"
ชื่อที่ไม่เป็นทางการหรือชื่อที่ตั้งขึ้นเอง	"The Jenga" "The Helter Skelter"
พิกัดละติจูดและลองจิจูด	"37.422131,-122.084801"

หมายเหตุ: เพื่อให้ได้ผลลัพธ์ที่ดีที่สุดเมื่อค้นหาด้วยหมายเลขโทรศัพท์ ให้ใส่รหัสประเทศตามด้วยเว้นวรรค และตั้งค่าพารามิเตอร์ region ให้สอดคล้องกับรหัสประเทศ รูปแบบหมายเลขโทรศัพท์จะแตกต่างกันไปในแต่ละประเทศ และ API จะพยายามแสดงผลลัพธ์สำหรับรูปแบบที่แตกต่างกันเหล่านี้ สำหรับหมายเลขโทรศัพท์ที่ถูกต้อง Places API (เดิม) รองรับรูปแบบ E.164 ระบบจะแปลงอักขระตัวอักษรตามการแมปปุ่มกด E.161

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

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

คำขอการค้นหาข้อความ (เดิม)

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

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

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

json (แนะนำ) บ่งบอกถึงเอาต์พุตใน JavaScript Object Notation (JSON)
xml ระบุเอาต์พุตเป็น XML

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

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

query

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

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

ระบบจะจำกัดรัศมีให้เป็นค่าสูงสุดโดยอัตโนมัติ ทั้งนี้ขึ้นอยู่กับประเภทการค้นหาและพารามิเตอร์อื่นๆ
- เติมข้อความอัตโนมัติ: 50,000 เมตร
- การค้นหาในบริเวณใกล้เคียง:
  - เมื่อใช้ keyword หรือ name: 50,000 เมตร
  - โดยไม่มี keyword หรือ name
    - สูงสุด 50,000 เมตร โดยปรับแบบไดนามิกตามความหนาแน่นของพื้นที่ โดยไม่ขึ้นอยู่กับพารามิเตอร์ rankby
    - เมื่อใช้ rankby=distance ระบบจะไม่ยอมรับพารามิเตอร์รัศมี และจะส่งผลให้เกิด INVALID_REQUEST
- การเติมข้อความค้นหาอัตโนมัติ: 50,000 เมตร
- การค้นหาข้อความ: 50,000 เมตร

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

ภาษา

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

จุดที่ต้องการดึงข้อมูลสถานที่ ต้องระบุเป็น latitude,longitude

ระบบอาจลบล้างพารามิเตอร์ location หาก query มีสถานที่ตั้งที่ชัดเจน เช่น Market in Barcelona การใช้เครื่องหมายคำพูดรอบข้อความค้นหาอาจส่งผลต่อน้ำหนักที่กำหนดให้กับ location และ radius ด้วย
maxprice

จำกัดผลการค้นหาเฉพาะสถานที่ที่อยู่ในช่วงที่ระบุเท่านั้น ค่าที่ถูกต้องมีตั้งแต่ 0 (ราคาถูกที่สุด) ถึง 4 (ราคาแพงที่สุด) จำนวนเงินที่แน่นอนซึ่งระบุด้วยค่าที่เฉพาะเจาะจงจะแตกต่างกันไปในแต่ละภูมิภาค
minprice

จำกัดผลการค้นหาเฉพาะสถานที่ที่อยู่ในช่วงที่ระบุเท่านั้น ค่าที่ถูกต้องมีตั้งแต่ 0 (ราคาถูกที่สุด) ถึง 4 (ราคาแพงที่สุด) จำนวนเงินที่แน่นอนซึ่งระบุด้วยค่าที่เฉพาะเจาะจงจะแตกต่างกันไปในแต่ละภูมิภาค
opennow

แสดงเฉพาะสถานที่ที่เปิดให้บริการ ณ เวลาที่ส่งคำค้นหา ระบบจะไม่แสดงสถานที่ที่ไม่ได้ระบุเวลาทำการในฐานข้อมูล Google Places หากคุณรวมพารามิเตอร์นี้ไว้ในการค้นหา
pagetoken

แสดงผลการค้นหาที่เรียกใช้ก่อนหน้านี้สูงสุด 20 รายการ การตั้งค่าพารามิเตอร์ pagetoken จะดำเนินการค้นหาด้วยพารามิเตอร์เดียวกันกับที่ใช้ก่อนหน้านี้ โดยระบบจะไม่สนใจพารามิเตอร์ทั้งหมดนอกเหนือจาก pagetoken
ภูมิภาค

รหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นที่สำคัญบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับหน่วยงาน "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
ประเภท

จำกัดผลการค้นหาเฉพาะสถานที่ที่ตรงกับประเภทที่ระบุ ระบุได้เพียงประเภทเดียวเท่านั้น หากระบุมากกว่า 1 ประเภท ระบบจะไม่สนใจประเภททั้งหมดที่ตามหลังรายการแรก
- type=hospital|pharmacy|doctor เปลี่ยนเป็น type=hospital
- ระบบจะละเว้น type=hospital,pharmacy,doctor ทั้งหมด
ดูรายการประเภทที่รองรับ

หมายเหตุ: การเพิ่มทั้ง keyword และ type ที่มีค่าเดียวกัน (keyword=cafe&type=cafe หรือ keyword=parking&type=parking) อาจทำให้เกิดZERO_RESULTS

ตัวอย่างการค้นหาข้อความ (เดิม)

หมายเหตุ: ในตัวอย่างเหล่านี้ คุณต้องแทนที่ key ด้วยคีย์ API ของคุณเองเพื่อให้คำขอทำงานในแอปพลิเคชันได้

ตัวอย่างพื้นฐาน

ตัวอย่างต่อไปนี้แสดงการค้นหาร้านอาหารใกล้ซิดนีย์

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants%20in%20Sydney&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=restaurants%20in%20Sydney
  &key=YOUR_API_KEY

ตัวอย่างที่อยู่ไม่สมบูรณ์

ตัวอย่างต่อไปนี้แสดงการค้นหาที่อยู่ที่ไม่สมบูรณ์ ในกรณีนี้คือที่อยู่ซึ่งไม่มีเมือง รัฐ หรือประเทศ

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=123%20main%20street
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "Main St, Denver, CO 80238, USA",
        "geometry":
          {
            "location": { "lat": 39.782267, "lng": -104.8919341 },
            "viewport":
              {
                "northeast":
                  { "lat": 39.78361682989273, "lng": -104.8905842701073 },
                "southwest":
                  { "lat": 39.78091717010729, "lng": -104.8932839298927 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Main St",
        "place_id": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "reference": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "types": ["route"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Main St</name>
  <type>route</type>
  <formatted_address>Main St, Denver, CO 80238, USA</formatted_address>
  <geometry>
   <location>
    <lat>39.7822670</lat>
    <lng>-104.8919341</lng>
   </location>
   <viewport>
    <southwest>
     <lat>39.7809172</lat>
     <lng>-104.8932839</lng>
    </southwest>
    <northeast>
     <lat>39.7836168</lat>
     <lng>-104.8905843</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJIS85_gd7bIcRJIGEPue1cJI</reference>
  <place_id>ChIJIS85_gd7bIcRJIGEPue1cJI</place_id>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

ตัวอย่างการให้น้ำหนักพิเศษกับบางตำแหน่ง

ตัวอย่างต่อไปนี้แสดงการค้นหาที่อยู่ที่ไม่สมบูรณ์แบบเดียวกับในตัวอย่างก่อนหน้า และมีพารามิเตอร์ location และ radius เพื่อให้น้ำหนักผลการค้นหาไปยังภูมิภาคที่สนใจ

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&location=42.3675294%2C-71.186966&radius=10000&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?location=42.3675294%2C-71.186966
  &query=123%20main%20street
  &radius=10000
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "123 Main St, Boston, MA 02110, USA",
        "geometry":
          {
            "location": { "lat": 42.3744917, "lng": -71.0634802 },
            "viewport":
              {
                "northeast":
                  { "lat": 42.37581642989272, "lng": -71.06219107010727 },
                "southwest":
                  { "lat": 42.37311677010727, "lng": -71.06489072989272 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "123 Main St",
        "place_id": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "plus_code":
          {
            "compound_code": "9WFP+QJ Boston, Massachusetts",
            "global_code": "87JC9WFP+QJ",
          },
        "reference": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "types": ["street_address"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>123 Main St</name>
  <type>street_address</type>
  <formatted_address>123 Main St, Boston, MA 02110, USA</formatted_address>
  <geometry>
   <location>
    <lat>42.3744917</lat>
    <lng>-71.0634802</lng>
   </location>
   <viewport>
    <southwest>
     <lat>42.3731168</lat>
     <lng>-71.0648907</lng>
    </southwest>
    <northeast>
     <lat>42.3758164</lat>
     <lng>-71.0621911</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJd_ueCe1w44kRD_KFuN5w5nA</reference>
  <place_id>ChIJd_ueCe1w44kRD_KFuN5w5nA</place_id>
  <plus_code>
   <global_code>87JC9WFP+QJ</global_code>
   <compound_code>9WFP+QJ Boston, Massachusetts</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

การตอบกลับการค้นหาข้อความ (เดิม)

ระบบจะแสดงผลการค้นหาในรูปแบบที่ระบุโดยแฟล็ก output ภายในเส้นทางของคำขอ URL

ตัวอย่างต่อไปนี้แสดงการตอบกลับของการค้นหาข้อความ (เดิม)

JSON

{
  "html_attributions": [],
  "next_page_token": "Aap_uEAHsgFErpxZrytW1mgKsefD327VCf0OgNF9vpXPwTOG6AGhEZpGgMgofSzgCahevXhneCe9M9H24SOuE4ZcaE0ZR01gVykQZ6EoDnlWEQvXBXe6z0sgF5MQo7qBb6uD4VHKDLhgR59Lb86BzTHJzTzbm61OAPvyInZoaQxK8-oEf2PShZT7XRJKoF5nISbwvU_-RomwGDVi27oj0fToIyV-Vj2ftJw8ZUPbdGGCbcDolQyAwj11Dy2aaeK4SGwg2mO5Akxa7fCze2RJ0GCAvXXp7omTFDy_47OXsFgDPfzluc7mEb5VlzlIMZ0eWQ8VeNigtv-XZZG0f3HSo81Yeq3QhXedJ5oNE1XCwyMly3YVgw_h3amOzAOuDigF1pgFnfGyzxD8vr2bfbPTNvA9l7IJ8Q",
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "1 Macquarie St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8592041, "lng": 151.2132635 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85786707010728, "lng": 151.2147093298927 },
                "southwest":
                  { "lat": -33.86056672989272, "lng": 151.2120096701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Aria Restaurant Sydney",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4032,
              "html_attributions":
                [
                  'Dohyun Kim',
                ],
              "photo_reference": "Aap_uED7B83PoQ1wNgzYcFZEOw1P2DqNjlaqiXxo-r4F_NaR27uV2OiIvijkI6RYyfiiHYo9UqjnZkRtZaNTk4C6Ickh3k3stsSvBU0KfLtFow-oRujSYYChYwiYhVyP27omLzQQjafhJ2N3LJbjcMxSePKXsQzYCqmOLWg0E9mSExMJ4aM",
              "width": 3024,
            },
          ],
        "place_id": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "plus_code":
          {
            "compound_code": "46R7+88 Sydney, New South Wales, Australia",
            "global_code": "4RRH46R7+88",
          },
        "price_level": 4,
        "rating": 4.5,
        "reference": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 1681,
      },
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "15 Bligh St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8651396, "lng": 151.2104533 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86384167010728, "lng": 151.2118993298927 },
                "southwest":
                  { "lat": -33.86654132989272, "lng": 151.2091996701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Restaurant Hubert",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 683,
              "html_attributions":
                [
                  'Ashley Hughes',
                ],
              "photo_reference": "Aap_uEB41WOb_Nl8I8py4D6uXoLHzVYtFZZcucYdYAN1FtzXBnAu59xXrxk5tekoktAbklwmHeSFfdnTCWgHRZ1C5Azp9AMCP9GRGV1f2Z1-5kjsVgnYPiq82JoueSUdCSQJFabyL0cagtcGaFKetVi7DmUIHDQknEPCh_cpCbdOMw4Bkq5q",
              "width": 1024,
            },
          ],
        "place_id": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "plus_code":
          {
            "compound_code": "46M6+W5 Sydney, New South Wales, Australia",
            "global_code": "4RRH46M6+W5",
          },
        "price_level": 3,
        "rating": 4.6,
        "reference": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 2393,
      },
      // ...
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Aria Restaurant Sydney</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>1 Macquarie St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8592041</lat>
    <lng>151.2132635</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8605667</lat>
     <lng>151.2120097</lng>
    </southwest>
    <northeast>
     <lat>-33.8578671</lat>
     <lng>151.2147093</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.5</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJdxxU1WeuEmsR11c4fswX-Io</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDOK3C-umU4a2um8NR1G_b_MNPEG1ogm0PLp49myXaj0AD2aT60YrNlbrwnvg2VBrCmE2kBsuDmwZgXL8V-vU2ToVhNgp3A8zAjtx15slWyCxm3WCvWFEPE-_eBoj0Dlh83k_oWPN65B0blYM-qXLBY1PJZbq14gOUXabf31PSo1yA</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112033760018394328606&quot;&gt;Dohyun Kim&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>4</price_level>
  <user_ratings_total>1681</user_ratings_total>
  <place_id>ChIJdxxU1WeuEmsR11c4fswX-Io</place_id>
  <plus_code>
   <global_code>4RRH46R7+88</global_code>
   <compound_code>46R7+88 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Restaurant Hubert</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>15 Bligh St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8651396</lat>
    <lng>151.2104533</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8665413</lat>
     <lng>151.2091997</lng>
    </southwest>
    <northeast>
     <lat>-33.8638417</lat>
     <lng>151.2118993</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.6</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJF5-RdGquEmsR5rN_H74uSqQ</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDhALUBAcrBEprGmkq0_kj9kC4IEWod9h0PZBu-A1mXPN_ZfylpiDXRWxOtuONEFQIqjREf7C28LQDjzqVl4ZD0gZUk4Y0JHPDWaTlfVwijaPfw221p175Sk4po7rB2t7HgjQF2c5O12FYnvNzRiCrkOjr4xroJgzcnp1LV0y8w7gtb</photo_reference>
   <width>1024</width>
   <height>683</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113719639442868633401&quot;&gt;Ashley Hughes&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>3</price_level>
  <user_ratings_total>2393</user_ratings_total>
  <place_id>ChIJF5-RdGquEmsR5rN_H74uSqQ</place_id>
  <plus_code>
   <global_code>4RRH46M6+W5</global_code>
   <compound_code>46M6+W5 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
 <next_page_token>Aap_uEC8n0Fzu2WsA7IqaEJty09klsnvXEYZe0aL8dIiZx3fOOfo1xYHZR00qrq-obJbYY9YRkftL-Pv__rQ-efJHSxv19gDtol2ARoY9wpi0ENg-vUAkDVt2W0mOqDy4Kjz9rm5-tzk6fhKR6r4wbLkdgXbKLuNM7KEhsjspU0RC5jQZa4FK_cM9qeUPx5IkPdAa11b9EJwKPEy-ixe77eXeRbEzDYhC5rhylkoOGbF1mHVJVxr--u-Ihe0YaFogaWDx50BcCcMN-eDetaUBJwXDnzHxtirIRF5C_yFavCzWcFn5TOC_z9Ltc-U0L5zbv3lQ7Z6kfVuOeKp4u5_lEHwfz-LuHyETKE6QwQypJUPS3AS8BFs2pYm9r_ruao6YVYsFfDGs1-9QPsVUeSjCN3NuRvbkA</next_page_token>
</PlaceSearchResponse>

PlacesTextSearchResponse

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

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, formatted_phone_number, reviews หรือ website ให้ส่ง place_id ที่แสดงผลในคำขอรายละเอียดสถานที่ (เดิม) ดูความพร้อมใช้งานของฟิลด์และระดับราคาในปลายทางต่างๆ ได้ที่ฟิลด์ข้อมูลสถานที่ (เดิม)

ช่อง	ประเภท	คำอธิบาย
`business_status`	`string`	ระบุสถานะการดำเนินการของสถานที่ หากเป็นธุรกิจ ได้แก่ `OPERATIONAL`, `CLOSED_TEMPORARILY` หรือ `CLOSED_PERMANENTLY` ละเว้นหากไม่มีข้อมูลสถานะ
`formatted_address`	`string`	ที่อยู่ที่มนุษย์อ่านได้ของสถานที่นี้ แสดงผลโดยการค้นหาข้อความ (เดิม) และค้นหาสถานที่ (เดิม) อย่าแยกวิเคราะห์ที่อยู่ที่มีการจัดรูปแบบแบบเป็นโปรแกรม แต่ให้ขอ `address_components` ในรายละเอียดสถานที่ (เดิม) แทน
`geometry`	`Geometry`	มี `location` ที่เข้ารหัสพิกัดภูมิศาสตร์พร้อมพิกัด `lat` และ `lng` และ `viewport` ที่ต้องการพร้อมขอบเขต `northeast` และ `southwest`
`icon`	`string`	URL ของไอคอนที่แนะนำซึ่งคุณสามารถแสดงเมื่อระบุผลลัพธ์นี้ในแผนที่
`icon_background_color`	`string`	รหัสสีแบบเลขฐาน 16 เริ่มต้นสำหรับหมวดหมู่ของสถานที่
`icon_mask_base_uri`	`string`	URL ฐานของไอคอนที่แนะนำ โดยไม่มีนามสกุลประเภทไฟล์ SVG หรือ PNG
`name`	`string`	ชื่อที่มนุษย์อ่านได้สำหรับผลลัพธ์ที่แสดงผล สำหรับผลการค้นหา `establishment` ค่านี้มักจะเป็นชื่อธุรกิจที่ทำ Canonical
`opening_hours`	`PlaceOpeningHours`	ข้อมูลเวลาทำการ ปลายทางการค้นหาสถานที่จะแสดงเฉพาะฟิลด์ย่อยบูลีน `open_now` เท่านั้น โปรดขอ `opening_hours` ในรายละเอียดสถานที่ (เดิม) สำหรับ `periods` และ `weekday_text`
`permanently_closed`	`boolean`	เลิกใช้งาน: ใช้ `business_status` เพื่อตรวจสอบสถานะการดำเนินการของธุรกิจ
`photos`	`Array<PlacePhoto>`	อาร์เรย์ของออบเจ็กต์ `PlacePhoto` ซึ่งแต่ละออบเจ็กต์ประกอบด้วย `photo_reference`, `height`, `width` และ `html_attributions` ดูรายละเอียดการใช้งานได้ที่รูปภาพของสถานที่ (เดิม)
`place_id`	`string`	ตัวระบุข้อความที่ระบุสถานที่โดยไม่ซ้ำกัน ส่งรหัสนี้ในพารามิเตอร์ `place_id` ของคำขอรายละเอียดสถานที่ (เดิม) ดูภาพรวมรหัสสถานที่
`plus_code`	`PlusCode`	ข้อมูลอ้างอิงตำแหน่งที่เข้ารหัสซึ่งได้มาจากพิกัดละติจูดและลองจิจูด ซึ่งมี `global_code` และ `compound_code` (ไม่บังคับ)
`price_level`	`integer`	ระดับราคาของสถานที่ในสเกลตั้งแต่ `0` ถึง `4` โดยเรียงจากราคาถูกที่สุดไปจนถึงแพงที่สุด ดู`price_level`
`rating`	`number`	คะแนนของสถานที่ ตั้งแต่ `1.0` ถึง `5.0` โดยอิงตามรีวิวจากผู้ใช้ที่รวบรวมมา
`reference`	`string`	เลิกใช้งานแล้ว: โปรดใช้ `place_id` แทน
`scope`	`string`	เลิกใช้งานแล้ว: ระบุขอบเขตของ `place_id` ซึ่งจะเป็น `GOOGLE` เสมอ แสดงผลโดยการค้นหาในบริเวณใกล้เคียง (เดิม)
`types`	`Array<string>`	อาร์เรย์ของประเภทฟีเจอร์ที่อธิบายผลลัพธ์ที่ระบุ ดูประเภทสถานที่ (เดิม)
`user_ratings_total`	`integer`	จำนวนการให้คะแนนทั้งหมดสำหรับสถานที่นี้ โดยมีหรือไม่มีข้อความรีวิว
`vicinity`	`string`	ที่อยู่แบบย่อของสถานที่ ซึ่งรวมถึงชื่อถนน หมายเลขถนน และท้องถิ่น โดยไม่มีรัฐหรือจังหวัด รหัสไปรษณีย์ หรือประเทศ แสดงผลโดยการค้นหาในบริเวณใกล้เคียง (เดิม)

การเข้าถึงผลลัพธ์เพิ่มเติม

โดยค่าเริ่มต้น การตอบกลับแต่ละครั้งจะแสดงผลการค้นหา establishment สูงสุด 20 รายการต่อคำค้นหา อย่างไรก็ตาม การค้นหาแต่ละครั้งสามารถแสดงผลการค้นหาได้สูงสุด 60 รายการ โดยแบ่งออกเป็น 3 หน้า หากการค้นหาแสดงผลลัพธ์มากกว่า 20 รายการ การตอบกลับการค้นหาจะมีค่าเพิ่มเติมคือ next_page_token ส่งค่าของ next_page_token ไปยังพารามิเตอร์ pagetoken ของคำขอใหม่เพื่อดูผลลัพธ์ชุดถัดไป

หาก next_page_token เป็นค่าว่างหรือไม่แสดงผล แสดงว่าไม่มีผลลัพธ์เพิ่มเติม
การลองส่งคำขออีกครั้งด้วย next_page_token เดียวกันจะแสดงผลลัพธ์หน้าถัดไป
การตั้งค่า pagetoken จะทำให้ระบบละเว้นพารามิเตอร์อื่นๆ
คุณขอหน้าใหม่ได้สูงสุด 2 ครั้งหลังจากการค้นหาเดิม
คำขอแต่ละรายการ รวมถึงคำขอที่ใช้ next_page_token จะนับเป็นคำขอเดียวตามขีดจำกัดการใช้งานและจะเรียกเก็บเงินแยกกัน
โดยจะมีความล่าช้า 2-3 วินาทีระหว่างเวลาที่ออก next_page_token และเวลาที่โทเค็นจะใช้งานได้ การขอหน้าถัดไปก่อนที่หน้าจะพร้อมใช้งานจะแสดงการตอบกลับ INVALID_REQUEST ระบบจะเรียกเก็บเงินสำหรับคำขอที่มี next_page_token เสมอ
หมายเหตุ: การใช้ next_page_token ที่ถูกต้องคือการขอหน้าผลการค้นหาถัดไปเมื่อผู้ใช้ร้องขอเท่านั้น เราขอแนะนำให้คุณใช้การแบ่งหน้าจริง (แสดงผลลัพธ์ครั้งละ 20 รายการ) หรือเพิ่มสถานที่อื่นๆ ที่ด้านล่างของหน้าผลการค้นหาเมื่อผู้ใช้เลื่อนไปจนสุด

ตัวอย่างเช่น ในการค้นหาด้านล่าง เราจะค้นหาร้านอาหารใกล้กับท่าเรือดาร์ลิ่งในซิดนีย์ ออสเตรเลีย และจัดอันดับผลการค้นหาตามระยะทาง คุณจะเห็นว่าการตอบกลับมีพร็อพเพอร์ตี้ next_page_token

{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [...]
   "status" : "OK"
}

หากต้องการดูผลลัพธ์ชุดถัดไป คุณสามารถส่งคำค้นหาใหม่โดยส่งผลลัพธ์ของ next_page_token ไปยังพารามิเตอร์ pagetoken เช่น

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY

คำขอการค้นหาข้อความ (เดิม)

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

query

รัศมี

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

ภาษา

สถานที่

maxprice

minprice

opennow

pagetoken

ภูมิภาค

ประเภท

ตัวอย่างการค้นหาข้อความ (เดิม)

ตัวอย่างพื้นฐาน

curl

HTTP

ตัวอย่างที่อยู่ไม่สมบูรณ์

curl

HTTP

JSON

XML

ตัวอย่างการให้น้ำหนักพิเศษกับบางตำแหน่ง

curl

HTTP

JSON

XML

การตอบกลับการค้นหาข้อความ (เดิม)

JSON

XML

PlacesTextSearchResponse

html_attributions

results

status

error_message

info_messages

next_page_token

PlacesSearchStatus

สถานที่

การเข้าถึงผลลัพธ์เพิ่มเติม

`html_attributions`

`results`

`status`

`error_message`

`info_messages`

`next_page_token`