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 (Cũ) cho phép bạn tìm kiếm các đị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 (Phiên bản 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 hai giá trị sau:

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

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

Thông 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ể điều chỉnh kết quả theo một vòng tròn cụ thể bằng cách truyền tham số location và radius. Khi đó, dịch vụ Places sẽ được hướng dẫn ư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 ở giá trị tối đa tuỳ thuộc vào loại tìm kiếm và các thông số khác.

    • Tự động hoàn thành: 50.000 mét
    • Nearby Search:
      • có 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 hoạt 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ủa các cơ sở. Mọi loại dữ liệu đầu vào khác đều có thể gây ra lỗi và không đảm bảo trả về kết quả hợp lệ. Dịch vụ Google Places sẽ trả về các kết quả trùng khớp có thể dựa trên chuỗi này và sắp xếp các 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í một cách rõ ràng bằng cách sử dụng tham số này có thể xung đột với các tham số vị trí, bán kính và rankby, dẫn đến kết quả không mong muốn.

    Nếu bạn bỏ qua tham số này, 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ữ mà bạn muốn nhận kết quả.

    • Xem danh sách các 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 cung cấp một đị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 đó, phương thức này sẽ trả về địa chỉ đường phố bằng ngôn ngữ địa phương, được chuyển tự sang một kịch bản mà người dùng có thể đọc được (nếu cần), tuân theo ngôn ngữ ưu tiên. Tất cả các địa chỉ khác đều được trả về bằng ngôn ngữ ưu tiên. Tất cả cá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 kết quả trùng khớp gần nhất.
    • Ngôn ngữ ưu tiên có ảnh hưởng nhỏ đến tập hợp kết quả mà API chọn trả về và thứ tự trả về. Trình mã hoá địa lý diễn giải các từ viết tắt theo nhiều cách 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à từ đồng nghĩa với đường phố trong tiếng Hungary.

  • maxprice

    Chỉ hiển thị kết quả là những địa điểm trong phạm vi đã chỉ định. Các giá trị hợp lệ nằm trong khoảng từ 0 (rẻ nhất) đến 4 (đắt nhất). Số tiền chính xác được biểu thị bằng một giá trị cụ thể sẽ thay đổi theo từng khu vực.

  • minprice

    Chỉ hiển thị kết quả là những địa điểm trong phạm vi đã chỉ định. Các giá trị hợp lệ nằm trong khoảng từ 0 (rẻ nhất) đến 4 (đắt nhất). Số tiền chính xác được biểu thị bằng một giá trị cụ thể sẽ thay đổi theo từng 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 kinh doanh 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 Google Places sẽ không được trả về nếu bạn thêm tham số này vào truy vấn.

  • pagetoken

    Trả về tối đa 20 kết quả của 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 tìm kiếm với các tham số tương tự đã dùng trước đó – tất cả các tham số khác ngoài pagetoken sẽ 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 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ể bị ảnh hưởng bởi 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. Lựa chọn này sắp xếp 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 trong số keyword, name hoặc type và không được phép dùng radius.

  • loại

    Hạn chế kết quả chỉ hiển thị những địa điểm phù hợp với loại được chỉ định. Bạn chỉ có thể chỉ định một loại. Nếu bạn cung cấp nhiều loại, 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 sẽ bị bỏ qua hoàn toàn

    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 bạn để yêu cầu hoạt động trong ứng dụng.

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

Ví dụ sau đây minh hoạ một phản hồi của Nearby Search (Phiên bản 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",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8676569, "lng": 151.2017213 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86629922010728, "lng": 151.2031712798927 },
                "southwest":
                  { "lat": -33.86899887989272, "lng": 151.2004716201073 },
              },
          },
        "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": "Clearview Sydney Harbour Cruises",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 685,
              "html_attributions":
                [
                  'Clearview Glass Boat Cruises',
                ],
              "photo_reference": "Aap_uEAlExjnXA0VWyb_oYwCJ8utWG_Ennhwmn_xadpgenMNUgTuxrvgf1Xdw4bsbL6kFSWH7bhbpVHK1esdNY37ancJvbL_Gnsc7EZ5KEBNPvYZ_ZEyLco4a5v34LFkodxfFZbJ-ejO3zN4W_0C37P5jAmTnLWMNFYUPvoU3UMi70qHRNF5",
              "width": 1024,
            },
          ],
        "place_id": "ChIJNQfwZTiuEmsR1m1x9w0E2V0",
        "plus_code":
          {
            "compound_code": "46J2+WM Sydney, New South Wales",
            "global_code": "4RRH46J2+WM",
          },
        "rating": 3.8,
        "reference": "ChIJNQfwZTiuEmsR1m1x9w0E2V0",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 49,
        "vicinity": "32 The Promenade King Street Wharf 5, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8677035, "lng": 151.2017297 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86634597010728, "lng": 151.2031781298927 },
                "southwest":
                  { "lat": -33.86904562989272, "lng": 151.2004784701072 },
              },
          },
        "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 Lunch Cruise",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 545,
              "html_attributions":
                [
                  'Sydney Harbour Lunch Cruise',
                ],
              "photo_reference": "Aap_uEBFyQ2xDzHk7dGF_FTvNeJ01NQD6GROq89rufdGQl5Gi0zVfpnETBjPK2v7UEDl_6F-m8aR5FcEWJMqPaH4Oh_CQh2jaUAUAesUInucpCe7OFdleSYJ_8kgunhsIvGf1D1s_pes6Rk2JMVEs8rEs6ZHSTmUQXX2Yh-Gt9MuPQdYNuNv",
              "width": 969,
            },
          ],
        "place_id": "ChIJUbf3iDiuEmsROJxXbhYO7cM",
        "plus_code":
          {
            "compound_code": "46J2+WM Sydney, New South Wales",
            "global_code": "4RRH46J2+WM",
          },
        "rating": 3.9,
        "reference": "ChIJUbf3iDiuEmsROJxXbhYO7cM",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 23,
        "vicinity": "5/32 The Promenade, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8675883, "lng": 151.2016452 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86623847010728, "lng": 151.2029950298927 },
                "southwest":
                  { "lat": -33.86893812989273, "lng": 151.2002953701073 },
              },
          },
        "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 Showboats - Dinner Cruise With Show",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4912,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uED1aGaMs8xYfiuzeBqVcFsk3yguUujdE4S3rNThMpLtoU0RukF40KCt0CAxgHP1HoY8Z7NYcWvax6qmMMVPBbmzGhoaiwiAAyv2GGA9vhcgsJ5w0LweT0y1lgRGZxU3nZIdNLiYAp9JHM171UkN04H6UqYSxKVZ8N_f2aslkqOaBF_e",
              "width": 7360,
            },
          ],
        "place_id": "ChIJjRuIiTiuEmsRCHhYnrWiSok",
        "plus_code":
          {
            "compound_code": "46J2+XM Sydney, New South Wales",
            "global_code": "4RRH46J2+XM",
          },
        "rating": 4.1,
        "reference": "ChIJjRuIiTiuEmsRCHhYnrWiSok",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 119,
        "vicinity": "32 The Promenade, King Street Wharf, 5, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8677035, "lng": 151.2017297 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86634597010728, "lng": 151.2031781298927 },
                "southwest":
                  { "lat": -33.86904562989272, "lng": 151.2004784701072 },
              },
          },
        "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": "Magistic Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 1536,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEC8bq-YphfIDcdxANBfgGMBIX2B0ggNep9ddVoePj6sfdcdusIn07x8biaxevZ_6BpzDDRsUL8No5P3ftI4on_pqbAbIEUL5gFGgezpVZ3M9GWvKdJm3njO_aJaghWl4_aQb75c0WGYDRFPhn6fWsLkD7KxodviJeCX4OCGt1eRJnlK",
              "width": 2048,
            },
          ],
        "place_id": "ChIJxRjqYTiuEmsRGebAA_chDLE",
        "plus_code":
          {
            "compound_code": "46J2+WM Sydney, New South Wales",
            "global_code": "4RRH46J2+WM",
          },
        "rating": 3.9,
        "reference": "ChIJxRjqYTiuEmsRGebAA_chDLE",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 99,
        "vicinity": "King Street Wharf, 32 The Promenade, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8609391, "lng": 151.2098735 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85958927010727, "lng": 151.2112233298927 },
                "southwest":
                  { "lat": -33.86228892989272, "lng": 151.2085236701072 },
              },
          },
        "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": "Australian Cruise Group",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 1536,
              "html_attributions":
                [
                  'Keith Bauman',
                ],
              "photo_reference": "Aap_uED7aBwIbN6iuoZi8e9xCrt6F_EhppGCBfzYCgypetw8cGn4Ui0Y3JZe3QJ0buf0zc54BtPz-SWXxecPd6kDvNNZD5Eu_ZzTP13rXMzSDJa6UcwFiXU4y3qYrWAyJ6mtYrd2PJgw0KzvYaZoPze7Ka6zG6k3IOjeSICDYH6YOzkXhelj",
              "width": 2048,
            },
          ],
        "place_id": "ChIJpU8KgUKuEmsRKErVGEaa11w",
        "plus_code":
          {
            "compound_code": "46Q5+JW Sydney, New South Wales",
            "global_code": "4RRH46Q5+JW",
          },
        "rating": 4.4,
        "reference": "ChIJpU8KgUKuEmsRKErVGEaa11w",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 5,
        "vicinity": "6 Cirular Quay, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8686058, "lng": 151.2018206 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86730002010728, "lng": 151.2032717798927 },
                "southwest":
                  { "lat": -33.86999967989272, "lng": 151.2005721201073 },
              },
          },
        "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": "Rhythmboat Cruises",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 2269,
              "html_attributions":
                [
                  'Rhythmboat Sydney Harbour Cruises',
                ],
              "photo_reference": "Aap_uEAT8eop-IsfSAQ3KP6YXRNRsFkESXDecsaPnaVhq5bZzny5guvhS4smciianRGbZgDtFtAcU-ZXTaBfuh80CFw8vpJyKaB4grgW_CW64rU1JF9FDy_M8HtEk3rOrMhPDiF8ns-mc16E4rWSuAQIc76Du_eCd63ofoErESOtSWAQVcew",
              "width": 4032,
            },
          ],
        "place_id": "ChIJyWEHuEmuEmsRm9hTkapTCrk",
        "plus_code":
          {
            "compound_code": "46J2+HP Sydney, New South Wales",
            "global_code": "4RRH46J2+HP",
          },
        "rating": 3.9,
        "reference": "ChIJyWEHuEmuEmsRm9hTkapTCrk",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 30,
        "vicinity": "King Street Wharf, King St, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8712692, "lng": 151.1898651 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86952792010727, "lng": 151.1914560298927 },
                "southwest":
                  { "lat": -33.87222757989272, "lng": 151.1887563701073 },
              },
          },
        "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": "Glass Island",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4480,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEAaToCBaHP7Gfdjc740gwIkQcjeUD97NO0TKXJ5IXB0CLGQA6slEpHn4k9LwyhoAzzbSTXJduYyFIkHVmQWGp34NggRxrtOWp7sJf5N6j0ASYlJPmAtWUaaCWnbx_pxdndsopeJ7PYn9kTiMgFcSs-GeipI8hDZgAJswMBnfsO0xWQ-",
              "width": 6720,
            },
          ],
        "place_id": "ChIJnScuboavEmsRyh-FGxhc3pw",
        "plus_code":
          {
            "compound_code": "45HQ+FW Pyrmont, New South Wales",
            "global_code": "4RRH45HQ+FW",
          },
        "rating": 4.1,
        "reference": "ChIJnScuboavEmsRyh-FGxhc3pw",
        "scope": "GOOGLE",
        "types":
          ["bar", "restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 90,
        "vicinity": "37 Bank St, Pyrmont",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.85876140000001, "lng": 151.2100004 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85737742010728, "lng": 151.2111319298927 },
                "southwest":
                  { "lat": -33.86007707989272, "lng": 151.2084322701072 },
              },
          },
        "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": "Junk Lounge",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 608,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEDaHF9VZFV88tQqFyIgmPlcbCsK-ScCGuUVGh0mTAP4OzWh_0q0T5rPbeC7bas7vD5vC9oS95jtdr4oOnQmhGDAIbHkv4E6UHrQIl0f3XZ-3-RRDjn293w4qQb_BfhbPPO3nokU7npfMfVvCcelWf9WHiWNHT4EEHrFtvuhAWKobTnC",
              "width": 1080,
            },
          ],
        "place_id": "ChIJq9W3HZOvEmsRYtKNTRmq34M",
        "plus_code":
          {
            "compound_code": "46R6+F2 The Rocks, New South Wales",
            "global_code": "4RRH46R6+F2",
          },
        "price_level": 2,
        "rating": 4.1,
        "reference": "ChIJq9W3HZOvEmsRYtKNTRmq34M",
        "scope": "GOOGLE",
        "types": ["restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 63,
        "vicinity": "Level 2, Overseas Passenger Terminal, Circular Quay W, The Rocks",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8677035, "lng": 151.2017297 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86634597010728, "lng": 151.2031781298927 },
                "southwest":
                  { "lat": -33.86904562989272, "lng": 151.2004784701072 },
              },
          },
        "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 New Year's Eve Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 1600,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEDceKHtQ9Hf2eHwnQYXLqrwZ1X2LYVhsfXbqrpIm3_lXZ9apURjAXtVgRVTGxJPD7BtaqR8C7bwaSTakmi0Pazn7g3suj8ZaQRBqheT3KVJDhZ9_GwVInLkWbxqnhivEXs1a-MC_J8XF1SL_5AQ3mAETgiLRQ04116IAEV5vHyIGRsa",
              "width": 2400,
            },
          ],
        "place_id": "ChIJ__8_hziuEmsR27ucFXECfOg",
        "plus_code":
          {
            "compound_code": "46J2+WM Sydney, New South Wales",
            "global_code": "4RRH46J2+WM",
          },
        "rating": 5,
        "reference": "ChIJ__8_hziuEmsR27ucFXECfOg",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 5,
        "vicinity": "King Street Wharf 5, 32 The Promenade, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8669866, "lng": 151.2017231 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86563197010727, "lng": 151.2031347298927 },
                "southwest":
                  { "lat": -33.86833162989272, "lng": 151.2004350701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
        "icon_background_color": "#13B5C7",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "King Street Wharf Darling Harbour",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 3024,
              "html_attributions":
                [
                  '朱品貞',
                ],
              "photo_reference": "Aap_uEDwKXVOjIaCj3LptOdd86B5umsdG7Z3jcvqcpUVLwHS6w8VGEkphgC8-shAx95CrsuXpnKz-XVIixVmgagQHKPH3vSLLqJ6LOAR7Q-_jiyx3ELXD0pm7AARiAtQAMBN9A-oqbtvGbE27yDpvBS1lKe9PCm-dMfrHIIcsS91Qeq2E4b6",
              "width": 4032,
            },
          ],
        "place_id": "ChIJkfDzJ72vEmsR8xtYbk5f0p0",
        "plus_code":
          {
            "compound_code": "46M2+6M Sydney, New South Wales",
            "global_code": "4RRH46M2+6M",
          },
        "rating": 4.4,
        "reference": "ChIJkfDzJ72vEmsR8xtYbk5f0p0",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "convenience_store",
            "bowling_alley",
            "travel_agency",
            "bar",
            "restaurant",
            "food",
            "point_of_interest",
            "store",
            "establishment",
          ],
        "user_ratings_total": 3213,
        "vicinity": "The Promenade, Lime St, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.870383, "lng": 151.1979245 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86901092010727, "lng": 151.1991702798927 },
                "southwest":
                  { "lat": -33.87171057989271, "lng": 151.1964706201073 },
              },
          },
        "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": "The Little Snail Restaurant",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 900,
              "html_attributions":
                [
                  'The Little Snail',
                ],
              "photo_reference": "Aap_uEA9aHKkB_6VoFx4VHRSp19PCwnTOuGfpmDYw1NdYNbzncfdjjfEmiiFz-E4tIJ6iGVZjR_bejX6wNr5thJjqlcdQ2PvPyTTo1jGtxk31JG9b6Vd0vu_v4Ep7yutzf3KTzBjYFBIGsYPf3Pj0DptMWPLP7fn33SBT7YmRqDEoGcUsBzw",
              "width": 1350,
            },
          ],
        "place_id": "ChIJtwapWjeuEmsRcxV5JARHpSk",
        "plus_code":
          {
            "compound_code": "45HX+R5 Pyrmont, New South Wales",
            "global_code": "4RRH45HX+R5",
          },
        "price_level": 2,
        "rating": 4.5,
        "reference": "ChIJtwapWjeuEmsRcxV5JARHpSk",
        "scope": "GOOGLE",
        "types": ["restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 1916,
        "vicinity": "3/50 Murray St, Pyrmont",
      },
    ],
  "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>
 <result>
  <name>Clearview Sydney Harbour Cruises</name>
  <vicinity>32 The Promenade King Street Wharf 5, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8676569</lat>
    <lng>151.2017213</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8689989</lat>
     <lng>151.2004716</lng>
    </southwest>
    <northeast>
     <lat>-33.8662992</lat>
     <lng>151.2031713</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>3.8</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJNQfwZTiuEmsR1m1x9w0E2V0</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uED7hBZqIUaBgFu5q8_xoLMrkWIXUau5D7J2T2fS3HAk4j3aoOp5MQKiujaS8ByzfU9zshp37EMMW6tZe67qLYku2AW-QOVeTbJlyxQ7bqgtSZ_YTo_ES1Xw1bBx8wv8BJYTJZFRzh8enBdH0kLy-oICBpm2fDexARp4CG8Dsxz5bqGA</photo_reference>
   <width>1024</width>
   <height>685</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/114394575270272775071&quot;&gt;Clearview Glass Boat Cruises&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>49</user_ratings_total>
  <place_id>ChIJNQfwZTiuEmsR1m1x9w0E2V0</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+WM</global_code>
   <compound_code>46J2+WM 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>
 <result>
  <name>Sydney Harbour Lunch Cruise</name>
  <vicinity>5/32 The Promenade, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8677035</lat>
    <lng>151.2017297</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8690456</lat>
     <lng>151.2004785</lng>
    </southwest>
    <northeast>
     <lat>-33.8663460</lat>
     <lng>151.2031781</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>3.9</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJUbf3iDiuEmsROJxXbhYO7cM</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uED1kwFA2W4XWHpSNZBxiE10JfyZEJrOz8aAPXpR2GbOg0Pc-yPHJYjt6m007fRdSG2PzvsWdZIFE-lny_NRBGUrSzpk9eNVzDp3GLUeV9G0HXcQv7IhEK6vtm_Updlv66bi8S07h3e_lFiHIzFw0TLVfWXjc63Pm94NN1kug7RPJa-6</photo_reference>
   <width>969</width>
   <height>545</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102428257696490257922&quot;&gt;Sydney Harbour Lunch Cruise&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>23</user_ratings_total>
  <place_id>ChIJUbf3iDiuEmsROJxXbhYO7cM</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+WM</global_code>
   <compound_code>46J2+WM 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>
 <result>
  <name>Sydney Showboats - Dinner Cruise With Show</name>
  <vicinity>32 The Promenade, King Street Wharf, 5, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675883</lat>
    <lng>151.2016452</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8689381</lat>
     <lng>151.2002954</lng>
    </southwest>
    <northeast>
     <lat>-33.8662385</lat>
     <lng>151.2029950</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.1</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJjRuIiTiuEmsRCHhYnrWiSok</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEAGYIvNdkpJvsbVLPNaMlKukR9jvX48rKMo_TPqbSBRYqvYGExwQM8YvHrz83U7UOJosNI0kay5wV9vZdr9fR12ElFlK5fY3xdoS9N9T08ejq2gLABJJK-Bwl4W2IPw9imoWef1BYMVP07WhXhVOs05a-2A3Qm5fKCRILgUis5pMeCg</photo_reference>
   <width>7360</width>
   <height>4912</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/105311284660389698992&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>119</user_ratings_total>
  <place_id>ChIJjRuIiTiuEmsRCHhYnrWiSok</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>
 <result>
  <name>Magistic Cruises</name>
  <vicinity>King Street Wharf, 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.8677035</lat>
    <lng>151.2017297</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8690456</lat>
     <lng>151.2004785</lng>
    </southwest>
    <northeast>
     <lat>-33.8663460</lat>
     <lng>151.2031781</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>3.9</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJxRjqYTiuEmsRGebAA_chDLE</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDbALKhgsD-bIG6fWxrermkmKtpIKDHthAySc9EjPEpWDQQtYsSgB4AqLVMArTFCWd04Vb9U51st96ONjtDmWf8KsjKwYtkWxYDFzaY9ZmO2UQpV3rnqjmNHXtIsCdjjwADQbumAkjn5WzBJ-DqlVZs9NmlpLvAY6Jg4DGhduWdewv4</photo_reference>
   <width>2048</width>
   <height>1536</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/103073818292552522030&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>99</user_ratings_total>
  <place_id>ChIJxRjqYTiuEmsRGebAA_chDLE</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+WM</global_code>
   <compound_code>46J2+WM 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>
 <result>
  <name>Australian Cruise Group</name>
  <vicinity>6 Cirular Quay, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8609391</lat>
    <lng>151.2098735</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8622889</lat>
     <lng>151.2085237</lng>
    </southwest>
    <northeast>
     <lat>-33.8595893</lat>
     <lng>151.2112233</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJpU8KgUKuEmsRKErVGEaa11w</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uECGcpPB2lEO6gIB3QzHeviDhXcG-RV3TXuJPiBHGWbDxnflOhymebF45afUMBIW9r3xC2_gHfiqicV4VnooMJ2-Kwy0YocFXk1_0kkmR1HPV2D9kN9h-yPVK5d6oSPMdmY4MjCut3n8Tv9vt6iu44DDnafb2j78R34EcLQ4iFl0sots</photo_reference>
   <width>2048</width>
   <height>1536</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113088009011192061895&quot;&gt;Keith Bauman&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>5</user_ratings_total>
  <place_id>ChIJpU8KgUKuEmsRKErVGEaa11w</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46Q5+JW</global_code>
   <compound_code>46Q5+JW 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>
 <result>
  <name>Rhythmboat Cruises</name>
  <vicinity>King Street Wharf, King St, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8686058</lat>
    <lng>151.2018206</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8699997</lat>
     <lng>151.2005721</lng>
    </southwest>
    <northeast>
     <lat>-33.8673000</lat>
     <lng>151.2032718</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>3.9</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJyWEHuEmuEmsRm9hTkapTCrk</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEAP5i23uwF3dotBD71Tr0YcEXCHnPOem0CKzKev5YX5dvp63wX7rbLZ3bHNNshIf9P0v3z6GKdF8yJkX3wxXWvzv7EfLwWbwGXYkA-vrXm72ek66P1FlNtNHcbIIyF9HQ1MDXZAhwLcnNJObbk8z9lKmCkBQJCQnkLsGHshZ_ZZCM6L</photo_reference>
   <width>4032</width>
   <height>2269</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104066891898402903288&quot;&gt;Rhythmboat Sydney Harbour Cruises&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>30</user_ratings_total>
  <place_id>ChIJyWEHuEmuEmsRm9hTkapTCrk</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+HP</global_code>
   <compound_code>46J2+HP 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>
 <result>
  <name>Glass Island</name>
  <vicinity>37 Bank St, Pyrmont</vicinity>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8712692</lat>
    <lng>151.1898651</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8722276</lat>
     <lng>151.1887564</lng>
    </southwest>
    <northeast>
     <lat>-33.8695279</lat>
     <lng>151.1914560</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.1</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJnScuboavEmsRyh-FGxhc3pw</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uECzZC-aNaQunm_EMgTFeFyR5-u7E19MSZNuRbK14Tq-GxK-glsLoeqtmdOkA307MesbO6Xqau_7bGM4w5vwxMnPPkc8tEQniNQjgC1M1g9OpMwdd4_8nhmBwOMkzUZk1KU0R9CFYxx7YY5a-HywQSK8kTr1FLXX3y23bSkaDvsgenBr</photo_reference>
   <width>6720</width>
   <height>4480</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117745044320706972021&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>90</user_ratings_total>
  <place_id>ChIJnScuboavEmsRyh-FGxhc3pw</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH45HQ+FW</global_code>
   <compound_code>45HQ+FW Pyrmont, 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>
 <result>
  <name>Junk Lounge</name>
  <vicinity>Level 2, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8587614</lat>
    <lng>151.2100004</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8600771</lat>
     <lng>151.2084323</lng>
    </southwest>
    <northeast>
     <lat>-33.8573774</lat>
     <lng>151.2111319</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.1</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJq9W3HZOvEmsRYtKNTRmq34M</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEBNQHy0vHfeUWJid28kkZIf4EcgMp50UmkpvhoYPwZJBYImlASnKV4fHlaXTlNQI8H_jUqDpToiMwFOE2XsDpHBdLeZGxpoMq5ThL1gSEMo1zp9U_Pd5jhamilQbpkEeZN_CVeHLAnOX5CG21IF8pda1Zj8IuuENzaKi2BLNQ5TCyYq</photo_reference>
   <width>1080</width>
   <height>608</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104473997089847488714&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>63</user_ratings_total>
  <place_id>ChIJq9W3HZOvEmsRYtKNTRmq34M</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46R6+F2</global_code>
   <compound_code>46R6+F2 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/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Sydney New Year's Eve Cruises</name>
  <vicinity>King Street Wharf 5, 32 The Promenade, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8677035</lat>
    <lng>151.2017297</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8690456</lat>
     <lng>151.2004785</lng>
    </southwest>
    <northeast>
     <lat>-33.8663460</lat>
     <lng>151.2031781</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>5.0</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJ__8_hziuEmsR27ucFXECfOg</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB3hrLc-p5rV8oczY8fo4vdDdw1c0ZXLzbcgek15WzOon1Qd3WbMfmx994E05fFb5Tt1E60Iux0jaEwGkoy477ru-ZYRD1KUZrfMNw46ciZhnHRD2ZX_nWVYkw2VG_AdEDw1DJ3YQEuDP4EJ5IpsoKianbWyIlmaeuy63TfjdvuFs18</photo_reference>
   <width>2400</width>
   <height>1600</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115281801304517408477&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>5</user_ratings_total>
  <place_id>ChIJ__8_hziuEmsR27ucFXECfOg</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+WM</global_code>
   <compound_code>46J2+WM 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>
 <result>
  <name>King Street Wharf Darling Harbour</name>
  <vicinity>The Promenade, Lime St, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>bowling_alley</type>
  <type>convenience_store</type>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>store</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8669866</lat>
    <lng>151.2017231</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8683316</lat>
     <lng>151.2004351</lng>
    </southwest>
    <northeast>
     <lat>-33.8656320</lat>
     <lng>151.2031347</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJkfDzJ72vEmsR8xtYbk5f0p0</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEACFUVsoIAR-DdQfFF-95EUG-vLZ4rE0twMHUMam4JM7qPjrfmrVpC80g8CHtMEcimKBxtiGYaEVp7dw12FhfkJw8hZI-bK4Ls9BY3AnvdoUbfVkBvLC7yqT5ly-gMW2ZT8rLc5-mKaZHbWZyZEPgWs84Qd6KPnEKRx6dGNEevYaUlL</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/101920674986627213698&quot;&gt;朱品貞&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>3213</user_ratings_total>
  <place_id>ChIJkfDzJ72vEmsR8xtYbk5f0p0</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46M2+6M</global_code>
   <compound_code>46M2+6M Sydney, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#13B5C7</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>
 <result>
  <name>The Little Snail Restaurant</name>
  <vicinity>3/50 Murray St, Pyrmont</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8703830</lat>
    <lng>151.1979245</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8717106</lat>
     <lng>151.1964706</lng>
    </southwest>
    <northeast>
     <lat>-33.8690109</lat>
     <lng>151.1991703</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>ChIJtwapWjeuEmsRcxV5JARHpSk</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB9EuRqd4be_9HrlUI7lbC5aDokS8UASO_ogA9OFQwEZsFD_jXDwK2Xc2kQm_wDE9TBI_20Na4TcRkgZoers93pw9cJ5RAbedKbUYAvAJz9c-zWKdqRd7pWaOlInQmbJVohI4ZsqbtlhynDqmfgX1SIccGuh066nlxyX7oFvYoLSbNb</photo_reference>
   <width>1350</width>
   <height>900</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/114727320476039103791&quot;&gt;The Little Snail&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>1916</user_ratings_total>
  <place_id>ChIJtwapWjeuEmsRcxV5JARHpSk</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH45HX+R5</global_code>
   <compound_code>45HX+R5 Pyrmont, 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/restaurant_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 bộ thông tin ghi nhận quyền tác giả về trang thông tin này mà người dùng phải nhìn thấy (một số trang thông tin có thể không có thông tin ghi nhận quyền tác giả).

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ủa các trường do yêu cầu Place Details trả về. 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, bạn có thể sử dụng tính năng Tìm kiếm địa điểm để nhận place_id, sau đó sử dụng Mã địa điểm đó để đưa ra yêu cầu Chi tiết về địa điểm.

