Tìm kiếm văn bản (Mới)

Thao tác Tìm kiếm văn bản (Mới) trả về thông tin về một nhóm địa điểm dựa trên một chuỗi, ví dụ: "pizza ở New York" hoặc "cửa hàng giày gần Ottawa" hoặc "123 Main Street". Dịch vụ phản hồi bằng một danh sách các địa điểm khớp với chuỗi văn bản và mọi sai lệch vị trí đã đặt.

Dịch vụ này đặc biệt hữu ích khi thực hiện các truy vấn địa chỉ không rõ ràng trong một hệ thống tự động và các thành phần không có địa chỉ của chuỗi có thể khớp với doanh nghiệp cũng như địa chỉ. Ví dụ về truy vấn địa chỉ không rõ ràng là địa chỉ có định dạng kém hoặc yêu cầu chứa các thành phần không có địa chỉ như tên doanh nghiệp. Các yêu cầu như 2 ví dụ đầu tiên trong bảng sau có thể trả về 0 kết quả trừ phi một vị trí (chẳng hạn như khu vực, giới hạn vị trí hoặc thiên vị về vị trí) được đặt.

"10 High Street, UK" hoặc "123 Main Street, Hoa Kỳ" Nhiều đường "High Street" ở Vương quốc Anh; nhiều đường "Main Street" ở Hoa Kỳ. Truy vấn không trả về kết quả mong muốn trừ phi bạn đặt giới hạn về vị trí.
"ChainNhà hàng New York" Nhiều địa điểm "ChainNhà hàng" ở New York; không có địa chỉ đường phố hay thậm chí không có tên đường phố.
"10 High Street, Escher UK" hoặc "123 Main Street, Pleasanton US" Chỉ một "Đường cao tốc" ở thành phố Escher của Vương quốc Anh; chỉ một "đường Main" ở thành phố Pleasanton CA của Hoa Kỳ.
"UniqueCustomerName New York" Chỉ một cơ sở có tên này ở New York; không cần địa chỉ đường phố để phân biệt.
"nhà hàng pizza ở New York" Truy vấn này chứa giới hạn vị trí và "nhà hàng pizza" là loại địa điểm được xác định rõ ràng. Phương thức này trả về nhiều kết quả.
"+1 514-670-8700"

Truy vấn này chứa một số điện thoại. Phương thức này trả về nhiều kết quả cho các địa điểm liên kết với số điện thoại đó.

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

Hãy làm thử!

Yêu cầu Tìm kiếm văn bản

Yêu cầu Tìm kiếm văn bản là một yêu cầu POST qua HTTP có dạng sau:

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

Truyền tất cả tham số trong nội dung yêu cầu JSON hoặc trong tiêu đề như một phần của yêu cầu POST. Ví dụ:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'

Phản hồi cho tính năng Tìm kiếm văn bản (Mới)

Tính năng Tìm kiếm văn bản (Mới) trả về một đối tượng JSON làm phản hồi. Trong câu trả lời:

  • Mảng places chứa tất cả các địa điểm phù hợp.
  • Mỗi vị trí trong mảng được biểu thị bằng một đối tượng Place. Đối tượng Place chứa thông tin chi tiết về một địa điểm duy nhất.
  • FieldMask (Mặt nạ) được truyền vào yêu cầu sẽ 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:

{
  "places": [
    {
      object (Place)
    }
  ]
}

