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

Giới thiệu

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 địa điểm yêu thích cụ thể bằng cách bắt đầu yêu cầu Chi tiết địa điểm (Mới). Yêu cầu Place Details (Mới) 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á.

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

• Tìm kiếm văn bản (Mới) hoặc Nearby Search (Mới)
• Geocoding API
• Routes API
• Address Validation API
• Tự động hoàn thành (Mới)

APIs Explorer cho phép bạn đưa ra các yêu cầu trực tiếp để có thể làm quen với API và các tuỳ chọn API:

Yêu cầu về Chi tiết địa điểm (Mới)

Yêu cầu Place Details (Mới) là một yêu cầu GET HTTP có 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

Câu trả lời của Place Details (Mới)

Place Details (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"
  }
  ...
}

Tham số bắt buộc

• FieldMask

  Chỉ định danh sách các trường cần 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.

  Mặt nạ 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à phí thanh toán không cần thiết.

  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 để 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

  Sử dụng * để truy xuất tất cả các trường.

  X-Goog-FieldMask: *

  Chỉ định một hoặc nhiều trường sau:

  • Các trường sau đây kích hoạt SKU chỉ mã nhận dạng Place Details Essentials:

    attributions
consumerAlert
id
movedPlace
movedPlaceId
name^*
    photos
    

    ^* Trường name chứa tên tài nguyên của địa điểm ở dạng: places/PLACE_ID. Để lấy tên văn bản của địa điểm, hãy yêu cầu trường displayName trong SKU Pro.

    Để xem danh sách đầy đủ các trường và SKU liên quan, hãy xem phần Trường dữ liệu địa điểm (Mới).

  • Các trường sau đây kích hoạt SKU Place Details Essentials:

    addressComponents
addressDescriptor^*
    adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport
    
    ^* Thông tin mô tả địa chỉ được cung cấp rộng rãi cho khách hàng ở Ấn Độ và đang trong giai đoạn thử nghiệm ở những nơi khác.
    
    

    Để xem danh sách đầy đủ các trường và SKU liên quan, hãy xem phần Trường dữ liệu địa điểm (Mới).

  • Các trường sau đây kích hoạt SKU Place Details Pro:

    accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks
googleMapsTypeLabel
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
openingDate
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
timeZone
utcOffsetMinutes
    
    

    Để xem danh sách đầy đủ các trường và SKU liên quan, hãy xem phần Trường dữ liệu địa điểm (Mới).

  • Các trường sau đây kích hoạt SKU Chi tiết địa điểm dành cho doanh nghiệp:

    currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
transitStation
userRatingCount
websiteUri

    Để xem danh sách đầy đủ các trường và SKU liên quan, hãy xem phần Trường dữ liệu địa điểm (Mới).

  • Các trường sau đây sẽ kích hoạt SKU Place Details Enterprise + Atmosphere:

    allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeAmenitySummary
evChargeOptions
fuelOptions
generativeSummary
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
neighborhoodSummary
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
reviewSummary
routingSummaries^*
    servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
    
    ^* Chỉ tìm kiếm văn bản và Nearby Search

    Để xem danh sách đầy đủ các trường và SKU liên quan, hãy xem phần Trường dữ liệu địa điểm (Mới).

• 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ìm kiếm văn bản (Mới) hoặc Nearby Search (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ũng được gọi là tên tài nguyên của địa điểm. Trong phản hồi từ yêu cầu Chi tiết đị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.

Thông số tùy chọn

• languageCode

  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 languageCode, API sẽ mặc định là en. Nếu bạn chỉ định mã ngôn ngữ không hợp lệ, API sẽ trả về lỗi INVALID_ARGUMENT.
  • 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ệ 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 tập hợp 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 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.

• 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. Tham 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 các mã CLDR đề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ể "Vương quốc Liên hiệp Anh và Bắc Ireland"). Tham 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 lựa chọn địa điểm và cụm từ tìm kiếm của một lượt tìm kiếm tự động hoàn thành của người dùng vào một phiên riêng biệt cho mục đích thanh toán. Mã phiên được truyền vào các lệnh gọi Chi tiết đị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ề Place Details (Mới)

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

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. Khi đó, 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"
  }
}

