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 yêu cầu Place Details (Cũ). Yêu cầu Chi tiết địa điểm (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 và bài đánh giá của người dùng.

Yêu cầu về Chi tiết địa điểm (Phiên bản cũ)

Yêu cầu Place Details (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 các giá trị sau:

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

Bạn cần có một số tham số nhất định để bắt đầu một yêu cầu tìm kiếm. Theo tiêu chuẩn trong URL, tất cả tham số đều được phân tách bằng ký tự dấu và (&). Các phần sau đây liệt kê các tham số và giá trị có thể có của chúng.

Tham số bắt buộc

Thông số tùy chọn

  • fields

    Lưu ý: Yêu cầu Tìm kiếm địa điểm (Cũ) và yêu cầu Place Details (Cũ) không trả về cùng một trường. Yêu cầu Tìm kiếm địa điểm (Cũ) trả về một nhóm nhỏ các trường được trả về theo yêu cầu Chi tiết địa điểm (Cũ). Nếu trường bạn muốn không được trả về bằng tính năng Tìm địa điểm (Cũ), thì bạn có thể dùng tính năng Tìm địa điểm (Cũ) để lấy place_id, sau đó dùng Mã địa điểm đó để gửi yêu cầu Chi tiết địa điểm (Cũ). Để biết thêm thông tin về các trường không có sẵn trong yêu cầu Tìm kiếm địa điểm (Cũ), hãy xem phần Trường dữ liệu địa điểm (Cũ).

    Sử dụng tham số fields để chỉ định danh sách các loại dữ liệu địa điểm được phân tách bằng dấu phẩy 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 giá trị phức hợp. Ví dụ: opening_hours/open_now.

    Các trường được chia thành ba danh mục thanh toán: Cơ bản, Thông tin liên hệ và Bầu không khí. 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 đó. Để 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

    Không gian

    Danh mục Bầu không khí 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 ý: Thông tin ghi nhận tác giả, html_attributions, luôn được trả về trong mỗi lệnh gọi, bất kể trường này có được yêu cầu hay không.
  • language

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

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

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

  • 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á. Bài đánh giá được trả về bằng ngôn ngữ gốc.

    Nếu bạn bỏ qua hoặc không truyền 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 cho bả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 sử dụng khi trả về 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 độ liên quan; dịch vụ sẽ ưu tiên kết quả trả về là 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 khuyên 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 giúp 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 cụm từ tìm kiếm và kết thúc khi họ chọn một địa điểm và lệnh gọi đến Place Details (Cũ) được thực hiện. Mỗi phiên có thể có nhiều cụm từ tìm kiếm, theo sau là một lựa chọn địa điểm. (Các) khoá API dùng cho mỗi yêu cầu trong một phiên phải thuộc cùng một dự á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ệ; ứ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ã phiên, thì phiên đó sẽ được tính phí như thể không có mã phiên nào được cung cấp (mỗi yêu cầu được tính phí riêng).

    Bạn nên làm theo 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ã 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 dùng cho tất cả yêu cầu về Place Autocomplete và Place Details trong một phiên đều 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 riêng biệt cho mỗi phiên mới. Nếu bạn sử dụng cùng một mã thông báo cho nhiều phiên, thì mỗi yêu cầu sẽ được tính phí riêng.

Ví dụ về Place Details (Phiên bản 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, rating và formatted_phone_number:

Shell

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

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 của Place Details (Phiên bản cũ)

Phản hồi của Place Details (Phiên bản cũ) được trả về theo định dạng được chỉ định bằng cờ output 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,
          },
          // ...
        ],
      "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,
          },
          // ...
        ],
      "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>
  <!-- ... -->
  <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>
  <!-- ... -->
  <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 tập hợp các thuộc tính về trang thông tin này mà bạn phải hiển thị cho người dùng (một số trang thông tin có thể không có thuộc tính).

bắt buộc Địa điểm

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

Hãy xem Đị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 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ề thông số kỹ thuật của yêu cầu, có thể có thêm trường info_messages trong đối tượng phản hồi. Trường này chỉ được trả về cho các yêu cầu thành công. Trường này có thể không phải lúc nào cũng được trả về và nội dung của trường này có thể thay đổi.

Trong phản hồi JSON, các phần tử này được biểu thị dưới dạng phần tử gốc. Trong phản hồi XML, các trường này xuất hiện dưới dạng các 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 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 nữa.
  • NOT_FOUND cho biết rằng không tìm thấy vị trí được tham chiếu, place_id, 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ỳ điều nào sau đây:
    • Bạn đã vượt quá giới hạn QPS.
    • Bạn chưa bật tính năng thanh toán trên tài khoản của mình.
    • Bạn đã vượt quá khoản tín dụng 200 USD hằng tháng hoặc hạn mức sử dụng do bạn tự đặt ra.
    • Phương thức thanh toán được cung cấp không còn hợp lệ (ví dụ: thẻ tín dụng đã hết hạn).
    Hãy xem phần Câu hỏi thường gặp về Maps để biết thêm thông tin về cách giải quyết lỗi này.
  • REQUEST_DENIED cho biết yêu cầu của bạn đã bị từ chối, thường là do:
    • Yêu cầu thiếu khoá API.
    • Tham số key không hợp lệ.
  • UNKNOWN_ERROR cho biết lỗi không xác định.

Địa điểm

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

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

Địa chỉ của địa điểm được trình bày theo đị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 doanh nghiệp có hỗ trợ dịch vụ nhận hàng ở lề đường hay không.