Hãy xem phần Đị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 khiến 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 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 đằng sau 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 có thể thay đổi.

tùy chọn Array<string>

Khi dịch vụ trả về thông tin bổ sung về quy cách 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. Có thể không phải lúc nào cũng được trả về và nội dung của thông báo này có thể thay đổi.

next_page_token

tùy chọn chuỗi

Chứa một 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 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 trở nên hợp lệ.

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 quá trình 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 cụm từ tìm kiếm được truyền một latlng ở một 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ỳ thông tin 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 cho tài khoản của mình.
    • Bạn đã vượt quá hạn mức sử dụng tự đặt hoặc hạn mức tín dụng 200 USD hằng tháng.
    • Phương thức thanh toán bạn cung cấp không còn hợp lệ (ví dụ: thẻ tín dụng đã hết hạn).
    Xem phần Câu hỏi thường gặp về Maps để biết thêm thông tin về cách khắc phục 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 đã xảy ra lỗi không xác định.

Địa điểm

Thuộc tính mô tả một địa điểm. Không phải loại địa điểm nào cũng có sẵn tất cả các thuộc tính.

Trường Bắt buộc Loại Mô tả
tùy chọn Array<AddressComponent>

Một mảng chứa các thành phần riêng biệt áp dụng cho địa chỉ này.

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