Xem điểm xếp hạng, số lượng bài đánh giá và bài đánh giá

Để truy xuất điểm xếp hạng trung bình theo sao, tổng số lượt xếp hạng (tổng số bài đánh giá) hoặc văn bản bài đánh giá của khách hàng về một doanh nghiệp, hãy thêm các trường tương ứng vào tiêu đề X-Goog-FieldMask:

• rating và userRatingCount: Trả về điểm xếp hạng trung bình của địa điểm (từ 1.0 đến 5.0) và tổng số bài đánh giá. Việc yêu cầu các trường này sẽ kích hoạt SKU Chi tiết địa điểm dành cho doanh nghiệp.
• reviews và reviewSummary: Trả về tối đa 5 đối tượng Review do người dùng gửi và một bản tóm tắt bài đánh giá do AI tạo. Việc yêu cầu các trường này sẽ kích hoạt SKU Place Details Enterprise + Atmosphere.

Nếu ứng dụng của bạn chỉ cần điểm xếp hạng theo sao và tổng số bài đánh giá, hãy yêu cầu rating và userRatingCount mà không cần reviews để yêu cầu vẫn nằm trong cấp SKU Chi tiết địa điểm dành cho doanh nghiệp:

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

Để truy xuất tối đa 5 đối tượng Review do người dùng gửi, hãy thêm reviews vào mặt nạ trường (được tính phí theo cấp SKU Place Details Enterprise + Atmosphere):

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

Phản hồi bao gồm điểm xếp hạng, tổng số lượt xếp hạng và mảng reviews:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  },
  "rating": 4.2,
  "userRatingCount": 2594,
  "reviews": [
    {
      "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/...",
      "relativePublishTimeDescription": "a month ago",
      "rating": 5,
      "text": {
        "text": "Iconic tech campus with visitor areas and cafes.",
        "languageCode": "en"
      },
      "authorAttribution": {
        "displayName": "Alex Rivera"
      }
    }
  ]
}

Nhận thông tin mô tả địa chỉ

Phần mô tả địa chỉ cung cấp thông tin quan hệ về vị trí của một địa điểm, bao gồm cả các địa danh lân cận và khu vực chứa địa điểm đó.

Ví dụ sau đây cho thấy một yêu cầu Chi tiết địa điểm (Mới) cho một cửa hàng bách hoá trong một trung tâm mua sắm ở San Jose. Trong ví dụ này, bạn đưa addressDescriptors vào mặt nạ trường:

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

Phản hồi bao gồm địa điểm được chỉ định trong yêu cầu, danh sách các địa danh lân cận và khoảng cách của các địa danh đó đến địa điểm, cũng như danh sách các khu vực và mối quan hệ chứa của các khu vực đó với địa điểm:

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "languageCode": "en"
    },
    "addressDescriptor": {
      "landmarks": [
        {
          "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "food",
            "movie_theater",
            "point_of_interest",
            "restaurant",
            "shoe_store",
            "shopping_mall",
            "store"
          ],
          "spatialRelationship": "WITHIN",
          "straightLineDistanceMeters": 220.29175
        },
        {
          "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "displayName": {
            "text": "Nordstrom",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "point_of_interest",
            "shoe_store",
            "store"
          ],
          "straightLineDistanceMeters": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "areas": [
        {
          "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "displayName": {
            "text": "Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "displayName": {
            "text": "Central San Jose",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        }
      ]
    }
  }

Xem thông tin chi tiết về một địa điểm đã chuyển đi

Nếu một địa điểm được tham chiếu trong ứng dụng của bạn đã di dời, bạn có thể sử dụng các trường movedPlace và movedPlaceId để biết thông tin chi tiết về địa điểm mới.

Đối với những địa điểm đóng cửa vĩnh viễn, Chi tiết địa điểm (Mới) sẽ trả về CLOSED_PERMANENTLY trong trường businessStatus và bỏ qua các trường movedPlace và movedPlaceId trong nội dung phản hồi.

