Korzystanie z tokenów sesji
Tokeny sesji grupują fazy zapytania i wyboru użytkownika autouzupełniania w dyskretnej sesji na potrzeby rozliczeń. Poniższe przykłady pokazują, Jak używać tokenów sesji w połączeniach autouzupełniania (nowych) i informacji o miejscu (nowych).
Tworzenie tokena sesji
Użytkownicy są odpowiedzialni za generowanie unikalnych tokenów sesji dla każdej sesji. Google zaleca używanie identyfikatorów UUID w wersji 4.
Przesyłanie nowego żądania autouzupełniania
Nowe (nowe) żądanie autouzupełniania to żądanie HTTP POST. Więcej informacji o parametrach treści żądania zapoznaj się z artykułem na temat żądań autouzupełniania miejsc (nowych).
Następujące serie żądań pokazują, że użytkownik szuka pizzerii w Warszawie Francisca. Gdy użytkownik zaczyna wpisywać zapytanie, wywoływane jest autouzupełnianie (Nowe) dla argumentu po naciśnięciu klawisza. Wygenerowany token sesji jest przekazywany jako parametr w każdym .
Pierwsze żądanie i odpowiedź
Prośba 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
Odpowiedź 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"
]
}
},
]
/ ... /
}
Drugie żądanie i odpowiedź
Prośba 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
Odpowiedź 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"
]
}
},
/.../
]
}
Trzecie żądanie i odpowiedź
Prośba 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
Odpowiedź 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"
]
}
},
/.../
]
}
Zakończ sesję
Zakończ sesję, wysyłając prośbę o podanie informacji o miejscu (nowych) lub adresu weryfikację i przekazywanie tego samego tokena sesji, który został użyty w przypadku autouzupełniania; (Nowe) żądania.
Prześlij prośbę o szczegóły miejsca (nową)
Żądanie dotyczące informacji o miejscu (nowe) to żądanie HTTP GET. Więcej informacji na temat: parametrów treści żądania, patrz sekcja Szczegóły miejsca (nowe).
Następująca prośba o informacje (Nowe) zawiera następujące dane: id i
sessionToken użyte w poprzednich wywołaniach autouzupełniania (nowych).
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
Używając miejsca id z ChIJ_QJSSfGAhYARQVFJBNKy3HE, wywołanie generuje
tę odpowiedź JSON:
{
"id": "ChIJ_QJSSfGAhYARQVFJBNKy3HE",
"businessStatus": "OPERATIONAL",
"displayName": {
"text": "Pizza By The Slice",
"languageCode": "en"
},
"accessibilityOptions": {
"wheelchairAccessibleParking": false,
"wheelchairAccessibleEntrance": true
}
}
Prześlij prośbę o weryfikację adresu
Żądanie weryfikacji adresu to żądanie HTTP POST. Więcej informacji o parametrach treści żądania przeczytaj artykuł Wysyłanie prośby o weryfikację adresu.
Poniższa prośba o weryfikację adresu zawiera adres wybranego można znaleźć w polutext w odpowiedzi autouzupełniania (nowa), a dodatkowo
sessionToken użyte w poprzednich wywołaniach autouzupełniania (nowych).
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"
Wywołanie generuje następującą odpowiedź JSON:
{
"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"
}
Porzucenie sesji
Sesja dobiega końca, gdy użytkownik ją porzuci. Jeśli na przykład użytkownik zaczyna szukać pizzerii, ale nie wybiera miejsca (powoduje wyświetlenie reklamy połączenia do informacji o miejscu (nowym) lub weryfikacji adresu (wywołania adresu). wywołanie walidacyjne), sesja zostanie zakończona, a jej token wygaśnie.