tùy chọn chuỗi

Thông tin về địa chỉ của địa điểm trong định dạng vi mô adr.

tùy chọn chuỗi

Cho biết trạng thái hoạt động của địa điểm, nếu đó là một doanh nghiệp. Nếu không có dữ liệu, business_status sẽ không được trả về.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
tùy chọn boolean

Chỉ định xem doanh nghiệp có hỗ trợ dịch vụ lấy hàng tại lề đường hay không.
tùy chọn PlaceOpeningHours

Chứa giờ hoạt động trong 7 ngày tới (kể cả hôm nay). Khoảng thời gian này bắt đầu từ nửa đêm vào ngày yêu cầu và kết thúc lúc 23:59 sáu ngày sau đó. Trường này bao gồm trường con special_days của tất cả các giờ, được đặt cho những ngày có giờ hoạt động đặc biệt.

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

tùy chọn boolean

Cho biết liệu doanh nghiệp có hỗ trợ dịch vụ giao hàng hay không.
tùy chọn boolean

Cho biết liệu doanh nghiệp có hỗ trợ lựa chọn chỗ ngồi trong nhà hay ngoài trời hay không.

tùy chọn PlaceEditorialSummary

Chứa thông tin tóm tắt về địa điểm. Bản tóm tắt bao gồm thông tin tổng quan bằng văn bản và mã ngôn ngữ cho những thông tin này (nếu có). Bạn phải trình bày văn bản tóm tắt nguyên trạng và không được sửa đổi hoặc thay đổi.

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

