การค้นหาในบริเวณใกล้เคียง (เดิม)

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

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

คำขอการค้นหาในบริเวณใกล้เคียง (เดิม)

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

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

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

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

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

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

  • สถานที่

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

  • รัศมี

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

    ระบบจะจำกัดรัศมีให้เป็นค่าสูงสุดโดยอัตโนมัติ ทั้งนี้ขึ้นอยู่กับประเภทการค้นหาและพารามิเตอร์อื่นๆ

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

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

  • คีย์เวิร์ด

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

    การระบุข้อมูลตำแหน่งอย่างชัดเจนโดยใช้พารามิเตอร์นี้อาจขัดแย้งกับพารามิเตอร์ location, radius และ rankby ซึ่งทำให้เกิดผลลัพธ์ที่ไม่คาดคิด

    หากละเว้นพารามิเตอร์นี้ ระบบจะไม่แสดงสถานที่ที่มี business_status เป็น CLOSED_TEMPORARILY หรือ CLOSED_PERMANENTLY

  • ภาษา

    ภาษาที่จะแสดงผลลัพธ์

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

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

  • minprice

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

  • name

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

  • opennow

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

  • pagetoken

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

  • rankby

    ระบุลำดับที่แสดงผลลัพธ์ ค่าที่เป็นไปได้มีดังนี้

    • prominence (ค่าเริ่มต้น) ตัวเลือกนี้จะจัดเรียงผลลัพธ์ตามความสำคัญ การจัดอันดับจะให้ความสำคัญกับสถานที่ที่โดดเด่นภายในรัศมีที่กำหนดมากกว่าสถานที่ใกล้เคียงที่ตรงกันแต่มีความโดดเด่นน้อยกว่า ความโดดเด่นอาจได้รับผลกระทบจากการจัดอันดับของสถานที่ในดัชนีของ Google, ความนิยมทั่วโลก และปัจจัยอื่นๆ เมื่อระบุความโดดเด่น คุณต้องระบุพารามิเตอร์ radius
    • distance ตัวเลือกนี้จะให้น้ำหนักผลการค้นหาตามลำดับจากน้อยไปมากตามระยะทางจากสถานที่ที่ระบุ เมื่อระบุ distance คุณต้องระบุ keyword, name หรือ type อย่างน้อย 1 รายการ และไม่อนุญาตให้ระบุ radius
  • ประเภท

    จำกัดผลการค้นหาเฉพาะสถานที่ที่ตรงกับประเภทที่ระบุ คุณระบุได้เพียงประเภทเดียวเท่านั้น หากคุณระบุมากกว่า 1 ประเภท API จะละเว้นประเภททั้งหมดที่ตามหลังรายการแรก

    • type=hospital|pharmacy|doctor เปลี่ยนเป็น type=hospital
    • ระบบจะละเว้น type=hospital,pharmacy,doctor ทั้งหมด

    ดูรายการประเภทที่รองรับ

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

ตัวอย่างการค้นหาในบริเวณใกล้เคียง (เดิม)

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522%2C151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?keyword=cruise
  &location=-33.8670522%2C151.1957362
  &radius=1500
  &type=restaurant
  &key=YOUR_API_KEY

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