Đối với những địa điểm đã chuyển đến vị trí mới, Place Details (Mới) sẽ trả về CLOSED_PERMANENTLY trong trường businessStatus và trả về vị trí mới trong các trường movedPlace và movedPlaceId của nội dung phản hồi.

Đối với những địa điểm chưa di chuyển, Place Details (Mới) sẽ không trả về movedPlace hoặc movedPlaceId trong nội dung phản hồi.

Ví dụ sau đây yêu cầu thông tin về địa điểm Marche IGA St-Canut ở Quebec, Canada:

curl -X  GET -H 'Content-Type: application/json' \
-H 'x-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \
https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ

Yêu cầu trả về phản hồi sau:

{
  "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ",
  "businessStatus": "CLOSED_PERMANENTLY",
  "displayName": {
    "text": "Marche IGA St-Canut",
    "languageCode": "en"
  },
  "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ",
  "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ"
}

Để yêu cầu thông tin chi tiết về địa điểm mới, hãy sử dụng tên tài nguyên Địa điểm trong trường movedPlace trong yêu cầu mới về Chi tiết địa điểm (Mới).

Đối với những địa điểm đã di dời nhiều lần, bạn có thể cần phải gửi nhiều yêu cầu Chi tiết địa điểm (Mới) theo chuỗi để lấy thông tin chi tiết về vị trí hiện tại. Trường movedPlace và movedPlaceId của kết quả về địa điểm chỉ trỏ đến vị trí tiếp theo, chứ không phải vị trí xác định gần đây nhất. Địa điểm sẽ ở vị trí hiện tại nếu yêu cầu Place Details (Mới) bỏ qua các trường movedPlace và movedPlaceId trong nội dung phản hồi.

Tìm doanh nghiệp sẽ mở cửa trong tương lai

Bạn có thể yêu cầu thông tin chi tiết về những doanh nghiệp dự kiến sẽ mở cửa trong tương lai. Nearby Search (Mới) sẽ điền sẵn trường openingDate nếu ngày khai trương dự kiến bao gồm ít nhất là tháng và cách ngày hiện tại chưa đến 90 ngày.

Ví dụ sau đây cho thấy một yêu cầu Tìm kiếm lân cận (Mới) cho một doanh nghiệp sắp khai trương ở New Meadows, Idaho:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,businessStatus,openingDate" \
"https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"

Nội dung phản hồi bao gồm trạng thái hoạt động của địa điểm và ngày khai trương dự kiến:

{
  "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
  "businessStatus": "FUTURE_OPENING",
  "openingDate": {
    "year": 2026,
    "month": 4,
    "day": 15
  }
}

Xem thông tin về trạm phương tiện công cộng

Bạn có thể sử dụng tính năng Chi tiết địa điểm (Mới) để xem thông tin về các trạm phương tiện công cộng. Nội dung phản hồi bao gồm thông tin về nhà ga, bao gồm tên nhà ga, các công ty vận tải liên kết và các tuyến phương tiện công cộng phục vụ nhà ga. Ngoài ra, phản hồi còn bao gồm biểu tượng phương tiện và màu sắc mà bạn có thể sử dụng để hiển thị thông tin về trạm phương tiện công cộng.

Ví dụ sau đây cho thấy yêu cầu về thông tin trạm phương tiện công cộng cho Grand Central Station:

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

