Thông tin chi tiết về địa điểm (Cũ)

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

Sau khi có place_id từ một lượt tìm kiếm địa điểm, bạn có thể yêu cầu thêm thông tin chi tiết về một cơ sở hoặc địa điểm yêu thích cụ thể bằng cách bắt đầu một yêu cầu Place Details (Phiên bản cũ). Yêu cầu Chi tiết về địa điểm (Phiên bản cũ) trả về thông tin toàn diện hơn về địa điểm được chỉ định, chẳng hạn như địa chỉ đầy đủ, số điện thoại, điểm xếp hạng từ người dùng và bài đánh giá.

Yêu cầu về Place Details (phiên bản cũ)

Yêu cầu Place Details (Phiên bản cũ) là một URL loại HTTP có dạng như sau:

https://maps.googleapis.com/maps/api/place/details/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 tìm kiếm. 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à (&). Dưới đây là danh sách các tham số và giá trị có thể của các tham số đó.

Thông số bắt buộc

Thông số tùy chọn

  • fields

    Thận trọng: Yêu cầu Tìm kiếm địa điểm và yêu cầu Place Details không trả về cùng một trường. 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 đượ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, 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 Place Details. Để biết thêm thông tin về các trường không có trong yêu cầu Tìm kiếm địa điểm, hãy xem phần Hỗ trợ các trường của Places API.

    Sử dụng tham số fields để chỉ định danh sách được phân tách bằng dấu phẩy gồm các loại dữ liệu về địa điểm cần trả về. Ví dụ: fields=formatted_address,name,geometry. Sử dụng dấu gạch chéo xuôi khi chỉ định các giá trị kết hợp. Ví dụ: opening_hours/open_now.

    Các trường được chia thành 3 danh mục thanh toán: Cơ bản, Thông tin liên hệMôi trường. SKU Cơ bản, SKU Thông tin liên hệ và SKU Bầu không khí được tính phí ngoài SKU cơ sở (Place Details, Tìm địa điểm, Nearby Search hoặc Tìm kiếm văn bản) cho yêu cầu đã kích hoạt các SKU này. Để biết thêm thông tin, hãy xem bảng giá.

    Cơ bản

    Danh mục Cơ bản bao gồm các trường sau: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (không dùng nữa), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

    Thông tin liên hệ

    Danh mục Thông tin liên hệ bao gồm các trường sau: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

    Bầu không khí

    Danh mục Khí quyển bao gồm các trường sau: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

    Lưu ý: Thuộc tính, html_attributions, luôn được trả về trong mọi lệnh gọi, bất kể bạn có yêu cầu trường này hay không.
  • 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ụ: utcatér là từ đồng nghĩa với đường phố trong tiếng Hungary.
  • khu vực

    Mã vùng, được chỉ định là giá trị gồm 2 ký tự ccTLD ("miền cấp cao nhất"). Hầu hết mã ccTLD đều giống với mã ISO 3166-1, ngoại trừ một số trường hợp đá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ể "Vương quốc Anh và Bắc Ireland").

  • reviews_no_translations

    Chỉ định reviews_no_translations=true để tắt tính năng dịch bài đánh giá; chỉ định reviews_no_translations=false để bật tính năng dịch bài đánh giá. Các bài đánh giá được trả về bằng ngôn ngữ gốc.

    Nếu bạn bỏ qua hoặc truyền mà không có giá trị, thì tính năng dịch bài đánh giá sẽ được bật. Nếu tham số language được chỉ định trong yêu cầu, hãy sử dụng ngôn ngữ được chỉ định làm ngôn ngữ ưu tiên để dịch. Nếu bạn bỏ qua language, API sẽ cố gắng sử dụng tiêu đề Accept-Language làm ngôn ngữ ưu tiên.

  • reviews_sort

    Phương thức sắp xếp cần dùng khi trả về các bài đánh giá. Có thể đặt thành most_relevant (mặc định) hoặc newest.

    • Đố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 trình tự thời gian; ngôn ngữ ưu tiên không ảnh hưởng đến thứ tự sắp xếp.

    Bạn nên cho người dùng cuối biết cách sắp xếp các bài đánh giá.

  • sessiontoken

    Một chuỗi ngẫu nhiên xác định một phiên tự động hoàn thành cho mục đích thanh toán.

    Phiên bắt đầu khi người dùng bắt đầu nhập một cụm từ tìm kiếm và kết thúc khi họ chọn một địa điểm và thực hiện lệnh gọi đến Place Details. Mỗi phiên có thể có nhiều cụm từ tìm kiếm, sau đó là một lựa chọn về địa điểm. (Các) khoá API được dùng cho mỗi yêu cầu trong một phiên phải thuộc cùng một dự án trên Google Cloud Console. Sau khi một phiên kết thúc, mã thông báo sẽ không còn hợp lệ nữa; ứng dụng của bạn phải tạo một mã thông báo mới cho mỗi phiên. Nếu bạn bỏ qua tham số sessiontoken hoặc nếu bạn sử dụng lại mã thông báo phiên, thì phiên sẽ bị tính phí như thể bạn không cung cấp mã thông báo phiên (mỗi yêu cầu sẽ được tính phí riêng).

    Bạn nên tuân thủ các nguyên tắc sau:

    • Sử dụng mã thông báo phiên cho tất cả các phiên tự động hoàn thành.
    • Tạo một mã thông báo mới cho mỗi phiên. Bạn nên sử dụng UUID phiên bản 4.
    • Đảm bảo rằng(các) khoá API được dùng cho tất cả các yêu cầu về Place Autocomplete và Place Details trong một phiên thuộc cùng một dự án trên Cloud Console.
    • Hãy nhớ truyền một mã thông báo phiên duy nhất cho mỗi phiên mới. Việc sử dụng cùng một mã thông báo cho nhiều phiên sẽ dẫn đến việc mỗi yêu cầu được tính phí riêng lẻ.