tùy chọn chuỗi

Một chuỗi ký tự chứa địa chỉ mà con người có thể đọc được của địa điểm này.

Địa chỉ này thường tương đương với địa chỉ bưu điện. Xin lưu ý rằng một số quốc gia (chẳng hạn như Vương quốc Anh) không cho phép phân phối địa chỉ bưu chính thực do các quy định hạn chế về việc cấp phép.

Địa chỉ được định dạng bao gồm một hoặc nhiều thành phần địa chỉ. Ví dụ: địa chỉ "111 8th Avenue, New York, NY" bao gồm các thành phần sau: "111" (số nhà), "8th Avenue" (tuyến đường), "New York" (thành phố) và "NY" (tiểu bang của Hoa Kỳ).

Không phân tích cú pháp địa chỉ được định dạng theo phương thức lập trình. Thay vào đó, bạn nên sử dụng các thành phần địa chỉ riêng lẻ mà phản hồi API bao gồm ngoài trường địa chỉ được định dạng.

tùy chọn chuỗi

Chứa số điện thoại của địa điểm ở định dạng địa phương.

tùy chọn Hình học

Chứa vị trí và khung hiển thị cho vị trí.

Hãy xem phần Hình học để biết thêm thông tin.
tùy chọn chuỗi

Chứa URL của một biểu tượng được đề xuất mà người dùng có thể nhìn thấy khi biểu thị kết quả này trên bản đồ.

