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

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

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". Chiến lược phát hành đĩa đơn dịch vụ sẽ phản hồi bằng một danh sách địa điểm khớp với chuỗi văn bản và vị trí bất kỳ thiên kiến đã được đặt ra.

Dịch vụ này đặc biệt hữu ích khi truy vấn địa chỉ không rõ ràng trong 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 doanh nghiệp cũng như địa chỉ. Ví dụ về truy vấn địa chỉ không rõ ràng là địa chỉ hoặc yêu cầu được định dạng kém bao gồm các thành phần không có địa chỉ như làm tên doanh nghiệp. Các yêu cầu như hai ví dụ đầu tiên trong bảng sau có thể trả về kết quả bằng 0 trừ phi một vị trí (chẳng hạn như khu vực, vị trí) hoặc giới hạn vị trí — được đặt.

"10 High Street, Vương quốc Anh" hoặc "123 Main Street, Hoa Kỳ" Nhiều "Đường cao tốc" ở Vương quốc Anh; nhiều "Phố chính" ở Hoa Kỳ. Truy vấn không trả về kết quả mong muốn trừ phi có quy định hạn chế về vị trí thiết lập.
"ChainRestaurant New York" Nhiều "ChainRestaurant" các địa điểm ở New York; không có địa chỉ đường phố hoặc thậm chí cả tên đường phố.
"10 High Street, Escher UK" hoặc "123 Main Street, Pleasanton US" Chỉ một "Đường thông cao" ở thành phố Escher của Vương quốc Anh; chỉ một "Phố Chính" ở thành phố Pleasanton CA của Hoa Kỳ.
" UniqueRestaurantName New York" Chỉ một cơ sở có tên này ở New York; không có địa chỉ đường phố cần thiết để 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à một loại địa điểm được xác định rõ ràng. Hàm này trả về nhiều kết quả.
"+1 514-670-8700"

Truy vấn này có chứa số điện thoại. Hàm này trả về nhiều kết quả cho địa điểm được 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à 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à yêu cầu POST qua HTTP có dạng sau:

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

Truyền tất cả các tham số trong nội dung của yêu cầu JSON hoặc trong tiêu đề dưới dạng 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'

Câu trả lời bằng tính năng Tìm kiếm bằng văn bản (Mới)

Tìm kiếm văn bản (Mới) trả về đố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 Place . Đối tượng Place chứa thông tin chi tiết về một địa điểm.
  • FieldMask được chuyển trong yêu cầu chỉ định danh sách 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 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 này 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 gồm 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.

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

    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ụ: để 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ỉ mã nhận dạng):

      places.attributions, places.id, places.name*! nextPageToken

      * Trường places.name chứa tên tài nguyên địa điểm trong biểu mẫu: places/PLACE_ID. Sử dụng places.displayName để truy cập vào tên dạng văn bản của địa điểm.

    • Các trường sau đây kích hoạt SKU 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 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 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.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout

  • textQuery

    Chuỗi văn bản cần tìm kiếm, ví dụ: "nhà hàng", "123 Main Street" hoặc "địa điểm tốt nhất để ghé thăm ở San Francisco". API trả về kết quả phù hợp với ứng viên dựa trên 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 mà hệ thống nhận thấy.

