Trang này được dịch bởi Cloud Translation API.

Chi tiết địa điểm (Mới)

Chọn nền tảng: Android iOS JavaScript Dịch vụ web

Sau khi có 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 điểm yêu thích cụ thể bằng cách bắt đầu yêu cầu Thông tin chi tiết về địa điểm (Mới). Yêu cầu Chi tiết địa điểm (Mới) sẽ 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.

Có nhiều cách để lấy mã địa điểm. Bạn có thể sử dụng:

Trình khám phá API cho phép bạn tạo các yêu cầu trực tiếp để làm quen với API và các tuỳ chọn API:

Hãy làm thử!

Yêu cầu về Thông tin chi tiết về địa điểm (Mới)

Yêu cầu Thông tin chi tiết về địa điểm là một yêu cầu HTTP GET ở dạng:

https://places.googleapis.com/v1/places/PLACE_ID

Truyền tất cả tham số dưới dạng tham số URL hoặc trong tiêu đề dưới dạng một phần của yêu cầu GET. Ví dụ:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

Hoặc trong lệnh cURL:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Phản hồi về thông tin chi tiết về địa điểm (Mới)

Thông tin chi tiết về địa điểm (Mới) trả về một đối tượng JSON dưới dạng phản hồi. Trong phản hồi:

Phản hồi được biểu thị bằng đối tượng Place. Đối tượng Place chứa thông tin chi tiết về địa điểm.
FieldMask được truyền trong yêu cầu chỉ định danh sách các trường được trả về trong đối tượng Place.

Đối tượng JSON hoàn chỉnh có dạng:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

Thông số bắt buộc

FieldMask

Chỉ định danh sách các trường sẽ trả về trong phản hồi bằng cách tạo một mặt nạ trường phản hồi. Truyền mặt nạ trường phản hồi đến phương thức bằng cách sử dụng tham số URL $fields hoặc fields hoặc bằng cách sử dụng tiêu đề HTTP X-Goog-FieldMask. Không có danh sách mặc định về các trường được trả về trong phản hồi. Nếu bạn bỏ qua mặt nạ trường, phương thức này sẽ trả về lỗi.

Việc che trường là một phương pháp thiết kế hay để đảm bảo rằng bạn không yêu cầu dữ liệu không cần thiết, giúp tránh thời gian xử lý và các khoản phí không cần thiết.

Chỉ định danh sách 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ụ: để truy xuất tên hiển thị và địa chỉ của địa điểm.
```
X-Goog-FieldMask: displayName,formattedAddress
```
Lưu ý: Không được dùng dấu cách ở bất kỳ vị trí nào trong danh sách trường.

Sử dụng * để truy xuất tất cả các trường.
```
X-Goog-FieldMask: *
```
Ký tự đại diện "*" sẽ chọn tất cả các trường. Tuy nhiên, mặc dù bạn có thể sử dụng ký tự đại diện đó trong quá trình phát triển, nhưng Google không khuyến khích sử dụng mặt nạ trường phản hồi ký tự đại diện (*) trong môi trường sản xuất do lượng lớn dữ liệu có thể được trả về.

Bạn có thể xem thêm hướng dẫn về cách sử dụng iconMaskBaseUri và iconBackgroundColor trong phần Biểu tượng địa điểm.

Chỉ định một hoặc nhiều trường sau:
- Các trường sau đây kích hoạt SKU Thông tin chi tiết về địa điểm (chỉ mã nhận dạng):
  
  attributions, id, name^*, photos
  
  ^* Trường name chứa tên tài nguyên ở dạng: places/PLACE_ID. Sử dụng displayName để truy cập tên văn bản của địa điểm.
- Các trường sau đây sẽ kích hoạt SKU Thông tin chi tiết về địa điểm (chỉ vị trí):
  
  addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport
- Các trường sau đây sẽ kích hoạt SKU Chi tiết địa điểm (Cơ bản):
  
  accessibilityOptions, businessStatus, containingPlaces, displayName, googleMapsLinks^*, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, pureServiceAreaBusiness, subDestinations, utcOffsetMinutes
  
  ^* Trường googleMapsLinks đang ở giai đoạn Bản dùng thử trước khi phát hành rộng rãi và không tính phí, tức là khoản thanh toán là 0 USD đối với việc sử dụng trong giai đoạn Bản dùng thử.
- Các trường sau đây sẽ kích hoạt SKU Chi tiết địa điểm (Nâng cao):
  
  currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, priceRange, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri
- Các trường sau đây sẽ kích hoạt SKU Chi tiết địa điểm (Ưu tiên):
  
  allowsDogscurbsidePickupdeliverydineIneditorialSummaryevChargeOptionsfuelOptionsgoodForChildrengoodForGroupsgoodForWatchingSportsliveMusicmenuForChildrenparkingOptionspaymentOptionsoutdoorSeatingreservablerestroomreviewsroutingSummariesservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertservesDinnerservesLunchservesVegetarianFoodservesWinetakeout
