Sản phẩm hoặc tính năng này đang ở trạng thái Cũ. Để biết thêm thông tin về trạng thái Cũ, hãy xem bài viết Các sản phẩm và tính năng cũ. Để di chuyển sang Places API (Mới), hãy xem Hướng dẫn di chuyển.

Tìm địa điểm (Cũ)

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

Lưu ý: Thư viện phía máy chủ và phía máy khách

Places API cũng có trong Ứng dụng Java, Ứng dụng Python, Ứng dụng Go và Ứng dụng Node.js cho Dịch vụ Google Maps. Places API và các thư viện ứng dụng dùng cho các ứng dụng máy chủ.

Nếu bạn đang tạo một ứng dụng phía máy khách, hãy xem Places SDK for Android (Mới), Places SDK for iOS (Mới) và Thư viện Địa điểm, Maps JavaScript API.

Yêu cầu Tìm địa điểm (Phiên bản cũ) sẽ nhận một văn bản đầu vào và trả về một địa điểm. Đầu vào có thể là bất kỳ loại dữ liệu văn bản nào về Địa điểm, chẳng hạn như tên, địa chỉ hoặc số điện thoại. Yêu cầu phải là một chuỗi. Yêu cầu Tìm địa điểm (Phiên bản cũ) bằng dữ liệu không phải chuỗi, chẳng hạn như toạ độ vĩ độ/kinh độ hoặc mã cộng sẽ tạo ra lỗi.

Yêu cầu Tìm địa điểm (phiên bản cũ) trả về một tập hợp con của các trường do yêu cầu Chi tiết về địa điểm (phiên bản cũ) trả về. Để biết thêm thông tin về những trường không có trong yêu cầu Tìm địa điểm (Phiên bản cũ), hãy xem phần Hỗ trợ các trường Places API. Nếu không nhận được trường bạn muốn, bạn có thể dùng tính năng Tìm địa điểm (cũ) để nhận place_id, sau đó dùng mã nhận dạng đó để đưa ra yêu cầu Chi tiết về địa điểm (cũ).

Yêu cầu Tìm địa điểm (Cũ)

Yêu cầu Tìm địa điểm (Cũ) là một URL loại HTTP có dạng như sau:

https://maps.googleapis.com/maps/api/place/findplacefromtext/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 địa điểm (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

input

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ệ. Places API 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ả theo mức độ liên quan mà người dùng cảm nhận được.
inputtype