Thông số bắt buộc

  • FieldMask

    Chỉ định danh sách trường cần trả về trong phản hồi bằng cách tạo 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 hay fields, hoặc bằng tiêu đề HTTP X-Goog-FieldMask. Không có danh sách mặc định các trường được trả về trong phản hồi. Nếu bạn bỏ qua mặt nạ trường (field mask), phương thức sẽ trả về một lỗi.

    Che giấu trường là một phương pháp thiết kế hay để đảm bảo 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ần trả về, được phân tách bằng dấu phẩy. Ví dụ: để truy xuất tên hiển thị và địa chỉ của địa điểm.

    X-Goog-FieldMask: places.displayName,places.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 của Tìm kiếm văn bản (chỉ nhận dạng):

      places.id, places.name*

      * Trường places.name chứa địa điểm tên tài nguyên ở dạng: places/PLACE_ID. Sử dụng places.displayName để truy cập vào tên văn bản của địa điểm.
    • Các trường sau đây kích hoạt SKU của Tìm kiếm văn bản (Cơ bản):

      places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.displayName, places.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport
    • Các trường sau đây kích hoạt SKU của công cụ Tìm kiếm văn bản (Nâng cao):

      places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri
    • Các trường sau đây kích hoạt SKU của công cụ Tìm kiếm văn bản (ưu tiên):

      places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions, places.fuelOptions, places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.liveMusic, places.menuForChildren, places.parkingOptions, places.paymentOptions, places.outdoorSeating, places.reservable, places.restroom, places.reviews, places.servesBeer, places.delivery, places.delivery, places.delivery, places.delivery, places.delivery, places.delivery, places.delivery, places.delivery, places.delivery, places.delivery, places.delivery, places.servesBeer, places.delivery, places.menuForChildren, places.menuForChildrenplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout
  • textQuery

    Chuỗi văn bản để tìm kiếm, ví dụ: "nhà hàng", "123 Main Street" hoặc "địa điểm tốt nhất nên ghé thăm ở San Francisco". API trả về các kết quả phù hợp dựa trên chuỗi này và sắp xếp các kết quả dựa trên mức độ liên quan cảm nhận được.

