Tìm kiếm lân cận (Cũ)

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Nearby Search (Phiên bản cũ) cho phép bạn tìm kiếm địa điểm trong một khu vực cụ thể. Bạn có thể tinh chỉnh yêu cầu tìm kiếm bằng cách cung cấp từ khoá hoặc chỉ định loại địa điểm mà bạn đang tìm kiếm.

Yêu cầu Nearby Search (Phiên bản cũ)

Yêu cầu Nearby Search (Cũ) là một URL loại HTTP có dạng như sau:

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

trong đó output có thể là một trong các giá trị sau:

  • json (nên dùng) cho biết kết quả đầu ra ở định dạng Ký hiệu đối tượng JavaScript (JSON)
  • xml cho biết kết quả đầu ra ở định dạng XML

Bạn cần có một số tham số nhất định để bắt đầu yêu cầu Nearby Search (Cũ). Theo tiêu chuẩn trong URL, tất cả tham số đều được phân tách bằng ký tự dấu và (&).

Tham số bắt buộc

  • vị trí

    Điểm xung quanh để truy xuất thông tin về địa điểm. Bạn phải chỉ định giá trị này là latitude,longitude.

  • bán kính

    Xác định khoảng cách (tính bằng mét) để trả về kết quả về địa điểm. Bạn có thể thiên về kết quả cho một vòng tròn cụ thể bằng cách truyền tham số location và radius. Thao tác này sẽ hướng dẫn dịch vụ Địa điểm ưu tiên hiển thị kết quả trong vòng tròn đó; kết quả bên ngoài khu vực đã xác định vẫn có thể xuất hiện.

    Bán kính sẽ tự động được giới hạn ở một giá trị tối đa tuỳ thuộc vào loại tìm kiếm và các tham số khác.

    • Tự động hoàn thành: 50.000 mét
    • Nearby Search:
      • với keyword hoặc name: 50.000 mét
      • không có keyword hoặc name
        • Tối đa 50.000 mét, được điều chỉnh linh động dựa trên mật độ khu vực, không phụ thuộc vào tham số rankby.
        • Khi sử dụng rankby=distance, tham số bán kính sẽ không được chấp nhận và sẽ dẫn đến INVALID_REQUEST.
    • Tự động hoàn thành cụm từ tìm kiếm: 50.000 mét
    • Tìm kiếm văn bản: 50.000 mét