Loại dữ liệu đầu vào. Đây có thể là một trong hai cờ textquery hoặc phonenumber. Số điện thoại phải ở định dạng quốc tế (bắt đầu bằng dấu cộng ("+"), theo sau là mã quốc gia, sau đó là số điện thoại). Hãy xem Đề xuất E.164 của ITU để biết thêm thông tin.

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 Mã đị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ệ và Môi trường. Các trường cơ bản được tính phí theo mức cơ bản, còn các trường Người liên hệ và Bầu không khí được tính phí theo mức giá cao hơn. 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 Tìm kiếm văn bả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 ý: Thông tin ghi công (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ụ: utca và tér là từ đồng nghĩa với đường phố trong tiếng Hungary.
locationbias

Ưu tiên kết quả ở một khu vực cụ thể bằng cách chỉ định bán kính cộng với vĩ độ/kinh độ hoặc hai cặp vĩ độ/kinh độ đại diện cho các điểm của một hình chữ nhật. Nếu bạn không chỉ định tham số này, API sẽ sử dụng tính năng thiên vị địa chỉ IP theo mặc định.
- Thiên vị theo IP: Hướng dẫn API sử dụng tính năng thiên vị theo địa chỉ IP. Truyền chuỗi ipbias (lựa chọn này không có tham số bổ sung).
- Hình tròn: Một chuỗi chỉ định bán kính theo mét, cộng với vĩ độ/kinh độ theo độ thập phân. Hãy dùng định dạng sau: circle:radius@lat,lng.
- Hình chữ nhật: Một chuỗi chỉ định 2 cặp vĩ độ/kinh độ theo độ thập phân, biểu thị các điểm phía nam/tây và phía bắc/đông của một hình chữ nhật. Sử dụng định dạng sau:rectangle:south,west|north,east. Lưu ý rằng các giá trị đông/tây được gói trong phạm vi -180, 180 và các giá trị bắc/nam được giới hạn trong phạm vi -90, 90.

Lưu ý: Nếu bạn bỏ qua tham số fields trong yêu cầu Tìm địa điểm (Cũ), thì chỉ place_id cho kết quả sẽ được trả về.

Ví dụ về tính năng Tìm địa điểm (cũ)

Ví dụ sau đây cho thấy một yêu cầu Tìm địa điểm (Cũ) cho "Bảo tàng Nghệ thuật Đương đại Úc", bao gồm các trường photos, formatted_address, name, rating, opening_hours và geometry:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

Ví dụ sau đây cho thấy một yêu cầu Tìm địa điểm (Phiên bản cũ) cho "Mongolian Grill", sử dụng tham số locationbias để ưu tiên kết quả trong phạm vi 2.000 mét tính từ toạ độ đã chỉ định:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

Ví dụ sau đây cho thấy một yêu cầu Tìm địa điểm (Phiên bản cũ) cho một số điện thoại. Xin lưu ý rằng tiền tố gọi quốc tế "+" đã được mã hoá thành %2B để yêu cầu này là một URL tuân thủ. Nếu không được mã hoá, tiền tố + sẽ được giải mã thành một khoảng trắng trên máy chủ, dẫn đến việc tra cứu số điện thoại không hợp lệ.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Phản hồi của tính năng Tìm địa điểm (Cũ)

Phản hồi của tính năng Tìm địa điểm (phiên bản cũ) chỉ chứa các kiểu dữ liệu được chỉ định bằng tham số fields, cộng với html_attributions. Ví dụ sau đây cho thấy phản hồi cho một yêu cầu Tìm địa điểm (Phiên bản cũ) đối với "Museum of Contemporary Art Australia", bao gồm các trường formatted_address, geometry, name, opening_hours, photos, rating.

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

PlacesFindPlaceFromTextResponse

Trường	Bắt buộc	Loại	Mô tả
`candidates`	bắt buộc	Array<Place>	Chứa một mảng các Địa điểm đề xuất. 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 Tìm kiếm địa điểm trả về, bạn có thể dùng Tìm kiếm địa điểm để lấy một Mã địa điểm, sau đó dùng Mã địa điểm đó để đưa ra yêu cầu Place Details. Hãy xem phần Địa điểm để biết thêm thông tin.
`status`	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.
`error_message`	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.
`info_messages`	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.

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ả
`address_components`	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.
`adr_address`	tùy chọn	chuỗi	Thông tin về địa chỉ của địa điểm trong định dạng vi mô adr.
`business_status`	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`
`curbside_pickup`	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.
`current_opening_hours`	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.
`delivery`	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.
`dine_in`	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.
`editorial_summary`	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.
`formatted_address`	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.
`formatted_phone_number`	tùy chọn	chuỗi	Chứa số điện thoại của địa điểm ở định dạng địa phương.
`geometry`	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.
`icon`	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 đồ.
`icon_background_color`	tùy chọn	chuỗi	Chứa mã màu HEX mặc định cho danh mục của địa điểm.
`icon_mask_base_uri`	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`.
`international_phone_number`	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`.
`name`	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á.
`opening_hours`	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.
`permanently_closed`	tùy chọn	boolean	`permanently_closed` không được dùng nữa. Sử dụng `business_status` để biết trạng thái hoạt động của các doanh nghiệp.
`photos`	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.
`place_id`	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.
`plus_code`	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 Code và plus code. Vui lòng xem `PlusCode` để biết thêm thông tin.
`price_level`	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
`rating`	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.
`reference`	tùy chọn	chuỗi	`reference` không được dùng nữa.
`reservable`	tùy chọn	boolean	Chỉ định xem địa điểm có hỗ trợ đặt chỗ hay không.
`reviews`	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.
`scope`	tùy chọn	chuỗi	`scope` không được dùng nữa.
`secondary_opening_hours`	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.
`serves_beer`	tùy chọn	boolean	Cho biết địa điểm có phục vụ bia hay không.
`serves_breakfast`	tùy chọn	boolean	Cho biết địa điểm có phục vụ bữa sáng hay không.
`serves_brunch`	tùy chọn	boolean	Cho biết địa điểm có phục vụ bữa sáng muộn hay không.
`serves_dinner`	tùy chọn	boolean	Cho biết địa điểm có phục vụ bữa tối hay không.
`serves_lunch`	tùy chọn	boolean	Cho biết địa điểm có phục vụ bữa trưa hay không.
`serves_vegetarian_food`	tùy chọn	boolean	Cho biết địa điểm có phục vụ đồ ăn chay hay không.
`serves_wine`	tùy chọn	boolean	Cho biết địa điểm có phục vụ rượu vang hay không.
`takeout`	tùy chọn	boolean	Chỉ định xem doanh nghiệp có hỗ trợ dịch vụ mang đi hay không.
`types`	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ợ.
`url`	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.
`user_ratings_total`	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.
`utc_offset`	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).
`vicinity`	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.
`website`	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.
`wheelchair_accessible_entrance`	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ả
`language`	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.
`overview`	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ả
`open_now`	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.
`periods`	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.
`special_days`	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.
`type`	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ả
`open`	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.
`close`	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ả
`date`	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.
`exceptional_hours`	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ả
`day`	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.
`time`	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.
`date`	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.
`truncated`	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ả
`height`	bắt buộc	số	Chiều cao của bức ảnh.
`html_attributions`	bắt buộc	Array<string>	Thông tin ghi công HTML cho ảnh.
`photo_reference`	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.
`width`	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ả
`author_name`	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".
`rating`	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.
`relative_time_description`	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.
`time`	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.
`author_url`	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ó).
`language`	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á.
`original_language`	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á.
`profile_photo_url`	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ể chứa mã đánh dấu chế độ HTML cơ bản. Ví dụ: tham chiếu thực thể `&` có thể biểu thị một ký tự và.
`translated`	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á.

Tìm địa điểm (Cũ) Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Yêu cầu Tìm địa điểm (Cũ)

Thông số bắt buộc

input

inputtype

Thông số tùy chọn

fields

language

locationbias

Ví dụ về tính năng Tìm địa điểm (cũ)

curl

HTTP

curl

HTTP

curl

HTTP

Phản hồi của tính năng Tìm địa điểm (Cũ)

JSON

XML

PlacesFindPlaceFromTextResponse

candidates

status

error_message

info_messages

PlacesSearchStatus

Địa điểm

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

Tìm địa điểm (Cũ)

`candidates`

`status`

`error_message`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`