Thông số tùy chọn

  • includedType

    Giới hạn kết quả ở các địa điểm phù hợp với loại đã chỉ định theo 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 xuyên cập nhật các ngôn ngữ được hỗ trợ, vì vậy, danh sách này có thể không đầy đủ.
    • Nếu languageCode không được cung cấp, API 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 cố gắng hết sức để cung cấp địa chỉ đường phố có thể đọc được cả người dùng và cục bộ. Để đạt được mục tiêu đó, hàm sẽ trả về giá trị đường phố các địa chỉ theo ngôn ngữ địa phương, được chuyển tự thành một tập lệnh có thể đọc được người dùng (nếu cần) quan sát ngôn ngữ ưu tiên. Tất cả giá trị khác được trả về bằng ngôn ngữ ưu tiên. Các thành phần địa chỉ là tất cả được trả về trong cùng một ngôn ngữ, được chọn từ ngôn ngữ đầu tiên thành phần.
    • Nếu tên không có sẵn bằng ngôn ngữ ưu tiên, API sẽ sử dụng kết quả 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ự mà hàm được trả về. Chiến lược phát hành đĩa đơn bộ mã hoá địa lý diễn giải 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ể là có hiệu lực bằng một ngôn ngữ nhưng không có hiệu lực bằng ngôn ngữ khác.

  • locationBias

    Chỉ định một vùng để tìm kiếm. Vị trí này có nghĩa là có thể trả về kết quả quanh vị trí chỉ định, bao gồm kết quả bên ngoài khu vực được chỉ định.

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

    Chỉ định khu vực dưới dạng Cửa sổ xem hình chữ nhật hoặc hình tròn.

    • Một đường tròn được xác định bởi tâm điểm và bán kính tính bằng mét. Bán kính phải nằm trong khoảng từ 0,0 đến 50000,0. 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 vĩ độ – kinh độ, được biểu thị dưới dạng hai theo đường chéo đối diện với điểm cao và điểm thấp. Điểm thấp đánh dấu hướng tây nam góc của hình chữ nhật, và điểm cao nhất đại diện cho hướng đông bắc góc của hình chữ nhật.

      Khung nhìn được xem là khu vực khép kín, nghĩa là khu vực này bao gồm ranh giới của nó. 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 độ, bao gồm cả hai giá trị sau:

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

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

      Ví dụ: khung nhìn này bao quanh hoàn toàn 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 vùng để tìm kiếm. Kết quả nằm ngoài khu vực được chỉ định không bị trả lại. Chỉ định khu vực dưới dạng một Khung nhìn hình chữ nhật. Xem nội dung mô tả / 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 phải cả hai. Hãy xem locationRestriction khi chỉ định khu vực nơi có kết quả và locationBias là chỉ định khu vực nơi kết quả phải ở gần nhưng có thể ở bên ngoài khu vực đó.

  • maxResultCount (không dùng nữa)

    Chỉ định số lượng kết quả (từ 1 đến 20) để hiển thị trên mỗi trang. Ví dụ: việc đặt giá trị maxResultCount là 5 sẽ trả về kết quả là 5 kết quả trên trang đầu tiên. Nếu có kết quả khác có thể được trả về từ truy vấn, phản hồi bao gồm nextPageToken mà bạn có thể chuyển vào yêu cầu tiếp theo để truy cập trang tiếp theo.

  • evOptions

    Chỉ định các thông số để xác định xe điện (EV) hiện có giắc cắm sạc và mức sạc.

    • connectorTypes

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

    • minimumChargingRateKw

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

  • minRating

    Chỉ cung cấp kết quả cho những người có điểm xếp hạng trung bình từ người dùng cao 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) trong gia số 0,5. Ví dụ: bao gồm 0, 0.5, 1.0, ... , 5.0. Các giá trị là làm tròn lên đến 0,5 gần nhất. Ví dụ: giá trị 0, 6 loại bỏ tất cả kết quả có điểm xếp hạng dưới 1.0.

  • openNow

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

  • pageSize

    Chỉ định số lượng kết quả (từ 1 đến 20) để hiển thị trên mỗi trang. Ví dụ: việc đặt giá trị pageSize là 5 sẽ trả về kết quả là 5 kết quả trên trang đầu tiên. Nếu có kết quả khác có thể được trả về từ truy vấn, phản hồi bao gồm nextPageToken mà bạn có thể chuyển vào yêu cầu tiếp theo để truy cập trang tiếp theo.

  • pageToken

    Chỉ định nextPageToken từ nội dung phản hồi của trang trước.

  • priceLevels

    Hạn chế tìm kiếm ở những địa điểm được đánh dấu ở các mức giá nhất định. Lựa 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ị được xác định bởi PriceLevel.

    Ví dụ:

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

  • rankPreference

    Chỉ định cách xếp hạng kết quả trong phản hồi dựa trên loại truy vấn:

    • Đối với truy vấn theo danh mục, chẳng hạn như "Nhà hàng ở Thành phố New York", RELEVANCE (xếp hạng kết quả theo mức độ liên quan với cụm từ tìm kiếm) là chế độ mặc định. Bạn có thể đặt rankPreference thành RELEVANCE hoặc DISTANCE (xếp hạng kết quả theo khoảng cách).
    • Đối với truy vấn không theo danh mục, chẳng hạn như "Mountain View, CA", bạn nên bạn không đặt rankPreference.

  • regionCode

    Mã vùng dùng để định dạng phản hồi, được chỉ định làm mã CLDR gồm hai ký tự. Tham số này cũng có thể có hiệu ứng sai lệch trê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 phản hồi khớp với regionCode, mã quốc gia bị bỏ qua từ formattedAddress. Thông số này không ảnh hưởng đến adrFormatAddress, luôn bao gồm cả quốc gia tên khi có hoặc trên shortFormattedAddress, giá trị này không bao giờ bao gồm nó.

    Hầu hết mã CLDR đều giống với mã ISO 3166-1, với một số 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à "Vương quốc Anh" (.co.uk) trong khi mã ISO 3166-1 của trang web là "gb" (về mặt kỹ thuật cho pháp nhân "Vương quốc Anh và Bắc Ireland"). Tuỳ theo luật hiện hành, thông số này có thể ảnh hưởng đến kết quả.

  • strictTypeFiltering

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

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