Thông số tùy chọn

  • keyword

    Chuỗi văn bản cần tìm kiếm, ví dụ: "nhà hàng" hoặc "123 Main Street". Đây phải là tên địa điểm, địa chỉ hoặc danh mục cơ sở. Bất kỳ loại dữ liệu đầu vào nào khác đều có thể tạo ra lỗi và không đảm bảo trả về kết quả hợp lệ. Dịch vụ Google Địa điểm sẽ trả về các kết quả phù hợp dựa trên chuỗi này và sắp xếp kết quả dựa trên mức độ liên quan mà dịch vụ nhận thấy.

    Việc đưa thông tin vị trí vào một cách rõ ràng bằng tham số này có thể xung đột với các tham số location, radius và rankby, gây ra kết quả không mong muốn.

    Nếu bạn bỏ qua tham số này, thì những địa điểm có business_status là CLOSED_TEMPORARILY hoặc CLOSED_PERMANENTLY sẽ không được trả về.

  • language

    Ngôn ngữ để trả về kết quả.

    • Xem danh sách ngôn ngữ được hỗ trợ. Google thường xuyên cập nhật các ngôn ngữ được hỗ trợ, vì vậy, danh sách này có thể chưa đầy đủ.
    • Nếu bạn không cung cấp language, API sẽ cố gắng sử dụng ngôn ngữ ưu tiên như được chỉ định trong tiêu đề Accept-Language.
    • API này cố gắng hết sức để cung cấp địa chỉ đường phố mà cả người dùng và người dân địa phương đều có thể đọc được. Để đạt được mục tiêu đó, API này sẽ trả về địa chỉ đường phố bằng ngôn ngữ địa phương, được chuyển tự sang một hệ thống chữ viết mà người dùng có thể đọc được (nếu cần), đồng thời tuân thủ ngôn ngữ ưu tiên. Tất cả các địa chỉ khác được trả về bằng ngôn ngữ ưu tiên. Tất cả thành phần địa chỉ đều được trả về bằng cùng một ngôn ngữ, được chọn từ thành phần đầu tiên.
    • Nếu không có tên bằng ngôn ngữ ưu tiên, API sẽ sử dụng tên phù hợp nhất.
    • Ngôn ngữ ưu tiên có ảnh hưởng nhỏ đến nhóm kết quả mà API chọn trả về và thứ tự trả về. Bộ mã hoá địa lý diễn giải các từ viết tắt theo cách khác nhau tuỳ thuộc vào ngôn ngữ, chẳng hạn như từ viết tắt cho các loại đường phố hoặc từ đồng nghĩa có thể hợp lệ trong một ngôn ngữ nhưng không hợp lệ trong ngôn ngữ khác. Ví dụ: utca và tér là các từ đồng nghĩa với "đường" trong tiếng Hungary.

  • maxprice

    Giới hạn kết quả chỉ ở những địa điểm trong phạm vi đã chỉ định. Giá trị hợp lệ nằm trong khoảng từ 0 (giá phải chăng nhất) đến 4 (giá đắt nhất). Số tiền chính xác được biểu thị bằng một giá trị cụ thể sẽ khác nhau tuỳ theo khu vực.

  • minprice

    Giới hạn kết quả chỉ cho những địa điểm trong phạm vi đã chỉ định. Giá trị hợp lệ nằm trong khoảng từ 0 (giá phải chăng nhất) đến 4 (giá đắt nhất). Số tiền chính xác được biểu thị bằng một giá trị cụ thể sẽ khác nhau tuỳ theo khu vực.

  • tên

    Tương đương với keyword. Các giá trị trong trường này được kết hợp với các giá trị trong trường keyword và được truyền dưới dạng một phần của cùng một chuỗi tìm kiếm.

  • opennow

    Chỉ trả về những địa điểm đang mở cửa hoạt động tại thời điểm gửi truy vấn. Những địa điểm không chỉ định giờ mở cửa trong cơ sở dữ liệu của Google Địa điểm sẽ không được trả về nếu bạn đưa tham số này vào truy vấn của mình.

  • pagetoken

    Trả về tối đa 20 kết quả từ một lượt tìm kiếm đã chạy trước đó. Việc đặt tham số pagetoken sẽ thực hiện một lượt tìm kiếm có cùng tham số được dùng trước đó – tất cả tham số khác ngoài pagetoken đều bị bỏ qua.

  • rankby

    Chỉ định thứ tự liệt kê kết quả. Các giá trị có thể là:

    • prominence (mặc định). Lựa chọn này sắp xếp kết quả dựa trên mức độ quan trọng của kết quả. Thứ hạng sẽ ưu tiên những địa điểm nổi bật trong bán kính đã đặt hơn là những địa điểm lân cận phù hợp nhưng ít nổi bật hơn. Mức độ nổi bật có thể chịu ảnh hưởng của thứ hạng của một địa điểm trong chỉ mục của Google, mức độ phổ biến trên toàn cầu và các yếu tố khác. Khi bạn chỉ định mức độ nổi bật, tham số radius là bắt buộc.
    • distance. Tuỳ chọn này ưu tiên kết quả tìm kiếm theo thứ tự tăng dần theo khoảng cách từ vị trí đã chỉ định. Khi bạn chỉ định distance, bạn phải chỉ định một hoặc nhiều thuộc tính keyword, name hoặc type và không được phép chỉ định radius.

  • loại

    Hạn chế kết quả cho những địa điểm khớp với loại đã chỉ định. Bạn chỉ có thể chỉ định một loại. Nếu bạn cung cấp nhiều loại, API sẽ bỏ qua tất cả các loại sau mục nhập đầu tiên.

    • type=hospital|pharmacy|doctor trở thành type=hospital
    • type=hospital,pharmacy,doctor hoàn toàn bị bỏ qua

    Xem danh sách các loại được hỗ trợ.

    Lưu ý: Việc thêm cả keyword và type có cùng giá trị (keyword=cafe&type=cafe hoặc keyword=parking&type=parking) có thể tạo ra ZERO_RESULTS.

Ví dụ về Nearby Search (Phiên bản cũ)

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

Lưu ý: Trong ví dụ này, bạn cần thay thế key bằng khoá API của riêng mình để yêu cầu hoạt động trong ứng dụng.

Câu trả lời của Nearby Search (Phiên bản cũ)

Ví dụ sau đây cho thấy một phản hồi của Nearby Search (Cũ).

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

Trường Bắt buộc Loại Mô tả
bắt buộc Array<string>

Có thể chứa một tập hợp các thuộc tính về trang thông tin này mà bạn phải hiển thị cho người dùng (một số trang thông tin có thể không có thuộc tính).

bắt buộc Array<Place>

Chứa một mảng các địa điểm.

