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

Sử dụng mã thông báo phiên

Mã thông báo phiên sẽ nhóm các giai đoạn truy vấn và lựa chọn trong quá trình tự động hoàn thành của người dùng tìm kiếm vào một phiên riêng biệt cho mục đích thanh toán. Các ví dụ sau đây minh hoạ cách sử dụng mã thông báo phiên trong các lệnh gọi Tự động hoàn thành (Mới) và Chi tiết địa điểm (Mới).

Tạo mã thông báo phiên

Người dùng chịu trách nhiệm tạo mã thông báo phiên duy nhất cho mỗi phiên. Bạn nên sử dụng mã nhận dạng duy nhất (UUID) phiên bản 4.

Lưu ý: Mã thông báo phiên có thể trùng lặp trên các dự án Google Cloud Console, nhưng chúng phải là duy nhất cho mỗi dự án. Ví dụ: một ứng dụng dùng Dự án A và một ứng dụng dùng Dự án B có thể sử dụng cùng một mã thông báo phiên, nhưng nhiều ứng dụng sử dụng Dự án A không thể sử dụng cùng một mã thông báo phiên.

Tạo yêu cầu Tự động hoàn thành (Mới)

Yêu cầu Tự động hoàn thành (Mới) là yêu cầu POST qua HTTP. Thông tin khác về các tham số nội dung của yêu cầu, hãy xem các yêu cầu Địa điểm tự động hoàn thành (Mới).

Loạt yêu cầu sau đây cho thấy một người dùng đang tìm thông tin về một cửa hàng pizza ở San Francisco. Khi người dùng bắt đầu nhập truy vấn, tính năng Tự động hoàn thành (Mới) được gọi cho từng thao tác nhấn phím. Mã thông báo phiên đã tạo sẽ được chuyển dưới dạng thông số trong mỗi .

Yêu cầu và phản hồi đầu tiên

Yêu cầu 1

curl -X POST -d '{
  "input": "p",
  "sessionToken": "3519edfe-0f75-4a30-bfe4-7cbd89340b2c",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965
      },
      "radius": 500.0
    }
  }
}' -H 'Content-Type: application/json' -H "X-Goog-Api-Key: YOUR_API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

Phản hồi 1

{
  "suggestions": [
    {
      "placePrediction": {
        "place": "places/ChIJHSGzi_yAhYARnrPmDWAx9ro",
        "placeId": "ChIJHSGzi_yAhYARnrPmDWAx9ro",
        "text": {
          "text": "PIER 39, The Embarcadero, San Francisco, CA, USA",
          "matches": [
            {
              "endOffset": 1
            }
          ]
        },
        "structuredFormat": {
          "mainText": {
            "text": "PIER 39",
            "matches": [
              {
                "endOffset": 1
              }
            ]
          },
          "secondaryText": {
            "text": "The Embarcadero, San Francisco, CA, USA"
          }
        },
        "types": [
          "historical_landmark",
          "shopping_mall",
          "point_of_interest",
          "establishment",
          "marina",
          "tourist_attraction"
        ]
      }
    },
  ]
   / ... /
}

Yêu cầu và phản hồi thứ hai

Yêu cầu 2

curl -X POST -d '{
  "input": "pi",
  "sessionToken": "3519edfe-0f75-4a30-bfe4-7cbd89340b2c",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965
      },
      "radius": 500.0
    }
  }
}' -H 'Content-Type: application/json' -H "X-Goog-Api-Key: YOUR_API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

Phản hồi 2

{
  "suggestions": [
    {
      "placePrediction": {
        "place": "places/ChIJHSGzi_yAhYARnrPmDWAx9ro",
        "placeId": "ChIJHSGzi_yAhYARnrPmDWAx9ro",
        "text": {
          "text": "PIER 39, The Embarcadero, San Francisco, CA, USA",
          "matches": [
            {
              "endOffset": 2
            }
          ]
        },
        "structuredFormat": {
          "mainText": {
            "text": "PIER 39",
            "matches": [
              {
                "endOffset": 2
              }
            ]
          },
          "secondaryText": {
            "text": "The Embarcadero, San Francisco, CA, USA"
          }
        },
        "types": [
          "establishment",
          "point_of_interest",
          "shopping_mall",
          "marina",
          "historical_landmark",
          "tourist_attraction"
        ]
      }
    },
  /.../
  ]
}