tùy chọn chuỗi

Chứa mã màu HEX mặc định cho danh mục của địa điểm.
tùy chọn chuỗi

Chứa URL của một biểu tượng được đề xuất, trừ đuôi loại tệp .svg hoặc .png.

tùy chọn chuỗi

Chứa số điện thoại của địa điểm ở định dạng quốc tế. Định dạng quốc tế bao gồm mã quốc gia và có dấu cộng (+) ở phía trước. Ví dụ: international_phone_number cho văn phòng của Google tại Sydney, Úc là +61 2 9374 4000.

tùy chọn chuỗi

Chứa tên mà con người có thể đọc được cho kết quả được trả về. Đối với kết quả establishment, đây thường là tên doanh nghiệp được chuẩn hoá.

tùy chọn PlaceOpeningHours

Chứa giờ hoạt động thông thường.

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

tùy chọn boolean

Sử dụng business_status để biết trạng thái hoạt động của các doanh nghiệp.

tùy chọn Array<PlacePhoto>

Một mảng gồm các đối tượng ảnh, mỗi đối tượng chứa một thông tin tham chiếu đến một hình ảnh. Một yêu cầu có thể trả về tối đa 10 bức ảnh. Bạn có thể tìm thêm thông tin về ảnh địa điểm và cách sử dụng hình ảnh trong ứng dụng của mình trong tài liệu Place Photos.