Ví dụ về Place Details (cũ)

Ví dụ sau đây yêu cầu thông tin chi tiết về một địa điểm theo place_id và bao gồm các trường name, ratingformatted_phone_number:

Vỏ

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

Xin lưu ý rằng bạn sẽ cần thay thế khoá trong ví dụ này bằng khoá API của riêng bạn để yêu cầu hoạt động trong ứng dụng của bạn.

Phản hồi Place Details (Phiên bản cũ)

Phản hồi Place Details (Phiên bản cũ) được trả về theo định dạng do cờ output chỉ ra trong đường dẫn URL của yêu cầu.

JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "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",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          {
            "height": 3036,
            "html_attributions":
              [
                "Anna Linetsky",
              ],
            "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1",
            "width": 4048,
          },
          {
            "height": 4016,
            "html_attributions":
              [
                "Jonah Dell",
              ],
            "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD",
            "width": 6016,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Anthony Huynh",
              ],
            "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jasen Baker",
              ],
            "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk",
            "width": 4032,
          },
          {
            "height": 1515,
            "html_attributions":
              [
                "Andrew W",
              ],
            "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI",
            "width": 2048,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39",
            "width": 4032,
          },
          {
            "height": 4032,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas",
            "width": 3024,
          },
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          {
            "author_name": "Jordy Baker",
            "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The staff is very friendly.",
            "time": 1641389490,
          },
          {
            "author_name": "Prem Rathod",
            "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The location is convenient and easy to find.",
            "time": 1640159655,
          },
          {
            "author_name": "Husuni Hamza",
            "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo",
            "rating": 5,
            "relative_time_description": "7 months ago",
            "text": "A modern and impressive facility.",
            "time": 1633197305,
          },
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}
    

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Rd</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
    <lat>-33.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <review>
   <time>1641389490</time>
   <text>The staff is very friendly.</text>
   <author_name>Jordy Baker</author_name>
   <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1640159655</time>
   <text>The location is convenient and easy to find.</text>
   <author_name>Prem Rathod</author_name>
   <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1633197305</time>
   <text>A modern and impressive facility.</text>
   <author_name>Husuni Hamza</author_name>
   <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url>
   <rating>5.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>7 months ago</relative_time_description>
  </review>
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM  5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM  5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM  5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM  5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM  5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference>
   <width>4048</width>
   <height>3036</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104829437842034782235&quot;&gt;Anna Linetsky&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference>
   <width>6016</width>
   <height>4016</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/107755640736541028674&quot;&gt;Jonah Dell&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115886271727815775491&quot;&gt;Anthony Huynh&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102939237947063969663&quot;&gt;Jasen Baker&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference>
   <width>2048</width>
   <height>1515</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112343109286948028063&quot;&gt;Andrew W&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</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>
</PlaceDetailsResponse>

    

Mỗi phản hồi JSON và XML đều chứa các phần tử sau:

PlacesDetailsResponse

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 Địa điểm

Chứa thông tin chi tiết về địa điểm được yêu cầu.

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

bắt buộc PlacesDetailsStatus

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 PlacesDetailsStatus để biết thêm thông tin.

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.

Trong phản hồi JSON, các phần tử này được biểu thị dưới dạng các phần tử gốc. Trong phản hồi XML, các phần tử này xuất hiện dưới dạng phần tử cấp cao nhất bên dưới <PlaceDetailsResponse>.

PlacesDetailsStatus

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 vị trí được tham chiếu place_id là hợp lệ nhưng không còn tham chiếu đến một kết quả hợp lệ. Điều này có thể xảy ra nếu cơ sở không còn hoạt động kinh doanh.
  • NOT_FOUND cho biết vị trí được tham chiếu, place_id, không có trong cơ sở dữ liệu Địa điểm.
  • INVALID_REQUEST cho biết yêu cầu API không đúng định dạng.
  • 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

Cho biết liệu 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 Geometry

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

Vui lòng xem Geometry để 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 tên). Xem Open Location Codeplus code.

Vui lòng 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

Cho biết liệu 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ả.

Nội dung này được dùng để đọc nguyên trạng. Đừng phân tích cú pháp địa chỉ được đị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.

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_hourssecondary_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 bằng API Place Photo 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ó).

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ể chứa mã đánh dấu chế độ HTML cơ bả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á.