Tìm địa điểm theo chuỗi truy vấn

Ví dụ sau đây minh hoạ yêu cầu Tìm kiếm văn bản cho "Thực phẩm chay cay ở 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'

Hãy 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 để trả về thông tin bổ sung. Ví dụ: thêm places.types,places.websiteUri để bao gồm loại nhà hàng và địa chỉ web trong 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'

Câu trả lờ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 lựa chọn priceLevel để lọc kết quả theo nhà hàng được xác định là rẻ hoặc đắt 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 phần tử trường dữ liệu places.priceLevel sang phản hồi vì vậy, mã sẽ ở 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 lựa chọn khác để 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 Tham số không bắt buộc.

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

Hãy sử dụng locationRestriction hoặc locationBias. nhưng không phải cả hai, để hạn chế tìm kiếm trong một khu vực. Hãy nghĩ đến locationRestriction khi chỉ định khu vực chứa kết quả, và locationBias khi chỉ định khu vực mà kết quả phải ở gần nhưng có thể ở bên ngoài khu vực đó.

Ví dụ sau đây minh hoạ yêu cầu Tìm kiếm văn bản cho "Đồ ăn chay có vị cay" có xu hướng nằm trong phạm vi 500 mét tính từ 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 địa điểm đang mở cửa.

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food",
  "openNow": true,
  "pageSize": 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 minimumChargingRateKw và connectorTypes để hãy tìm những nơi có bộ sạc 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 sạc xe điện loại 1 của Tesla và J1772 đầu nối có công suất sạc tối thiểu là 10 kW ở Mountain View, CA. Chỉ bốn kết quả được trả về.

curl -X POST -d '{
    "textQuery": "EV Charging Station Mountain View",
    "pageSize": 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
          }
        ]
      }
    }
  ]
}

Chỉ định số lượng kết quả để trả về cho mỗi trang

Sử dụng tham số pageSize để chỉ định một số kết quả cho lợi nhuận trên mỗi trang. Tham số nextPageToken trong nội dung phản hồi cung cấp mã thông báo có thể được sử dụng trong các lệnh gọi tiếp theo để truy cập trang tiếp theo của kết quả.

Ví dụ sau đây cho thấy một yêu cầu đối với "pizza ở New York" tối đa là 5 số kết quả trên mỗi trang:

 curl -X POST -d '{
  "textQuery": "pizza in New York",
  "pageSize": 5
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'

{
  "places": [
    {
      "id": "ChIJifIePKtZwokRVZ-UdRGkZzs"
    },
    {
      "id": "ChIJPxPd_P1YwokRfzLhSiACEoU"
    },
    {
      "id": "ChIJrXXKn5NZwokR78g0ipCnY60"
    },
    {
      "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE"
    },
    {
      "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw"
    }
  ],
  "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q"
}

Để truy cập vào trang kết quả tiếp theo, hãy sử dụng pageToken để chuyển vào nextPageToken trong nội dung yêu cầu:

 curl -X POST -d '{
  "textQuery": "pizza in New York",
  "pageSize": 5,
  "pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q"
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'

{
  "places": [
    {
      "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw"
    },
    {
      "id": "ChIJjaD94kFZwokR-20CXqlpy_4"
    },
    {
      "id": "ChIJ6ffdpJNZwokRmcafdROM5q0"
    },
    {
      "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM"
    },
    {
      "id": "ChIJ8164qwFZwokRhplkmhvq1uE"
    }
  ],
  "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c"
}

Hãy dùng thử!

API Explorer cho phép bạn thực hiện các yêu cầu mẫu để mà 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, Mở rộng API Explorer. ở bên phải của trang.

  2. Mở rộng tuỳ chọn Hiển thị các tham số chuẩn và đặt fields tham số vào trường mặt nạ.

  3. Chỉnh sửa Nội dung yêu cầu (không bắt buộc).

  4. Chọn nút Thực thi. Trong hộp thoại bật lên, chọn tài khoản mà bạn muốn sử dụng để đưa ra yêu cầu.

  5. Trong bảng điều khiển API Explorer, hãy chọn biểu tượng mở rộng Mở rộng API Explorer., để mở rộng cửa sổ API Explorer.