Nội dung phản hồi bao gồm thông tin về từng ga trong bán kính, các tuyến do ga đó phục vụ, cảnh báo do các công ty vận tải đưa ra tại điểm dừng đó và thông tin về chuyến khởi hành:

  {
  "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg",
  "displayName": {
    "text": "Grand Central",
    "languageCode": "en"
  },
  "transitStation": {
    "displayName": {
      "text": "Grand Central",
      "languageCode": "en"
    },
    "agencies": [
      {
        "displayName": {
          "text": "MTA New York City Transit",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/",
        "lines": [
          {
            "id": "ChIJ420yFwBZwokR903kVZLSsFc",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "42 St Shuttle",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "S",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#808183",
            "url": "https://www.mta.info/schedules/subway/42-st-shuttle",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          },
          {
            "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "5 Train (Lexington Av Express)",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "5 Line",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#00933C",
            "url": "https://www.mta.info/schedules/subway/5-train",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          }
          ...
        ]
      },
      {
        "displayName": {
          "text": "MTA",
          "languageCode": "en"
        },
        "url": "https://new.mta.info/",
        "lines": [
          {
            "id": "ChIJcwVpzKpZwokR24EBeh8arww",
            "vehicleType": "BUS",
            "displayName": {
              "text": "United Nations - W 42 St Pier",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "M42",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#1D59B3",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
            }
          }
        ]
      },
      {
        "displayName": {
          "text": "Long Island Rail Road",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/lirr",
        "lines": [
          {
            "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0",
            "vehicleType": "HEAVY_RAIL",
            "displayName": {
              "text": "Ronkonkoma Branch",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "LIRR",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#A626AA",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
            }
          }
          ...
        ]
      }
    ],
    "stops": [
      {
        "id": "ChIJRcemlf1YwokRhFqqw5jKBFM",
        "stopCode": {
          "text": "GCT"
        },
        "location": {
          "latitude": 40.755161,
          "longitude": -73.975456
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJ57l2zANZwokRD1pyhuwpfKY",
        "signageText": {
          "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.750983,
          "longitude": -73.9750686
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc",
        "displayName": {
          "text": "E 42 St/Park Av",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.7518199,
          "longitude": -73.9771918
        },
        "wheelchairAccessibleEntrance": true
      }
      ...
    ]
  }
}

Xem lối vào và điểm chỉ đường

Bạn có thể yêu cầu thêm lối vào và điểm đi theo chỉ dẫn cho một điểm đến. Lối vào xác định điểm vào và ra của một địa điểm (ví dụ: các cổng khác nhau tại sân bay hoặc trung tâm mua sắm). Điểm điều hướng xác định các vị trí bên đường mà tại đó, việc điều hướng sẽ kết thúc. Điều này giúp đưa người dùng đến đúng bên đường hoặc một điểm trả khách cụ thể.

Điểm điều hướng trả về navigationPointToken. Bạn có thể truyền mã thông báo này đến SDK Điều hướng (dành cho Android hoặc iOS) hoặc Routes API để hướng dẫn tài xế đến vị trí cụ thể đó. Để biết thêm thông tin, hãy xem bài viết Mã thông báo điểm điều hướng.

Ví dụ sau đây yêu cầu thông tin chi tiết về Sân bay Quốc tế San Francisco (mã địa điểm ChIJVVVVVYx3j4ARP-3NGldc8qQ), bao gồm cả entrances và navigationPoints trong mặt nạ trường:

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

Phản hồi bao gồm lối vào và điểm đi theo chỉ dẫn cho địa điểm:

{
  "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ",
  "displayName": {
    "text": "San Francisco International Airport",
    "languageCode": "en"
  },
  "entrances": [
    {
      "location": {
        "latitude": 37.6172154,
        "longitude": -122.3839724
      }
    },
    {
      "location": {
        "latitude": 37.6174073,
        "longitude": -122.384196
      }
    },
    ...
  ],
  "navigationPoints": [
    {
      "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...",
      "displayName": {
        "text": "International Terminal Departures Level",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6153121,
        "longitude": -122.3900833
      },
      "travelModes": ["WALK"]
    },
    {
      "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...",
      "displayName": {
        "text": "Domestic Garage - SFO Short Term Parking",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6157153,
        "longitude": -122.3885012
      },
      "travelModes": ["DRIVE", "WALK"],
      "usages": ["PARKING"]
    },
    ...
  ]
}

Hãy dùng thử!

APIs Explorer 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.

1. Chọn biểu tượng API api ở bên phải trang.

2. Chỉnh sửa các tham số yêu cầu (không bắt buộc).

3. Chọn nút Execute (Thực thi). Trong hộp thoại, hãy chọn tài khoản mà bạn muốn dùng để gửi yêu cầu.

4. Trong bảng điều khiển APIs Explorer, hãy chọn biểu tượng toàn màn hình fullscreen để mở rộng cửa sổ APIs Explorer.