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

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

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

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

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

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

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

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

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

• อินพุต

  สตริงข้อความที่จะค้นหา ต้องเป็นชื่อสถานที่ ที่อยู่ หรือหมายเลขโทรศัพท์ (เช่น "123 ถนนสุขุมวิท" หรือ "ศาลากลาง")

• inputtype

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

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

• Fields

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

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

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

  Basic

  หมวดหมู่พื้นฐานประกอบด้วยช่องต่อไปนี้ 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 เลือกแสดงผลและลำดับการแสดงผล โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะตีความตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อสำหรับประเภทถนน หรือคำพ้องความหมายที่อาจใช้ได้ในภาษาหนึ่งแต่ใช้ไม่ได้ในอีกภาษาหนึ่ง เช่น utca และ tér เป็นคำพ้องความหมายของคำว่าถนนในภาษาฮังการี

• locationbias

  ต้องการผลลัพธ์ในพื้นที่ที่ระบุ โดยระบุรัศมีบวกละติจูด/ลองจิจูด หรือคู่ละติจูด/ลองจิจูด 2 คู่ที่แสดงจุดของสี่เหลี่ยมผืนผ้า หากไม่ได้ระบุพารามิเตอร์นี้ API จะใช้การให้น้ำหนักที่อยู่ IP โดยค่าเริ่มต้น

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

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

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

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'

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 -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'

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 -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'

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 (เดิม)

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

{
  "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 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

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