Hãy xem PlacePhoto để biết thêm thông tin.
tùy chọn chuỗi

Giá trị nhận dạng dạng văn bản xác định một địa điểm duy nhất. Để truy xuất thông tin về địa điểm, hãy truyền giá trị nhận dạng này vào trường place_id của yêu cầu Places API. Để biết thêm thông tin về mã địa điểm, hãy xem tổng quan về mã địa điểm.

tùy chọn PlusCode

Một thông tin tham chiếu được mã hoá về vị trí, bắt nguồn từ toạ độ vĩ độ và kinh độ, đại diện cho một khu vực: 1/8000 độ theo 1/8000 độ (khoảng 14 m x 14 m tại đường xích đạo) hoặc nhỏ hơn. Bạn có thể dùng mã cộng để thay thế địa chỉ đường phố ở những nơi không có địa chỉ đường phố (nơi các toà nhà không được đánh số hoặc đường phố không có tên). Xem Open Location Code và plus code.

Hãy xem PlusCode để biết thêm thông tin.
tùy chọn số

Mức giá của địa điểm, trên thang điểm từ 0 đến 4. 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. Các mức giá được diễn giải như sau:

  • 0 Miễn phí
  • 1 Rẻ
  • 2 Trung bình
  • 3 Đắt
  • 4 Rất đắt
tùy chọn số

Chứa đ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.

tùy chọn chuỗi
tùy chọn boolean

Chỉ định xem địa điểm có hỗ trợ đặt chỗ hay không.
tùy chọn Array<PlaceReview>

Một mảng JSON gồm tối đa 5 bài đánh giá. Theo mặc định, các bài đánh giá được sắp xếp theo mức độ liên quan. Sử dụng tham số yêu cầu reviews_sort để kiểm soát việc sắp xếp.

  • Đối với most_relevant (mặc định), các bài đánh giá được sắp xếp theo mức độ phù hợp; dịch vụ sẽ thiên về kết quả để trả về các bài đánh giá được viết bằng ngôn ngữ ưu tiên.
  • Đối với newest, các bài đánh giá được sắp xếp theo thứ tự thời gian; ngôn ngữ ưu tiên không ảnh hưởng đến thứ tự sắp xếp.