Thông số tùy chọn

  • includedType

    Giới hạn kết quả ở các vị trí khớp với loại đã chỉ định được xác định trong Bảng A. Bạn chỉ có thể chỉ định một loại. Ví dụ:

    • "includedType":"bar"
    • "includedType":"pharmacy"
  • languageCode

    Ngôn ngữ mà kết quả trả về.

    • Xem danh sách ngôn ngữ được hỗ trợ. Google thường cập nhật các ngôn ngữ được hỗ trợ, nên danh sách này có thể chưa đầy đủ.
    • Nếu bạn không cung cấp languageCode, API mặc định sẽ 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 sẽ cố gắng hết sức để cung cấp một địa chỉ đường phố mà cả người dùng và người dân địa phương mà người dùng và người dân địa phương có thể đọc được. Để đạt được mục tiêu đó, phương thức 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, đồng thời quan sát 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ả 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 tên không được hỗ trợ bằng ngôn ngữ ưu tiên, thì API sẽ sử dụng kết quả khớ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ề, cũng như thứ tự mà các kết quả được trả về. Bộ mã hoá địa lý này diễn giải các từ viết tắt theo cách khác nhau tuỳ theo ngôn ngữ, chẳng hạn như cách viết tắt cho các loại đường phố hoặc từ đồng nghĩa có thể hợp lệ ở một ngôn ngữ nhưng không hợp lệ trong ngôn ngữ khác.
  • locationBias

    Chỉ định một khu vực để tìm kiếm. Vị trí này đóng vai trò là một độ chệch nghĩa là có thể trả về các kết quả xung quanh vị trí đã chỉ định, bao gồm cả những kết quả nằm ngoài khu vực cụ thể đó.

    Bạn có thể chỉ định locationRestriction hoặc locationBias, nhưng không thể chỉ định cả hai. Hãy xem locationRestriction là khu vực chỉ định kết quả nằm gần đó, còn locationBias là khu vực chỉ định kết quả phải ở gần nhưng có thể nằm ngoài khu vực đó.

    Hãy chỉ định khu vực dưới dạng Khung nhìn hình chữ nhật hoặc dưới dạng vòng tròn.

    • Một đường tròn được xác định bởi điểm ở giữa và bán kính tính bằng mét. Bán kính phải nằm trong khoảng từ 0 đến 50000. Bán kính mặc định là 0,0. Ví dụ:

      "locationBias": {
        "circle": {
          "center": {
            "latitude": 37.7937,
            "longitude": -122.3965
          },
          "radius": 500.0
        }
      }
    • Hình chữ nhật là một khung nhìn theo vĩ độ, được thể hiện dưới dạng hai điểm thấp và cao theo đường chéo đối diện. Điểm thấp đánh dấu góc phía Tây Nam của hình chữ nhật, còn điểm cao biểu thị góc phía đông bắc của hình chữ nhật.

      Khung nhìn được coi là một khu vực khép kín, có nghĩa là khung nhìn bao gồm ranh giới của khu vực đó. Giới hạn vĩ độ phải nằm trong khoảng từ -90 đến 90 độ và giới hạn kinh độ phải nằm trong khoảng từ -180 đến 180 độ:

      • Nếu low = high, khung nhìn sẽ bao gồm điểm duy nhất đó.
      • Nếu low.longitude > high.longitude, phạm vi kinh độ sẽ bị đảo ngược (khung nhìn vượt qua đường kinh độ 180 độ).
      • Nếu low.longitude = -180 độ và high.longitude = 180 độ, thì khung nhìn sẽ bao gồm tất cả các kinh độ.
      • Nếu low.longitude = 180 độ và high.longitude = -180 độ, thì phạm vi kinh độ sẽ trống.
      • Nếu low.latitude > high.latitude, thì phạm vi vĩ độ sẽ trống.

      Bạn phải điền cả giá trị cao và thấp, đồng thời không được để trống hộp được đại diện. Khung nhìn trống dẫn đến lỗi.

      Ví dụ: khung nhìn này bao quanh đầy đủ Thành phố New York:

      "locationBias": {
        "rectangle": {
          "low": {
            "latitude": 40.477398,
            "longitude": -74.259087
          },
          "high": {
            "latitude": 40.91618,
            "longitude": -73.70018
          }
        }
      }
  • locationRestriction

    Chỉ định một khu vực để tìm kiếm. Kết quả nằm ngoài khu vực đã chỉ định sẽ không được trả về. Chỉ định khu vực dưới dạng Khung nhìn hình chữ nhật. Hãy xem nội dung mô tả về locationBias để biết thông tin về cách xác định Khung nhìn.

    Bạn có thể chỉ định locationRestriction hoặc locationBias, nhưng không thể chỉ định cả hai. Hãy xem locationRestriction là khu vực chỉ định kết quả nằm gần đó, còn locationBias là khu vực chỉ định kết quả phải ở gần nhưng có thể nằm ngoài khu vực đó.

  • maxResultCount

    Chỉ định số lượng kết quả địa điểm tối đa cần trả về. Giá trị phải nằm trong khoảng từ 1 đến 20 (mặc định).

  • evOptions

    Quy định các tham số để xác định giắc cắm sạc và tốc độ sạc hiện có cho xe điện (EV).

    • connectorTypes

      Bộ lọc theo loại giắc cắm sạc xe điện có tại một địa điểm. Vị trí không hỗ trợ bất kỳ loại trình kết nối nào sẽ bị lọc ra. Các loại giắc cắm sạc xe điện được hỗ trợ bao gồm bộ sạc kết hợp (AC và DC), bộ sạc Tesla, bộ sạc tuân thủ tiêu chuẩn GB/T (dành cho sạc nhanh xe điện ở Trung Quốc) và bộ sạc trên ổ cắm trên tường. Để biết thêm thông tin, hãy xem tài liệu tham khảo.

    • minimumChargingRateKw

      Lọc các địa điểm theo tốc độ sạc xe điện tối thiểu tính bằng kilowatt (kW). Bất kỳ địa điểm nào có tốc độ sạc thấp hơn tốc độ sạc tối thiểu sẽ bị lọc ra. Ví dụ: để tìm bộ sạc xe điện có công suất sạc tối thiểu là 10 kW, bạn có thể đặt tham số này thành "10".

  • minRating

    Chỉ hiển thị kết quả cho những người có điểm xếp hạng trung bình từ người dùng lớn hơn hoặc bằng giới hạn này. Giá trị phải nằm trong khoảng từ 0 đến 5 (bao gồm cả 0,5). Ví dụ: 0, 0,5, 1,0, ..., 5.0. Các giá trị được làm tròn lên đến số 0,5 gần nhất. Ví dụ: giá trị 0, 6 sẽ loại bỏ mọi kết quả có điểm xếp hạng thấp hơn 1.

  • openNow

    Nếu là true, chỉ trả về những địa điểm đang mở cửa kinh doanh tại thời điểm gửi truy vấn. Nếu giá trị là false, hãy trả về tất cả các doanh nghiệp, bất kể trạng thái đang mở cửa. Các địa điểm không chỉ định giờ mở cửa trong cơ sở dữ liệu của Google Địa điểm sẽ được trả về nếu bạn đặt tham số này thành false.

  • priceLevels

    Hạn chế tìm kiếm trong các địa điểm được đánh dấu theo các mức giá nhất định. Tuỳ chọn mặc định là chọn tất cả các mức giá.

    Chỉ định một mảng gồm một hoặc nhiều giá trị do PriceLevel xác định.

    Ví dụ:

    "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
  • rankPreference

    Nêu cách xếp hạng kết quả trong câu trả lời. Theo mặc định, API sử dụng RELEVANCE (nếu có). Ví dụ: đối với một cụm từ tìm kiếm như "Nhà hàng ở thành phố New York", thì RELEVANCE sẽ là giá trị mặc định. Đối với cụm từ tìm kiếm theo địa lý, chẳng hạn như " Mountain View, CA" hoặc các loại cụm từ tìm kiếm khác, không có cụm từ tìm kiếm mặc định nào được áp dụng và kết quả xuất hiện theo thứ tự mà giao diện người dùng trả về.

    Các giá trị bao gồm:

    • DISTANCE: Xếp hạng kết quả theo khoảng cách.
    • RELEVANCE: Xếp hạng kết quả theo mức độ liên quan.
  • regionCode

    Mã vùng 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ự. Tham số này cũng có thể ảnh hưởng đến kết quả tìm kiếm. 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ị loại khỏi formattedAddress. Tham số này không ảnh hưởng đến adrFormatAddress (luôn bao gồm tên quốc gia (nếu có) hoặc ngày shortFormattedAddress (không bao giờ bao gồm tên quốc gia này).

    Hầu hết các mã CLDR đều giống hệt với mã ISO 3166-1, trừ một số trường hợp ngoại lệ đáng chú ý. Ví dụ: ccTLD (miền cấp cao nhất theo mã quốc gia) 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à pháp nhân của "Vương quốc 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.

  • strictTypeFiltering

    Được dùng với tham số includeType. Khi đặt thành true, chỉ những vị trí khớp với loại chỉ định do includeType chỉ định mới được trả về. Khi là false, theo mặc định, phản hồi có thể chứa các vị trí không khớp với loại đã chỉ định.

Ví dụ về Tìm kiếm văn bản

Tìm một địa điểm bằng chuỗi truy vấn

Ví dụ sau đây cho thấy một yêu cầu Tìm kiếm văn bản cho "Đồ ăn chay ngon ở Sydney, Úc":

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'

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: places.displayName,places.formattedAddress. Sau đó, phản hồi sẽ có dạng:

{
  "places": [
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia",
      "displayName": {
        "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "29 King St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Peace Harmony",
        "languageCode": "en"
      }
    },
    ...
  ]
}