Yêu cầu và phản hồi thứ ba

Yêu cầu 3

curl -X POST -d '{
  "input": "piz",
  "sessionToken": "3519edfe-0f75-4a30-bfe4-7cbd89340b2c",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965
      },
      "radius": 500.0
    }
  }
}' -H 'Content-Type: application/json' -H "X-Goog-Api-Key: YOUR_API_KEY" https://places.googleapis.com/v1/places:autocomplete

Phản hồi 3

{
  "suggestions": [
    {
      "placePrediction": {
        "place": "places/ChIJ_QJSSfGAhYARQVFJBNKy3HE",
        "placeId": "ChIJ_QJSSfGAhYARQVFJBNKy3HE",
        "text": {
          "text": "Pizza By The Slice, Grant Avenue, San Francisco, CA, USA",
          "matches": [
            {
              "endOffset": 3
            }
          ]
        },
        "structuredFormat": {
          "mainText": {
            "text": "Pizza By The Slice",
            "matches": [
              {
                "endOffset": 3
              }
            ]
          },
          "secondaryText": {
            "text": "Grant Avenue, San Francisco, CA, USA"
          }
        },
        "types": [
          "establishment",
          "point_of_interest",
          "food",
          "pizza_restaurant",
          "restaurant"
        ]
      }
    },
  /.../
  ]
}

Lưu ý: Bạn có thể sử dụng tham số inputOffset (không bắt buộc) để chỉ định vị trí của con trỏ vào trường nhập dữ liệu.

Kết thúc phiên

Chấm dứt phiên bằng cách yêu cầu Chi tiết địa điểm (Mới) hoặc Địa chỉ Xác thực và chuyển cùng một mã thông báo phiên mà bạn đã dùng cho tính năng Tự động hoàn thành Yêu cầu (Mới).

Tạo yêu cầu Chi tiết địa điểm (Mới)

Yêu cầu Chi tiết địa điểm (Mới) là yêu cầu HTTP GET. Để biết thêm thông tin về thông số nội dung yêu cầu, hãy xem yêu cầu Chi tiết địa điểm (Mới).

Yêu cầu Chi tiết địa điểm (Mới) sau đây bao gồm id và của địa điểm đã chọn sessionToken dùng trong các lệnh gọi Tự động hoàn thành (Mới) trước đây.

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
-H "X-Goog-FieldMask: id,displayName,accessibilityOptions,businessStatus" \
https://places.googleapis.com/v1/places/ChIJ_QJSSfGAhYARQVFJBNKy3HE?sessionToken=3519edfe-0f75-4a30-bfe4-7cbd89340b2c

Khi sử dụng một vị trí id trong ChIJ_QJSSfGAhYARQVFJBNKy3HE, lệnh gọi sẽ tạo phản hồi JSON sau:

{
  "id": "ChIJ_QJSSfGAhYARQVFJBNKy3HE",
  "businessStatus": "OPERATIONAL",
  "displayName": {
    "text": "Pizza By The Slice",
    "languageCode": "en"
  },
  "accessibilityOptions": {
    "wheelchairAccessibleParking": false,
    "wheelchairAccessibleEntrance": true
  }
}

Tạo yêu cầu Xác thực địa chỉ

Yêu cầu xác thực địa chỉ là yêu cầu POST qua HTTP. Thông tin khác về thông số nội dung yêu cầu, hãy xem Gửi yêu cầu xác thực địa chỉ.