tùy chọn PlaceOpeningHours

Chứa giờ hoạt động trong 7 ngày tiếp theo (bao gồm cả hôm nay). Khoảng thời gian này bắt đầu vào lúc nửa đêm của ngày yêu cầu và kết thúc vào lúc 23:59 sáu ngày sau đó. Trường này bao gồm trường phụ 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

Chỉ định xem doanh nghiệp có hỗ trợ dịch vụ giao hàng hay không.

tùy chọn boolean

Chỉ định xem doanh nghiệp có hỗ trợ các lựa chọn chỗ ngồi trong nhà hoặc 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 các thông tin này (nếu có). Văn bản tóm tắt phải được trình bày 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 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 chính. 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 tế 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ỉ theo logic. 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ỳ).

Đừ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 của 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 nhìn 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 biểu tượng được đề xuất có thể hiển thị cho người dùng khi cho biết 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 biểu tượng được đề xuất, trừ đi phần đ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ó tiền tố là dấu cộng (+). 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 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 doanh nghiệp.

tùy chọn Array<PlacePhoto>

Một mảng các đối tượng ảnh, mỗi đối tượng chứa một tệp đối chiếu đến một hình ảnh. Một yêu cầu có thể trả về tối đa 10 ả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 về Ảnh địa điểm.

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 giúp xác định duy nhất một địa điểm. Để 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 API Địa điểm. Để biết thêm thông tin về mã địa điểm, hãy xem phần tổng quan về mã địa điểm.

tùy chọn PlusCode

Mã tham chiếu vị trí được mã hoá, bắt nguồn từ toạ độ vĩ độ và kinh độ, đại diện cho một khu vực: 1/8000 độ x 1/8000 độ (khoảng 14 m x 14 m tại đường xích đạo) hoặc nhỏ hơn. Plus Codes có thể được dùng để thay thế cho đị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 Mã cộng và mã cộng.

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. 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 chứa tối đa 5 bài đánh giá. Theo mặc định, các bài đánh giá được sắp xếp theo thứ tự 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 độ liên quan; dịch vụ sẽ ưu tiên kết quả trả về các bài đánh giá ban đầu đượ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 khuyên bạn nên cho người dùng biết kết quả được sắp xếp theo most_relevant hay newest.

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 nhập cho bảy ngày tiếp theo, bao gồm cả thông tin về giờ 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ờ mua hàng ngay trên xe hoặc giờ giao hàng là giờ phụ. Trường này điền sẵn trường phụ type, lấy từ danh sách các loại giờ mở cửa được xác định trước (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 phụ 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 này có phục vụ bia hay không.

tùy chọn boolean

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

tùy chọn boolean

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

tùy chọn boolean

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

tùy chọn boolean

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

tùy chọn boolean

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

tùy chọn boolean

Cho biết địa điểm này 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 đối tượng mô tả kết quả đã cho. 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 trên Google cho địa điểm này. Đây sẽ là trang do Google sở hữu, chứa thông tin chính xác nhất hiện có về địa điểm đó. Ứ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 chênh lệch so với giờ UTC. Ví dụ: đối với các địa điểm ở 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 các địa điểm ở 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

Đối với kết quả về cơ sở (types:["establishment", ...])), trường vicinity chứa địa chỉ đơn giản của địa điểm, bao gồm tên đường, số đường và địa phương, 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 chính trị (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 phương thức 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 một doanh nghiệp.

tùy chọn boolean

Chỉ định xem đị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ũng bao gồm mã ngôn ngữ cho các thông tin này (nếu có). Văn bản tóm tắt phải được trình bày 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 có.

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

Đố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ó mở cửa vào 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ờ 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 chuỗi mô tả giờ hoạt động của địa điểm bằng văn bản mà con người có thể đọc được.

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 địa điểm đóng cửa. Nếu một địa điểm luôn mở cửa, thì phần đóng cửa sẽ bị thiếu 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ị dưới dạng một khoảng thời gian mở cửa có ngày mang giá trị 0 và thời gian mang 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 theo 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 true, thì tức 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 phụ 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ờ và giờ đượ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 nghĩa là thứ Ba.

bắt buộc chuỗi

Có thể chứa thời gian trong ngày theo định dạng 24 giờ hhmm. Giá trị nằm trong khoảng từ 0000 đến 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 theo múi giờ địa phương của địa điểm, ví dụ: 2010-12-31.

tùy chọn boolean

Đúng nếu một khoảng thời gian nhất định bị cắt bớt do thời hạn 7 ngày, trong đó khoảng thời gian bắt đầu trước nửa đêm vào ngày yêu cầu và/hoặc kết thúc vào hoặc sau nửa đêm của 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ửa có thể kéo dài quá giớ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 Ảnh địa điểm thông qua 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 ảnh.

bắt buộc Array<string>

Thông tin ghi công thuộc tính 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 Ảnh.

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 gán cho "Một người dùng Google".

bắt buộc số

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

bắt buộc chuỗi

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

bắt buộc số

Thời gian gửi bài đánh giá, được đo 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" hay "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ó nội dung đá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" hay "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ó nội dung đá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 Địa điểm, 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 cơ bản. Ví dụ: tham chiếu thực thể &amp; có thể đại diện cho ký tự dấu 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 hay không.Nếu bài đánh giá đã được dịch (tương ứng với giá trị true), 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 sau, "Do Google dịch", vào bài đánh giá.