Yêu cầu Tìm kiếm địa điểm trả về một tập hợp con các trường được trả về theo yêu cầu Place Details. Nếu trường bạn muốn không được trả về bằng tính năng Tìm kiếm địa điểm, thì bạn có thể sử dụng tính năng Tìm kiếm địa điểm để lấy place_id, sau đó sử dụng Mã địa điểm đó để gửi yêu cầu Chi tiết địa điểm.

Hãy xem Địa điểm để biết thêm thông tin.
bắt buộc PlacesSearchStatus

Chứa trạng thái của yêu cầu và có thể chứa thông tin gỡ lỗi để giúp bạn theo dõi lý do yêu cầu không thành công.

Hãy xem PlacesSearchStatus để biết thêm thông tin.

tùy chọn chuỗi

Khi dịch vụ trả về một mã trạng thái khác với OK<, có thể có thêm một trường error_message trong đối tượng phản hồi. Trường này chứa thông tin chi tiết hơn về lý do dẫn đến mã trạng thái đã cho. Trường này không phải lúc nào cũng được trả về và nội dung của trường này có thể thay đổi.

tùy chọn Array<string>

Khi dịch vụ trả về thông tin bổ sung về thông số kỹ thuật của yêu cầu, có thể có thêm trường info_messages trong đối tượng phản hồi. Trường này chỉ được trả về cho các yêu cầu thành công. Trường này có thể không phải lúc nào cũng được trả về và nội dung của trường này có thể thay đổi.

next_page_token

tùy chọn chuỗi

Chứa mã thông báo có thể dùng để trả về tối đa 20 kết quả bổ sung. Hệ thống sẽ không trả về next_page_token nếu không có kết quả nào khác để hiển thị. Số lượng kết quả tối đa có thể trả về là 60. Có một khoảng thời gian trễ ngắn giữa thời điểm next_page_token được phát hành và thời điểm mã này có hiệu lực.

PlacesSearchStatus

Mã trạng thái do dịch vụ trả về.

  • OK cho biết yêu cầu API đã thành công.
  • ZERO_RESULTS cho biết rằng lượt tìm kiếm đã thành công nhưng không trả về kết quả nào. Điều này có thể xảy ra nếu kết quả tìm kiếm được chuyển đến một latlng ở vị trí từ xa.
  • INVALID_REQUEST cho biết yêu cầu API không đúng định dạng, thường là do thiếu tham số truy vấn bắt buộc (location hoặc radius).
  • OVER_QUERY_LIMIT cho biết bất kỳ điều nào sau đây:
    • Bạn đã vượt quá giới hạn QPS.
    • Bạn chưa bật tính năng thanh toán trên tài khoản của mình.
    • Bạn đã vượt quá khoản tín dụng 200 USD hằng tháng hoặc hạn mức sử dụng do bạn tự đặt ra.
    • Phương thức thanh toán được cung cấp không còn hợp lệ (ví dụ: thẻ tín dụng đã hết hạn).
    Hãy xem phần Câu hỏi thường gặp về Maps để biết thêm thông tin về cách giải quyết lỗi này.
  • REQUEST_DENIED cho biết yêu cầu của bạn đã bị từ chối, thường là do:
    • Yêu cầu thiếu khoá API.
    • Tham số key không hợp lệ.
  • UNKNOWN_ERROR cho biết lỗi không xác định.

Địa điểm

Phản hồi của tính năng Tìm kiếm địa điểm trả về một nhóm nhỏ các trường Địa điểm sau đây. Không phải loại địa điểm nào cũng có tất cả các thuộc tính. Để truy xuất các trường mà tính năng Tìm kiếm địa điểm không trả về, chẳng hạn như address_components, formatted_phone_number, reviews hoặc website, hãy truyền place_id được trả về trong một yêu cầu Place Details (Phiên bản cũ). Để biết thông tin về phạm vi cung cấp của trường và các cấp giá trên các điểm cuối, hãy xem phần Trường dữ liệu địa điểm (Cũ).