Yêu cầu Xác thực địa chỉ dưới đây bao gồm địa chỉ của vị trí, có trong trường text của phản hồi Tự động hoàn thành (Mới) và sessionToken được dùng trong các lệnh gọi tự động hoàn thành (Mới) trước đây.

    curl -X POST -d '{
      "sessionToken": "3519edfe-0f75-4a30-bfe4-7cbd89340b2c",
      "address": {
        "addressLines": "Pizza By The Slice, Grant Avenue, San Francisco, CA, USA"
      }
    }' \
    -H 'Content-Type: application/json' \
    "https://addressvalidation.googleapis.com/v1:validateAddress?key=YOUR_API_KEY"

Lệnh gọi tạo ra phản hồi JSON sau đây:

    {
      "result": {
        "verdict": {
          "inputGranularity": "PREMISE",
          "validationGranularity": "PREMISE",
          "geocodeGranularity": "PREMISE",
          "hasInferredComponents": true
        },
        "address": {
          "formattedAddress": "Pizza By The Slice, Grant Avenue, San Francisco, CA 94133, USA",
          "postalAddress": {
            "regionCode": "US",
            "languageCode": "en",
            "postalCode": "94133",
            "administrativeArea": "CA",
            "locality": "San Francisco",
            "addressLines": [
              "Pizza By The Slice",
              "Grant Ave"
            ]
          },
          "addressComponents": [
            {
              "componentName": {
                "text": "Pizza By The Slice",
                "languageCode": "en"
              },
              "componentType": "point_of_interest",
              "confirmationLevel": "CONFIRMED"
            },
            {
              "componentName": {
                "text": "Grant Avenue",
                "languageCode": "en"
              },
              "componentType": "route",
              "confirmationLevel": "CONFIRMED"
            },
            {
              "componentName": {
                "text": "San Francisco",
                "languageCode": "en"
              },
              "componentType": "locality",
              "confirmationLevel": "CONFIRMED"
            },
            {
              "componentName": {
                "text": "CA",
                "languageCode": "en"
              },
              "componentType": "administrative_area_level_1",
              "confirmationLevel": "CONFIRMED"
            },
            {
              "componentName": {
                "text": "USA",
                "languageCode": "en"
              },
              "componentType": "country",
              "confirmationLevel": "CONFIRMED"
            },
            {
              "componentName": {
                "text": "94133"
              },
              "componentType": "postal_code",
              "confirmationLevel": "CONFIRMED",
              "inferred": true
            }
          ],
          "missingComponentTypes": [
            "street_number"
          ]
        },
        "geocode": {
          "location": {
            "latitude": 37.800504,
            "longitude": -122.4074794
          },
          "plusCode": {
            "globalCode": "849VRH2V+62"
          },
          "bounds": {
            "low": {
              "latitude": 37.800504,
              "longitude": -122.4074794
            },
            "high": {
              "latitude": 37.800504,
              "longitude": -122.4074794
            }
          },
          "featureSizeMeters": 10,
          "placeId": "ChIJ_QJSSfGAhYARQVFJBNKy3HE",
          "placeTypes": [
            "food",
            "restaurant",
            "point_of_interest",
            "establishment"
          ]
        },
        "uspsData": {
          "standardizedAddress": {
            "firstAddressLine": "PIZZA BY THE SLICE",
            "secondAddressLine": "GRANT AVE",
            "cityStateZipAddressLine": "SAN FRANCISCO",
            "city": "SAN FRANCISCO",
            "state": "CA",
            "zipCode": "94133"
          },
          "dpvFootnote": "A1M1",
          "postOfficeCity": "SAN FRANCISCO",
          "postOfficeState": "CA"
        }
      },
      "responseId": "4b669675-2c3b-463a-ae20-400248cf6ac9"
    }

Bỏ một phiên

Một phiên sẽ chấm dứt nếu người dùng rời khỏi phiên đó. Ví dụ: nếu người dùng bắt đầu tìm kiếm một cửa hàng pizza nhưng không chọn địa điểm (kích hoạt Cuộc gọi Chi tiết địa điểm (Mới) hoặc xác thực địa chỉ (kích hoạt một Địa chỉ xác thực), phiên kết thúc và mã thông báo phiên hết hạn.