यह प्रॉडक्ट या सुविधा, झलक (Pre-GA) के तौर पर उपलब्ध है. ऐसा हो सकता है कि Pre-GA प्रॉडक्ट और सुविधाएं पूरी तरह काम न करें. साथ ही, हो सकता है कि Pre-GA प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA वाले अन्य वर्शन के साथ काम न करें. Pre-GA ऑफ़र पर Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरण की जानकारी देखें.

सेशन टोकन इस्तेमाल करना

सेशन टोकन, उपयोगकर्ता की अपने-आप पूरे होने वाली खोज की क्वेरी और चुनने के फ़ेज़ को एक ग्रुप में बांट देते हैं, ताकि बिलिंग के मकसद से अलग-अलग सेशन में खोज की जा सके. नीचे दिए गए उदाहरण में बताया गया है कि ऑटोकंप्लीट (नया) और जगह की जानकारी (नया) कॉल में सेशन टोकन के इस्तेमाल का तरीका कैसे बताया जाता है.

सेशन का टोकन बनाना

हर सेशन के लिए यूनीक सेशन टोकन जनरेट करने की ज़िम्मेदारी उपयोगकर्ताओं की होती है. Google, वर्शन 4 यूयूआईडी इस्तेमाल करने का सुझाव देता है.

ध्यान दें: सेशन टोकन, Google Cloud Console के सभी प्रोजेक्ट में ओवरलैप हो सकते हैं. हालांकि, हर प्रोजेक्ट के लिए ये टोकन अलग-अलग होने चाहिए. उदाहरण के लिए, प्रोजेक्ट A का इस्तेमाल करने वाला ऐप्लिकेशन और प्रोजेक्ट B का इस्तेमाल करने वाला ऐप्लिकेशन एक ही सेशन टोकन का इस्तेमाल कर सकता है. हालांकि, प्रोजेक्ट A का इस्तेमाल करने वाले कई ऐप्लिकेशन एक ही सेशन टोकन का इस्तेमाल नहीं कर सकते.

ऑटोकंप्लीट (नया) अनुरोध करें

ऑटोकंप्लीट (नया) अनुरोध एक एचटीटीपी पोस्ट अनुरोध है. अनुरोध के मुख्य भाग के पैरामीटर के बारे में ज़्यादा जानकारी के लिए, जगह ऑटोकंप्लीट (नया) अनुरोध देखें.

नीचे दिए गए अनुरोधों की सीरीज़ में एक उपयोगकर्ता को सैन फ़्रांसिस्को में पिज़्ज़ा की दुकान खोजने वाला दिखाया गया है. जैसे ही उपयोगकर्ता किसी क्वेरी को टाइप करना शुरू करता है, हर कीस्ट्रोक के लिए ऑटोकंप्लीट (नया) को कॉल किया जाता है. जनरेट किया गया सेशन टोकन, हर कॉल में पैरामीटर के तौर पर पास किया जाता है.

पहला अनुरोध और जवाब

अनुरोध 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

जवाब 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"
        ]
      }
    },
  ]
   / ... /
}

दूसरा अनुरोध और जवाब

अनुरोध 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

जवाब 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"
        ]
      }
    },
  /.../
  ]
}

तीसरा अनुरोध और जवाब

अनुरोध 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

जवाब 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"
        ]
      }
    },
  /.../
  ]
}

ध्यान दें: इनपुट फ़ील्ड में कर्सर की जगह तय करने के लिए, वैकल्पिक inputOffset पैरामीटर का इस्तेमाल किया जा सकता है.

सेशन खत्म करें

जगह की जानकारी (नया) या पते की पुष्टि का अनुरोध करके, सेशन को खत्म करें और उसी सेशन टोकन को पास करें जिसका इस्तेमाल आपने ऑटोकंप्लीट (नया) अनुरोधों के लिए किया था.

जगह की जानकारी (नया) पाने का अनुरोध करें

जगह की जानकारी (नया) अनुरोध, एक एचटीटीपी जीईटी अनुरोध है. अनुरोध वाले बॉडी पैरामीटर के बारे में ज़्यादा जानकारी के लिए, जगह की जानकारी (नया) के अनुरोध देखें.

जगह की जानकारी (नए) के नीचे दिए गए अनुरोध में, चुनी गई जगह के id और पिछले ऑटोकंप्लीट (नए) कॉल में इस्तेमाल किए गए sessionToken शामिल हैं.

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

ChIJ_QJSSfGAhYARQVFJBNKy3HE में से id जगह का इस्तेमाल करके, कॉल यह JSON रिस्पॉन्स जनरेट करता है:

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

पते की पुष्टि करने का अनुरोध करें

पते की पुष्टि करने का अनुरोध, एचटीटीपी पोस्ट करने का अनुरोध होता है. अनुरोध वाले मुख्य हिस्से के पैरामीटर के बारे में ज़्यादा जानकारी के लिए, पते की पुष्टि करने का अनुरोध भेजना लेख पढ़ें.

पते की पुष्टि के नीचे दिए गए अनुरोध में, चुनी गई जगह का पता शामिल होता है. यह पता, ऑटोकंप्लीट (नया) रिस्पॉन्स के text फ़ील्ड में मौजूद होता है. साथ ही, इसमें पिछले ऑटोकंप्लीट (नए) कॉल में इस्तेमाल किया गया sessionToken भी शामिल होता है.

    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"

कॉल, इस तरह का 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"
    }

सत्र को छोड़ें

अगर उपयोगकर्ता सेशन को छोड़ देता है, तो सेशन खत्म हो जाता है. उदाहरण के लिए, अगर कोई उपयोगकर्ता पिज़्ज़ा की दुकान खोजना शुरू करता है, लेकिन कोई जगह नहीं चुनता है (जगह की जानकारी (नया) कॉल ट्रिगर करते हुए) या पते की पुष्टि नहीं करता है (पते की पुष्टि करने वाला कॉल ट्रिगर करता है), तो सेशन खत्म हो जाता है और सेशन टोकन खत्म हो जाता है.