การตอบกลับการค้นหาในบริเวณใกล้เคียง (เดิม)

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

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8587323, "lng": 151.2100055 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85739847010727, "lng": 151.2112436298927 },
                "southwest":
                  { "lat": -33.86009812989271, "lng": 151.2085439701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet",
        "name": "Cruise Bar",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 608,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uECvJIZuXT-uLDYm4DPbrV7gXVPeplbTWUgcOJ6rnfc4bUYCEAwPU_AmXGIaj0PDhWPbmrjQC8hhuXRJQjnA1-iREGEn7I0ZneHg5OP1mDT7lYVpa1hUPoz7cn8iCGBN9MynjOPSUe-UooRrFw2XEXOLgRJ-uKr6tGQUp77CWVocpcoG",
              "width": 1080,
            },
          ],
        "place_id": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "plus_code":
          {
            "compound_code": "46R6+G2 The Rocks, New South Wales",
            "global_code": "4RRH46R6+G2",
          },
        "price_level": 2,
        "rating": 4,
        "reference": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "scope": "GOOGLE",
        "types":
          ["bar", "restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 1269,
        "vicinity": "Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8675219, "lng": 151.2016502 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86614532010728, "lng": 151.2031259298927 },
                "southwest":
                  { "lat": -33.86884497989272, "lng": 151.2004262701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Sydney Harbour Dinner Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 835,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEBVsYnNcrpRixtrlHBztigZh70CwYkNWZzQnqJ39SjeBo_wvgKf-kXc6tgaMLBdQrRKmxmSKjOezoZrv-sHKVbTX0OI48HBqYYVnQiZQ-WGeuQDsLEPwX7LaVPa68nUAxX114Zpqt7bryoO9wL4qXdgEnopbOp5WWLALhKEHoIEH7f7",
              "width": 1200,
            },
          ],
        "place_id": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "plus_code":
          {
            "compound_code": "46J2+XM Sydney, New South Wales",
            "global_code": "4RRH46J2+XM",
          },
        "rating": 4.8,
        "reference": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 9,
        "vicinity": "32 The Promenade, Sydney",
      },
      // ...
    ],
  "status": "OK",
}
    

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Cruise Bar</name>
  <vicinity>Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8587323</lat>
    <lng>151.2100055</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8600981</lat>
     <lng>151.2085440</lng>
    </southwest>
    <northeast>
     <lat>-33.8573985</lat>
     <lng>151.2112436</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png</icon>
  <reference>ChIJi6C1MxquEmsR9-c-3O48ykI</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEALIq4sgBHhIYWWapOH2NV1T2I7YdOiLzEH7z-483I764cId1sZkbzSq-hVYTk1PQeaHuZzlRfA7-ilwJ3QWon4b37ePd-PBwZbOwFZHxhYs0Cs7jRSgMHWfOzGivp6ZFG4iupyz50qS5pBZT1WbA2ufacTq_U21TtgffQD31wKRPQk</photo_reference>
   <width>1080</width>
   <height>608</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112582655193348962755&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>1269</user_ratings_total>
  <place_id>ChIJi6C1MxquEmsR9-c-3O48ykI</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46R6+G2</global_code>
   <compound_code>46R6+G2 The Rocks, New South Wales</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/bar_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Sydney Harbour Dinner Cruises</name>
  <vicinity>32 The Promenade, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675219</lat>
    <lng>151.2016502</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8688450</lat>
     <lng>151.2004263</lng>
    </southwest>
    <northeast>
     <lat>-33.8661453</lat>
     <lng>151.2031259</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.8</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJM1mOVTS6EmsRKaDzrTsgids</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB5jH7GXdcozv1Y5HX18syo4f128S58NVUnqBbLJMpWbC39K49wp-wzsLOsUT8QKDaag6ISFL8hl1vVuig4jkc5fMMkWKiqw5PY-ebcWZ5tI3gEXEYGGoG_mDAulaMLudUpSwgBx2_RLnA0SSiugqqQUTYlkGyCZSe8HSyngVczy6XN</photo_reference>
   <width>1200</width>
   <height>835</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/109764923610545394994&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>9</user_ratings_total>
  <place_id>ChIJM1mOVTS6EmsRKaDzrTsgids</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+XM</global_code>
   <compound_code>46J2+XM Sydney, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
</PlaceSearchResponse>

    

PlacesNearbySearchResponse

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ Array<string>

อาจมีชุดการระบุแหล่งที่มาเกี่ยวกับข้อมูลนี้ซึ่งต้องแสดงต่อผู้ใช้ (ข้อมูลบางรายการอาจไม่มีการระบุแหล่งที่มา)

ต้องระบุ Array<Place>

มีอาร์เรย์ของสถานที่

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

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

ต้องระบุ PlacesSearchStatus

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

ดูข้อมูลเพิ่มเติมได้ที่ PlacesSearchStatus

ไม่บังคับ สตริง

เมื่อบริการแสดงรหัสสถานะอื่นที่ไม่ใช่ OK< อาจมีช่อง error_message เพิ่มเติมภายในออบเจ็กต์การตอบกลับ ช่องนี้มีข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับสาเหตุที่อยู่เบื้องหลังรหัสสถานะที่ระบุ ระบบอาจไม่แสดงช่องนี้เสมอไป และเนื้อหาอาจมีการเปลี่ยนแปลง

ไม่บังคับ Array<string>

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

ไม่บังคับ สตริง

มีโทเค็นที่ใช้แสดงผลลัพธ์เพิ่มเติมได้สูงสุด 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

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