Google đề xuất cho người dùng biết liệu kết quả có được sắp xếp theo most_relevant hay newest hay không.

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

tùy chọn chuỗi
tùy chọn Array<PlaceOpeningHours>

Chứa một mảng các mục cho 7 ngày tiếp theo, bao gồm thông tin về giờ hoạt động phụ của một doanh nghiệp. Giờ hoạt động phụ khác với giờ hoạt động chính của doanh nghiệp. Ví dụ: một nhà hàng có thể chỉ định giờ lái xe qua hoặc giờ giao hàng là giờ phụ. Trường này điền vào trường phụ type, lấy dữ liệu từ danh sách được xác định trước về các loại giờ mở cửa (chẳng hạn như DRIVE_THROUGH, PICKUP hoặc TAKEOUT) dựa trên các loại địa điểm. Trường này bao gồm trường con special_days của tất cả các giờ, được đặt cho những ngày có giờ đặc biệt.

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

tùy chọn boolean

Cho biết địa điểm có phục vụ bia hay không.
tùy chọn boolean

Cho biết địa điểm có phục vụ bữa sáng hay không.
tùy chọn boolean

Cho biết địa điểm có phục vụ bữa sáng muộn hay không.
tùy chọn boolean

Cho biết địa điểm có phục vụ bữa tối hay không.
tùy chọn boolean

Cho biết địa điểm có phục vụ bữa trưa hay không.
tùy chọn boolean

Cho biết địa điểm có phục vụ đồ ăn chay hay không.
tùy chọn boolean

Cho biết địa điểm có phục vụ rượu vang hay không.
tùy chọn boolean

Chỉ định xem doanh nghiệp có hỗ trợ dịch vụ mang đi hay không.
tùy chọn Array<string>

Chứa một mảng các loại tính năng mô tả kết quả đã cho. Hãy xem danh sách các loại được hỗ trợ.

tùy chọn chuỗi

Chứa URL của trang chính thức của Google cho địa điểm này. Đây sẽ là trang thuộc sở hữu của Google, chứa thông tin tốt nhất hiện có về địa điểm đó. Các ứng dụng phải liên kết đến hoặc nhúng trang này trên mọi màn hình hiển thị kết quả chi tiết về địa điểm cho người dùng.

tùy chọn số

Tổng số bài đánh giá (kèm theo hoặc không kèm theo nội dung) cho địa điểm này.

tùy chọn số

Chứa số phút mà múi giờ hiện tại của địa điểm này nhanh hơn hoặc chậm hơn so với giờ UTC. Ví dụ: đối với những nơi ở Sydney, Úc trong giờ mùa hè, giá trị này sẽ là 660 (+11 giờ so với giờ UTC) và đối với những nơi ở California ngoài giờ mùa hè, giá trị này sẽ là -480 (-8 giờ so với giờ UTC).

tùy chọn chuỗi

Chỉ dành cho kết quả về cơ sở lưu trú (types:["establishment", ...])), trường vicinity chứa địa chỉ đơn giản của địa điểm, bao gồm tên đường, số nhà và thành phố, nhưng không bao gồm tỉnh/tiểu bang, mã bưu chính hoặc quốc gia.

Đối với tất cả các kết quả khác, trường vicinity chứa tên của đối tượng hành chính (types:["political", ...]) hẹp nhất có trong địa chỉ của kết quả.

Bạn nên đọc nội dung này như hiện trạng. Đừng phân tích cú pháp địa chỉ đã định dạng theo cách lập trình.

tùy chọn chuỗi

Trang web chính thức của địa điểm này, chẳng hạn như trang chủ của doanh nghiệp.

tùy chọn boolean

Cho biết địa điểm có lối vào dành cho xe lăn hay không.

PlaceEditorialSummary

Chứa thông tin tóm tắt về địa điểm. Bản tóm tắt bao gồm thông tin tổng quan bằng văn bản và cả mã ngôn ngữ cho những thông tin này (nếu có). Bạn phải trình bày văn bản tóm tắt nguyên trạng và không được sửa đổi hoặc thay đổi.

Trường Bắt buộc Loại Mô tả
tùy chọn chuỗi

Ngôn ngữ của các trường trước đó. Có thể không phải lúc nào cũng xuất hiện.
tùy chọn chuỗi

Nội dung tóm tắt bằng văn bản có độ dài trung bình về địa điểm.

PlaceOpeningHours

Một đối tượng mô tả giờ mở cửa của một địa điểm.

Trường Bắt buộc Loại Mô tả
tùy chọn boolean

Giá trị boolean cho biết địa điểm có đang mở cửa tại thời điểm hiện tại hay không.

tùy chọn Array<PlaceOpeningHoursPeriod>

Một mảng gồm các khoảng thời gian mở cửa trong 7 ngày, bắt đầu từ Chủ Nhật, theo thứ tự thời gian.

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

tùy chọn Array<PlaceSpecialDay>

Một mảng có tối đa 7 mục tương ứng với 7 ngày tiếp theo.

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

tùy chọn chuỗi

Một chuỗi loại dùng để xác định loại giờ hoạt động phụ (ví dụ: DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). Chỉ đặt cho secondary_opening_hours.

weekday_text

tùy chọn Array<string>

Một mảng gồm các chuỗi mô tả bằng văn bản mà con người có thể đọc được về giờ hoạt động của địa điểm.

PlaceOpeningHoursPeriod

Trường Bắt buộc Loại Mô tả
bắt buộc PlaceOpeningHoursPeriodDetail

Chứa một cặp đối tượng ngày và giờ mô tả thời điểm địa điểm mở cửa.

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

tùy chọn PlaceOpeningHoursPeriodDetail

Có thể chứa một cặp đối tượng ngày và giờ mô tả thời điểm đóng cửa của địa điểm. Nếu một địa điểm luôn mở cửa, thì phần đóng cửa sẽ không có trong phản hồi. Khách hàng có thể dựa vào trạng thái luôn mở được biểu thị là một khoảng thời gian mở có chứa ngày với giá trị 0 và thời gian với giá trị 0000, và không có close.

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

PlaceSpecialDay

Trường Bắt buộc Loại Mô tả
tùy chọn chuỗi

Ngày được biểu thị theo định dạng RFC3339 trong múi giờ địa phương của địa điểm, ví dụ: 2010-12-31.