Thêm các loại dữ liệu khác vào mặt nạ trường (field mask) để trả về thông tin bổ sung. Ví dụ: thêm places.types,places.websiteUri để đưa loại nhà hàng và địa chỉ web vào phản hồi:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri' \
'https://places.googleapis.com/v1/places:searchText'

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

{
  "places": [
    {
      "types": [
        "vegetarian_restaurant",
        "vegan_restaurant",
        "chinese_restaurant",
        "restaurant",
        "food",
        "point_of_interest",
        "establishment"
      ],
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "websiteUri": "http://www.motherchusvegetarian.com.au/",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "types": [
        "vegan_restaurant",
        "thai_restaurant",
        "vegetarian_restaurant",
        "indian_restaurant",
        "italian_restaurant",
        "american_restaurant",
        "restaurant",
        "food",
        "point_of_interest",
        "establishment"
      ],
      "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia",
      "websiteUri": "http://www.veggosizzle.com.au/",
      "displayName": {
        "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney",
        "languageCode": "en"
      }
    },
    ...
  ]
}

Lọc địa điểm theo mức giá

Sử dụng tuỳ chọn priceLevel để lọc kết quả theo các nhà hàng được xác định là rẻ hoặc vừa phải:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'

Ví dụ này cũng sử dụng tiêu đề X-Goog-FieldMask để thêm trường dữ liệu places.priceLevel vào phản hồi. Nhờ đó, trường dữ liệu có dạng:

