Tìm kiếm văn bản (Cũ)

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

Tìm kiếm văn bản (Phiên bản cũ) trả về thông tin về một nhóm địa điểm dựa trên một chuỗi, chẳng hạn như "pizza ở New York" hoặc "cửa hàng giày gần Ottawa" hoặc "123 Main Street". Dịch vụ này sẽ phản hồi bằng danh sách các địa điểm khớp với chuỗi văn bản và mọi độ lệch vị trí đã được đặt.

Tính năng Tìm kiếm văn bản (Cũ) không dành cho các cụm từ tìm kiếm không rõ ràng, bao gồm:

Loại truy vấn Ví dụ
Quá nhiều khái niệm hoặc quy tắc ràng buộc, chẳng hạn như tên của nhiều địa điểm, đường hoặc thành phố trong một cụm từ tìm kiếm "Market Street San Francisco San Jose Airport"
Các thành phần của địa chỉ bưu chính không xuất hiện trên Google Maps "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"
Tên của doanh nghiệp, chuỗi hoặc danh mục kết hợp với vị trí mà các pháp nhân này không có mặt "Tesco gần Dallas, Texas"
Cụm từ tìm kiếm mơ hồ có nhiều cách diễn giải "Điểm trả bộ sạc"
Tên cũ không còn được sử dụng "Middlesex Vương quốc Anh"
Các phần tử hoặc ý định không liên quan đến không gian địa lý "Có bao nhiêu chiếc thuyền ở Cảng Ventura?"
Tên không chính thức hoặc tên ảo "The Jenga"
"The Helter Skelter"
Vĩ độ và kinh độ "37.422131,-122.084801"

Phản hồi tìm kiếm bao gồm danh sách các địa điểm. Bạn có thể gửi yêu cầu Chi tiết địa điểm để biết thêm thông tin về bất kỳ địa điểm nào trong phản hồi.

Yêu cầu về tính năng Tìm kiếm văn bản (phiên bản cũ)

Yêu cầu Tìm kiếm văn bản (Cũ) là một URL loại HTTP có dạng như sau:

https://maps.googleapis.com/maps/api/place/textsearch/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 một yêu cầu tìm kiếm. 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

  • truy vấn

    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.

  • 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

  • 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.

  • 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.

    Tham số location có thể bị ghi đè nếu query chứa một vị trí rõ ràng, chẳng hạn như Market in Barcelona. Việc sử dụng dấu ngoặc kép xung quanh cụm từ tìm kiếm cũng có thể ảnh hưởng đến trọng số được gán cho location và radius.

  • maxprice

    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.

  • 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.

  • 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 sẽ bị bỏ qua.

  • region

    Mã khu vực, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Hầu hết các mã ccTLD đều giống với mã ISO 3166-1, ngoại trừ một số trường hợp ngoại lệ đáng chú ý. Ví dụ: ccTLD của Vương quốc Anh là "uk" (.co.uk) trong khi mã ISO 3166-1 của quốc gia này là "gb" (về mặt kỹ thuật là cho thực thể "Liên hiệp Vương quốc Anh và Bắc Ireland").

  • 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, thì tất cả các loại sau mục đầu tiên sẽ bị bỏ qua.

    • 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ề tính năng Tìm kiếm văn bản (Cũ)

Lưu ý: Trong các 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.

Ví dụ cơ bản

Ví dụ sau đây cho thấy một lượt tìm kiếm nhà hàng gần Sydney.

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

Ví dụ về địa chỉ chưa đầy đủ

Ví dụ sau đây cho thấy một lượt tìm kiếm địa chỉ không đầy đủ, trong trường hợp này là địa chỉ đường phố không bao gồm thành phố, tiểu bang hoặc quốc gia.

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>

Ví dụ về thiên kiến vị trí

Ví dụ sau đây cho thấy một lượt tìm kiếm cùng một địa chỉ chưa hoàn chỉnh trong ví dụ trước, đồng thời bao gồm các tham số location và radius để thiên vị kết quả cho một khu vực quan tâm.

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>

Câu trả lời của dịch vụ Tìm kiếm văn bản (Phiên bản cũ)

Kết quả tìm kiếm được trả về theo định dạng được chỉ định bằng cờ output trong đường dẫn của yêu cầu URL.

Ví dụ sau đây cho thấy một phản hồi của Tìm kiếm văn bản (Cũ).

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

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. next_page_token sẽ không được trả về nếu không có kết quả bổ sung nào để 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