tùy chọn boolean

True nếu có giờ đặc biệt cho ngày này. Nếu là true, điều này có nghĩa là có ít nhất một trường hợp ngoại lệ cho ngày này. Các trường hợp ngoại lệ khiến các giá trị khác nhau xuất hiện trong các trường con của current_opening_hours và secondary_opening_hours, chẳng hạn như periods, weekday_text, open_now. Các trường hợp ngoại lệ áp dụng cho giờ hoạt động và giờ hoạt động được dùng để tạo các trường khác.

PlaceOpeningHoursPeriodDetail

Trường Bắt buộc Loại Mô tả
bắt buộc số

Một số từ 0 đến 6, tương ứng với các ngày trong tuần, bắt đầu từ Chủ Nhật. Ví dụ: 2 có nghĩa là thứ Ba.

bắt buộc chuỗi

Có thể chứa thời gian trong ngày ở định dạng hhmm 24 giờ. Giá trị nằm trong phạm vi 0000–2359. Thời gian sẽ được báo cáo theo múi giờ của địa điểm.

tùy chọn chuỗi

Ngày được biểu thị theo định dạng RFC3339 trong múi giờ địa phương của địa điểm, ví dụ: 2010-12-31.

tùy chọn boolean

True nếu một khoảng thời gian nhất định bị cắt ngắn do giới hạn 7 ngày, trong đó khoảng thời gian bắt đầu trước nửa đêm vào ngày có yêu cầu và/hoặc kết thúc vào hoặc sau nửa đêm vào ngày cuối cùng. Thuộc tính này cho biết khoảng thời gian mở hoặc đóng có thể kéo dài quá thời hạn 7 ngày này.

PlacePhoto

Ảnh về một Địa điểm. Bạn có thể truy cập vào ảnh thông qua API Ảnh địa điểm bằng cách sử dụng một URL theo mẫu sau: 

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

Hãy xem phần Ảnh về địa điểm để biết thêm thông tin.

Trường Bắt buộc Loại Mô tả
bắt buộc số

Chiều cao của bức ảnh.
bắt buộc Array<string>

Thông tin ghi công HTML cho ảnh.
bắt buộc chuỗi

Một chuỗi dùng để xác định ảnh khi bạn thực hiện yêu cầu Photo.

bắt buộc số

Chiều rộng của ảnh.

PlaceReview

Bài đánh giá về địa điểm do người dùng gửi.

Trường Bắt buộc Loại Mô tả
bắt buộc chuỗi

Tên của người dùng đã gửi bài đánh giá. Các bài đánh giá ẩn danh được ghi nhận là của "Một người dùng Google".

bắt buộc số

Điểm xếp hạng chung của người dùng cho địa điểm này. Đây là một số nguyên, trong khoảng từ 1 đến 5.

bắt buộc chuỗi

Thời gian gửi bài đánh giá ở dạng văn bản, so với thời gian hiện tại.

bắt buộc số

Thời gian gửi bài đánh giá, tính bằng số giây kể từ nửa đêm ngày 1 tháng 1 năm 1970 theo giờ UTC.

tùy chọn chuỗi

URL đến hồ sơ Local Guides của người dùng trên Google Maps (nếu có).

tùy chọn chuỗi

Mã ngôn ngữ IETF cho biết ngôn ngữ của bài đánh giá được trả về.Trường này chỉ chứa thẻ ngôn ngữ chính, chứ không chứa thẻ phụ cho biết quốc gia hoặc khu vực. Ví dụ: tất cả bài đánh giá bằng tiếng Anh đều được gắn thẻ là "en", chứ không phải "en-AU" hoặc "en-UK", v.v. Trường này sẽ trống nếu chỉ có điểm xếp hạng mà không có văn bản đánh giá.

tùy chọn chuỗi

Mã ngôn ngữ IETF cho biết ngôn ngữ gốc của bài đánh giá. Nếu bài đánh giá đã được dịch, thì original_language != language.Trường này chỉ chứa thẻ ngôn ngữ chính, chứ không chứa thẻ phụ cho biết quốc gia hoặc khu vực. Ví dụ: tất cả bài đánh giá bằng tiếng Anh đều được gắn thẻ là "en", chứ không phải "en-AU" hoặc "en-UK", v.v. Trường này sẽ trống nếu chỉ có điểm xếp hạng mà không có văn bản đánh giá.

tùy chọn chuỗi

URL dẫn đến ảnh hồ sơ của người dùng (nếu có).

text

tùy chọn chuỗi

Bài đánh giá của người dùng. Khi đánh giá một địa điểm bằng Google Places, bạn không bắt buộc phải viết bài đánh giá bằng văn bản. Do đó, trường này có thể trống. Xin lưu ý rằng trường này có thể bao gồm mã đánh dấu HTML đơn giản. Ví dụ: tham chiếu thực thể &amp; có thể biểu thị một ký tự và.

tùy chọn boolean

Giá trị boolean cho biết bài đánh giá có được dịch từ ngôn ngữ gốc mà bài đánh giá được viết hay không.Nếu bài đánh giá đã được dịch, tương ứng với giá trị true, thì Google khuyên bạn nên cho người dùng biết điều này. Ví dụ: bạn có thể thêm chuỗi "Do Google dịch" vào bài đánh giá.

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ả, được chia thành 3 trang. Nếu kết quả tìm kiếm của bạn có nhiều hơn 20, thì phản hồi tìm kiếm sẽ có thêm một giá trị nữa là 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 là giá trị 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 thông số khác bị bỏ qua.
  • Bạn có thể yêu cầu một trang mới tối đa 2 lần sau cụm từ tìm kiếm ban đầu.
  • Mỗi yêu cầu, kể cả yêu cầu sử dụng next_page_token, đều được tính là một yêu cầu duy nhất theo hạn mức sử dụng của bạn và được tính phí riêng.
  • Có một độ trễ vài giây giữa thời điểm next_page_token được phát hành và thời điểm next_page_token trở nên hợp lệ. Yêu cầu trang tiếp theo trước khi trang đó có sẵn sẽ trả về một phản hồi INVALID_REQUEST. Các 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 Cảng Darling ở Sydney, Úc và xếp hạng kết quả theo khoảng cách. Bạn có thể thấy rằng phản hồi chứa một 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