{
  "places": [
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "115 King St, Newtown NSW 2042, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Green Mushroom",
        "languageCode": "en"
      }
    },
    ...
  ]
}

Thêm các tuỳ chọn bổ sung để tinh chỉnh kết quả tìm kiếm, chẳng hạn như includedType, minRating, rankPreference, openNow và các thông số khác được mô tả trong phần Tham số không bắt buộc.

Tìm địa điểm trong một khu vực

Hãy dùng locationRestriction hoặc locationBias (chứ không phải cả hai) để hạn chế hoạt động tìm kiếm trong một khu vực. Hãy coi locationRestriction là chỉ định khu vực chứa kết quả và locationBias là khu vực chỉ định kết quả gần nhưng có thể nằm ngoài khu vực đó.

Ví dụ sau đây cho thấy một yêu cầu Tìm kiếm văn bản về "Đồ ăn chay có vị cay" bị lệch trong phạm vi 500 mét của một điểm ở trung tâm thành phố San Francisco. Yêu cầu này chỉ trả về 10 kết quả đầu tiên cho các địa điểm đang mở cửa.

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food",
  "openNow": true,
  "maxResultCount": 10,
  "locationBias": {
    "circle": {
      "center": {"latitude": 37.7937, "longitude": -122.3965},
      "radius": 500.0
    }
  },
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'

Tìm bộ sạc xe điện có tốc độ sạc tối thiểu

Sử dụng minimumChargingRateKwconnectorTypes để tìm các địa điểm có bộ sạc có sẵn tương thích với xe điện của bạn.

Ví dụ sau đây cho thấy một yêu cầu về giắc cắm sạc xe điện loại 1 Tesla và J1772 với công suất sạc tối thiểu là 10 kW tại Mountain View, CA. Chỉ có 4 kết quả được trả về.

curl -X POST -d '{
    "textQuery": "EV Charging Station Mountain View",
    "maxResultCount": 4,
    "evOptions": {
      "minimumChargingRateKw": 10,
      "connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"]
    }
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \
'https://places.googleapis.com/v1/places:searchText'

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

{
  "places": [
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 16,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_CHADEMO",
            "maxChargeRateKw": 100,
            "count": 8,
            "availableCount": 5,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 100,
            "count": 2,
            "availableCount": 2,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 350,
            "count": 6,
            "availableCount": 3,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          }
        ]
      }
    },
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 6,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 100,
            "count": 4,
            "availableCount": 3,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 350,
            "count": 2,
            "availableCount": 0,
            "outOfServiceCount": 2,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          }
        ]
      }
    },
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 5,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_J1772",
            "maxChargeRateKw": 3.5999999046325684,
            "count": 1,
            "availableCount": 0,
            "outOfServiceCount": 1,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CHADEMO",
            "maxChargeRateKw": 50,
            "count": 2,
            "availableCount": 0,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 50,
            "count": 2,
            "availableCount": 0,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          }
        ]
      }
    },
    {
      "displayName": {
        "text": "Electric Vehicle Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 10,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_OTHER",
            "maxChargeRateKw": 210,
            "count": 10
          }
        ]
      }
    }
  ]
}

Hãy dùng thử!

API Explorer cho phép bạn thực hiện các yêu cầu mẫu để bạn có thể làm quen với các API và các tuỳ chọn API.

  1. (Không bắt buộc) Mở rộng mục Show standard parameters (Hiện tham số chuẩn) và đặt tham số fields thành mặt nạ trường.

  2. Chỉnh sửa Nội dung yêu cầu nếu muốn.

  3. Chọn nút Thực thi. Trong hộp thoại bật lên, hãy chọn tài khoản mà bạn muốn dùng để thực hiện yêu cầu.