placeId

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, được trả về từ tính năng Tìm kiếm bằng văn bản (Mới) hoặc Tìm kiếm lân cận (Mới). Để biết thêm thông tin về mã địa điểm, hãy xem bài viết tổng quan về mã địa điểm.

Chuỗi places/PLACE_ID còn được gọi là tên tài nguyên của vị trí. Trong phản hồi từ yêu cầu Thông tin chi tiết về địa điểm (Mới), Tìm kiếm lân cận (Mới) và Tìm kiếm bằng văn bản (Mới), chuỗi này nằm trong trường name của phản hồi. Mã địa điểm độc lập nằm trong trường id của phản hồi.

Lưu ý: Trong Chi tiết địa điểm hiện có, trường name của phản hồi chứa tên địa điểm mà con người có thể đọc được. Trong API mới, trường đó hiện có tên là displayName.

Thông số tùy chọn

languageCode

Ngôn ngữ dù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 languageCode, API sẽ mặc định là en. Nếu bạn chỉ định một mã ngôn ngữ không hợp lệ, API sẽ trả về lỗi INVALID_ARGUMENT.
- API này cố gắng 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 trả về địa chỉ đường phố bằng ngôn ngữ địa phương, được chuyển tự sang một tập lệnh 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 sẽ đượ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 nào bằng ngôn ngữ ưu tiên, API sẽ sử dụng tên 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ề các kết quả đó. Bộ mã hoá địa lý diễn giải các chữ 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 loại đường phố, hoặc từ đồng nghĩa có thể hợp lệ ở một ngôn ngữ nhưng lại không hợp lệ ở ngôn ngữ khác.
regionCode

Mã khu vực dùng để định dạng phản hồi, được chỉ định dưới dạng giá trị mã CLDR gồm hai ký tự. Không có giá trị mặc định.

Nếu tên quốc gia của trường formattedAddress trong phản hồi khớp với regionCode, thì mã quốc gia sẽ bị bỏ qua khỏi formattedAddress. Thông số này không ảnh hưởng đến adrFormatAddress (luôn bao gồm tên quốc gia) hoặc shortFormattedAddress (không bao giờ bao gồm tên quốc gia).

Hầu hết mã CLDR giống hệt 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 là "gb" (về mặt kỹ thuật là cho thực thể "Vương quốc Anh và Bắc Ireland"). Thông số này có thể ảnh hưởng đến kết quả dựa trên luật hiện hành.
sessionToken

Mã thông báo phiên là các chuỗi do người dùng tạo, theo dõi các lệnh gọi Tự động hoàn thành (Mới) dưới dạng "phiên". Tính năng Tự động hoàn thành (Mới) sử dụng mã thông báo phiên để nhóm các giai đoạn truy vấn và lựa chọn địa điểm trong lượt tìm kiếm tự động hoàn thành của người dùng thành một phiên riêng biệt nhằm mục đích thanh toán. Mã thông báo phiên được truyền vào các lệnh gọi Thông tin chi tiết về địa điểm (Mới) theo sau các lệnh gọi Tự động hoàn thành (Mới). Để biết thêm thông tin, hãy xem phần Mã thông báo phiên.

Ví dụ về Chi tiết địa điểm

Ví dụ sau đây yêu cầu placeId cung cấp thông tin chi tiết về một địa điểm:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Xin lưu ý rằng tiêu đề X-Goog-FieldMask chỉ định rằng phản hồi chứa các trường dữ liệu sau: id,displayName. Sau đó, phản hồi sẽ có dạng:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Thêm các loại dữ liệu khác vào mặt nạ trường để trả về thông tin bổ sung. Ví dụ: thêm formattedAddress,plusCode để đưa địa chỉ và Plus Code vào phản hồi:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Phản hồi hiện có dạng:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Hãy dùng thử!

Trình khám phá API cho phép bạn tạo các yêu cầu mẫu để bạn có thể làm quen với API và các tuỳ chọn API.

Cách gửi yêu cầu:

Chọn biểu tượng API, , ở bên phải trang.
Bạn có thể đặt tham số name thành:
```
places/PLACE_ID
```
Bạn có thể mở rộng phần Hiện các tham số chuẩn và đặt tham số fields thành mặt nạ trường.
Chọn nút Thực thi. Trong cửa sổ bật lên, hãy chọn tài khoản mà bạn muốn sử dụng để gửi yêu cầu.
Trong bảng điều khiển API Explorer (Trình khám phá API), hãy chọn biểu tượng mở rộng, , để mở rộng cửa sổ API Explorer.

Chi tiết địa điểm (Mới)

Yêu cầu về Thông tin chi tiết về địa điểm (Mới)

Phản hồi về thông tin chi tiết về địa điểm (Mới)

Thông số bắt buộc

FieldMask

placeId

Thông số tùy chọn

languageCode

regionCode

sessionToken

Ví dụ về Chi tiết địa điểm

Hãy dùng thử!