Trường Loại Mô tả
business_status string Cho biết trạng thái hoạt động của địa điểm, nếu đó là một doanh nghiệp: OPERATIONAL, CLOSED_TEMPORARILY hoặc CLOSED_PERMANENTLY. Bỏ qua nếu không có dữ liệu trạng thái.
formatted_address string Địa chỉ mà con người có thể đọc được của địa điểm này. Do dịch vụ Tìm kiếm văn bản (Cũ) và Tìm địa điểm (Cũ) trả về. Đừng phân tích cú pháp địa chỉ đã định dạng theo phương thức lập trình; thay vào đó, hãy yêu cầu address_components trong Place Details (Cũ).
geometry Geometry Chứa location được mã hoá địa lý với toạ độ lat và lng, cũng như viewport ưu tiên với ranh giới northeast và southwest.
icon string URL của biểu tượng đề xuất mà bạn có thể hiển thị khi cho biết kết quả này trên bản đồ.
icon_background_color string Mã màu thập lục phân mặc định cho danh mục của địa điểm.
icon_mask_base_uri string URL cơ sở của biểu tượng được đề xuất, không có đuôi loại tệp SVG hoặc PNG.
name string Tên mà con người có thể đọc được cho kết quả trả về. Đối với kết quả establishment, giá trị này thường là tên doanh nghiệp chuẩn hoá.
opening_hours PlaceOpeningHours Thông tin về giờ mở cửa. Điểm cuối của tính năng Tìm kiếm địa điểm chỉ trả về trường phụ boolean open_now; yêu cầu opening_hours trong Chi tiết địa điểm (Cũ) cho periods và weekday_text.
permanently_closed boolean Không dùng nữa: Hãy sử dụng business_status để kiểm tra trạng thái hoạt động của một doanh nghiệp.
photos Array<PlacePhoto> Một mảng các đối tượng PlacePhoto, mỗi đối tượng chứa một photo_reference, height, width và html_attributions. Để biết thông tin chi tiết về cách sử dụng, hãy xem phần Ảnh địa điểm (Cũ).
place_id string Giá trị nhận dạng dạng văn bản giúp xác định duy nhất một địa điểm. Truyền mã nhận dạng này vào tham số place_id của yêu cầu Place Details (Cũ). Xem tổng quan về mã địa điểm.
plus_code PlusCode Thông tin tham chiếu vị trí được mã hoá bắt nguồn từ toạ độ vĩ độ và kinh độ, chứa global_code và compound_code (không bắt buộc).
price_level integer Mức giá của địa điểm theo thang điểm từ 0 đến 4, từ rẻ nhất đến đắt nhất. Hãy xem phần price_level.
rating number Điểm xếp hạng của địa điểm, từ 1.0 đến 5.0, dựa trên bài đánh giá tổng hợp của người dùng.
reference string Không dùng nữa: Hãy sử dụng place_id.
scope string Không dùng nữa: Cho biết phạm vi của place_id, luôn là GOOGLE. Do Nearby Search (Phiên bản cũ) trả về.
types Array<string> Một mảng gồm các loại đối tượng mô tả kết quả đã cho. Xem Loại địa điểm (Cũ).
user_ratings_total integer Tổng số lượt xếp hạng (có hoặc không có nội dung đánh giá) cho địa điểm này.
vicinity string Địa chỉ đơn giản của địa điểm, bao gồm tên đường, số đường và địa phương, không có tiểu bang hoặc tỉnh, mã bưu chính hoặc quốc gia. Do Nearby Search (Phiên bản cũ) trả về.

Truy cập vào các kết quả khác

Theo mặc định, mỗi phản hồi trả về tối đa 20 kết quả establishment cho mỗi cụm từ tìm kiếm; tuy nhiên, mỗi lượt tìm kiếm có thể trả về tối đa 60 kết quả, chia thành 3 trang. Nếu kết quả tìm kiếm của bạn trả về nhiều hơn 20, thì phản hồi tìm kiếm sẽ bao gồm một giá trị bổ sung — next_page_token. Truyền giá trị của next_page_token vào tham số pagetoken của một yêu cầu mới để xem nhóm kết quả tiếp theo.

  • Nếu next_page_token rỗng hoặc không được trả về, thì sẽ không có kết quả nào khác.
  • Thử lại yêu cầu bằng cùng một next_page_token sẽ trả về trang kết quả tiếp theo.
  • Việc đặt pagetoken sẽ khiến mọi tham số khác bị bỏ qua.
  • Bạn có thể yêu cầu trang mới tối đa hai lần sau truy vấn ban đầu.
  • Mỗi yêu cầu, bao gồm cả yêu cầu sử dụng next_page_token, được tính là một yêu cầu duy nhất đối với hạn mức sử dụng của bạn và được tính phí riêng.
  • Có độ trễ vài giây giữa thời điểm next_page_token được phát hành và thời điểm có hiệu lực. Việc yêu cầu trang tiếp theo trước khi trang đó có sẵn sẽ trả về phản hồi INVALID_REQUEST. Yêu cầu có next_page_token luôn bị tính phí.

Ví dụ: trong truy vấn bên dưới, chúng tôi tìm kiếm các nhà hàng gần Darling Harbour, ở Sydney, Úc và xếp hạng kết quả theo khoảng cách. Bạn có thể thấy phản hồi chứa thuộc tính 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"
}

Để xem nhóm kết quả tiếp theo, bạn có thể gửi một truy vấn mới, truyền kết quả của next_page_token đến tham số pagetoken. Ví dụ: 

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