ऑटोकंप्लीट (नई) सेवा एक ऐसी वेब सेवा है जो किसी एचटीटीपी अनुरोध के जवाब में, तय की गई जगह के हिसाब से सुझाव और क्वेरी का सुझाव देती है. अनुरोध में, ऐसी टेक्स्ट सर्च स्ट्रिंग और भौगोलिक सीमाएं डालें जो खोज के लिए इस्तेमाल होने वाले इलाके को कंट्रोल करती हों.
ऑटोकंप्लीट (नई) सेवा, इनपुट के पूरे शब्दों और सबस्ट्रिंग को मैच कर सकती है. साथ ही, जगहों के नाम, पते, और प्लस कोड को सही कर सकती है. इसलिए, ऐप्लिकेशन उपयोगकर्ता के टाइप के हिसाब से क्वेरी भेज सकते हैं, ताकि उन्हें तुरंत जगह और क्वेरी के लिए सुझाव दिए जा सकें.
ऑटोकंप्लीट (नया) एपीआई से मिलने वाले रिस्पॉन्स में दो तरह के अनुमान हो सकते हैं:
- जगह के लिए अनुमान: खास इनपुट टेक्स्ट स्ट्रिंग और खोज के इलाके के आधार पर जगहें, जैसे कि कारोबार, पते, और पसंदीदा जगहें. जगह के सुझाव डिफ़ॉल्ट रूप से दिखाए जाते हैं.
- क्वेरी के लिए अनुमान: इनपुट टेक्स्ट स्ट्रिंग और खोज के इलाके से मिलती-जुलती क्वेरी स्ट्रिंग. क्वेरी के लिए मिलने वाले सुझाव, डिफ़ॉल्ट रूप से नहीं दिखते. रिस्पॉन्स में क्वेरी के लिए अनुमान जोड़ने के लिए,
includeQueryPredictionsअनुरोध पैरामीटर का इस्तेमाल करें.
उदाहरण के लिए, एक ऐसी स्ट्रिंग को इनपुट के तौर पर इस्तेमाल करके एपीआई को कॉल किया जाता है जिसमें उपयोगकर्ता का कुछ ही इनपुट "सिसिलियन पिज़" होता है. इसमें खोज करने का इलाका सैन फ़्रांसिस्को, कैलिफ़ोर्निया तक सीमित है. इसके बाद, जवाब में जगह के अनुमान की एक सूची होती है, जो खोज स्ट्रिंग और खोज की जगह से मेल खाती है. उदाहरण के लिए, जगह की जानकारी के साथ "Sicilian Pizza Kitchen" नाम का रेस्टोरेंट.
दिखाई गई जगह के अनुमान इस तरह से डिज़ाइन किए जाते हैं कि उपयोगकर्ता को सही जगह चुनने में मदद मिले. दिखाई गई किसी भी जगह के लिए, उपलब्ध सुझावों के बारे में ज़्यादा जानकारी पाने के लिए, जगह की जानकारी (नया) का अनुरोध किया जा सकता है.
इस जवाब में क्वेरी के लिए अनुमानों की सूची भी शामिल हो सकती है जो खोज स्ट्रिंग और खोज के इलाके से मेल खाती है, जैसे कि "सिसिलियन पिज़्ज़ा और पास्ता". रिस्पॉन्स में, क्वेरी के हर अनुमान में एक text फ़ील्ड शामिल होता है. इस फ़ील्ड में, सुझाई गई टेक्स्ट सर्च स्ट्रिंग होती है. ज़्यादा जानकारी पाने के लिए, इस स्ट्रिंग को Text Search (नया) के इनपुट के तौर पर इस्तेमाल करें.
एपीआई एक्सप्लोरर की मदद से लाइव अनुरोध किए जा सकते हैं, ताकि आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिल सके:
इसे आज़माएं!ऑटोकंप्लीट की सुविधा (नए) अनुरोध
अपने-आप पूरा होने वाला (नया) अनुरोध, एक ऐसा एचटीटीपी पोस्ट अनुरोध होता है जो इस फ़ॉर्म में मौजूद यूआरएल के लिए होता है:
https://places.googleapis.com/v1/places:autocomplete
सभी पैरामीटर को JSON अनुरोध के मुख्य हिस्से या हेडर में, पोस्ट अनुरोध के हिस्से के तौर पर पास करें. उदाहरण के लिए:
curl -X POST -d '{
"input": "pizza",
"locationBias": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965
},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
जवाब के बारे में जानकारी
ऑटोकंप्लीट की सुविधा (नया) जवाब के तौर पर JSON ऑब्जेक्ट दिखाता है. जवाब में:
suggestionsकलेक्शन में, सभी अनुमानित जगहों और क्वेरी को क्रम में शामिल किया जाता है. ये इस आधार पर तय होते हैं कि वे कितने काम के हैं. हर जगह कोplacePredictionफ़ील्ड से दिखाया जाता है और हर क्वेरी कोqueryPredictionफ़ील्ड से दिखाया जाता है.placePredictionफ़ील्ड में, किसी एक जगह के अनुमान के बारे में पूरी जानकारी होती है. इसमें जगह का आईडी और टेक्स्ट की जानकारी भी शामिल होती है.queryPredictionफ़ील्ड में किसी एक क्वेरी के अनुमान के बारे में पूरी जानकारी होती है.
JSON ऑब्जेक्ट इस फ़ॉर्मैट में है:
{
"suggestions": [
{
"placePrediction": {
"place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
"placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
"text": {
"text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
"matches": [
{
"endOffset": 6
}]
},
...
},
{
"queryPrediction": {
"text": {
"text": "Amoeba Music",
"matches": [
{
"endOffset": 6
}]
},
...
}
...]
}
ज़रूरी पैरामीटर
-
इनपुट
वह टेक्स्ट स्ट्रिंग जिस पर खोजना है. पूरे शब्द और सबस्ट्रिंग, जगहों के नाम, पते, और प्लस कोड तय करें. ऑटोकंप्लीट (नई) सेवा, इस स्ट्रिंग के आधार पर कैंडिडेट के नतीजे दिखाती है और इस आधार पर नतीजे दिखाती है कि वे उपयोगकर्ताओं के लिए कितने काम के हैं.
ज़रूरी नहीं पैरामीटर
-
includedPrimaryTypes
किसी जगह का सिर्फ़ एक प्राइमरी टाइप, टेबल A या टेबल B में दिए गए टाइप में से एक हो सकता है. उदाहरण के लिए, प्राइमरी टाइप
"mexican_restaurant"या"steak_house"हो सकता है.डिफ़ॉल्ट रूप से, एपीआई
inputपैरामीटर के आधार पर सभी जगहों की जानकारी दिखाता है. भले ही, जगह से जुड़ी प्राइमरी टाइप की वैल्यू कुछ भी हो.includedPrimaryTypesपैरामीटर को पास करके, नतीजों को किसी खास तरह के प्राइमरी या प्राइमरी टाइप के लिए सीमित करें.टेबल A या टेबल B से ज़्यादा से ज़्यादा पांच टाइप वैल्यू तय करने के लिए, इस पैरामीटर का इस्तेमाल करें. जगह की जानकारी, रिस्पॉन्स में शामिल की जाने वाली मुख्य टाइप की वैल्यू में से किसी एक से मैच होनी चाहिए.
इसके बजाय, इस पैरामीटर में
(regions)या(cities)में से कोई एक शामिल भी हो सकता है. इलाकों और पिन कोड जैसे इलाकों या डिवीज़न के लिए,(regions)टाइप के कलेक्शन फ़िल्टर. जगहों के लिए(cities)टाइप कलेक्शन फ़िल्टर, जिन्हें Google शहर के तौर पर पहचानता है.अनुरोध को
INVALID_REQUESTगड़बड़ी के साथ अस्वीकार कर दिया जाता है, अगर:- पाँच से ज़्यादा प्रकार बताए गए हैं.
(cities)या(regions)के अलावा, कोई भी टाइप बताया जाता है.- कोई भी अज्ञात प्रकार दर्ज किया गया है.
-
includeQueryPredictions
अगर
trueहै, तो जवाब में जगह और क्वेरी के अनुमान, दोनों शामिल होते हैं. इसकी डिफ़ॉल्ट वैल्यूfalseहै. इसका मतलब है कि जवाब में सिर्फ़ जगहों के अनुमान शामिल होते हैं. -
includedRegionCodes
सिर्फ़ चुनिंदा इलाकों की सूची के नतीजों को शामिल करें. इसमें ज़्यादा से ज़्यादा 15 ccTLD ("टॉप-लेवल डोमेन") दो वर्णों वाली वैल्यू के कलेक्शन के तौर पर जानकारी दी गई है. अगर यह जवाब नहीं दिया जाता है, तो जवाब पर कोई पाबंदी नहीं होगी. उदाहरण के लिए, सिर्फ़ जर्मनी और फ़्रांस के इलाके देखने के लिए:
"includedRegionCodes": ["de", "fr"]अगर
locationRestrictionऔरincludedRegionCodes, दोनों की वैल्यू तय की जाती है, तो नतीजे इन दोनों सेटिंग के इंटरसेक्शन की जगह पर दिखेंगे. -
inputOffset
शून्य पर आधारित यूनिकोड वर्ण ऑफ़सेट,
inputमें कर्सर की जगह दिखाता है. कर्सर की जगह से यह तय होता है कि कौनसे सुझाव दिखाए जाएंगे. अगर खाली है, तो यह डिफ़ॉल्ट रूप सेinputकी लंबाई पर सेट होती है. -
languageCode
वह पसंदीदा भाषा जिसमें नतीजे देना है. अगर
inputमें इस्तेमाल की गई भाषा,languageCodeमें दी गई वैल्यू से अलग है या नतीजे में मिली जगह का स्थानीय भाषा सेlanguageCodeमें अनुवाद नहीं किया गया है, तो नतीजे अलग-अलग भाषाओं में हो सकते हैं.- पसंदीदा भाषा बताने के लिए, आपको आईईटीएफ़ BCP-47 भाषा कोड का इस्तेमाल करना होगा.
-
अगर
languageCodeनहीं दिया गया है, तो एपीआईAccept-Languageहेडर में बताई गई वैल्यू का इस्तेमाल करता है. अगर कोई भी तय नहीं किया गया है, तो डिफ़ॉल्ट तौर परenहोता है. अमान्य भाषा कोड डालने पर, एपीआईINVALID_ARGUMENTगड़बड़ी दिखाता है. - पसंदीदा भाषा का थोड़ा असर, नतीजों के उस सेट पर होता है जिसे एपीआई चुनता है. साथ ही, यह भी कि वे किस क्रम में दिखती हैं. इससे वर्तनी की गड़बड़ियां ठीक करने की एपीआई की क्षमता पर भी असर पड़ता है.
-
एपीआई, मोहल्ले का ऐसा पता देने की कोशिश करता है जिसे उपयोगकर्ता और
स्थानीय लोग आसानी से पढ़ सकें. साथ ही, वह उपयोगकर्ता से मिले इनपुट को भी दिखा सके. जगह के सुझावों का फ़ॉर्मैट अलग-अलग होता है. यह हर अनुरोध में उपयोगकर्ता के इनपुट के आधार पर होता है.
-
inputपैरामीटर में, मैच होने वाले शब्दों को सबसे पहले चुना जाता है. इसके लिए, उपलब्ध होने परlanguageCodeपैरामीटर से मिली भाषा की प्राथमिकता के हिसाब से नाम इस्तेमाल किए जाते हैं. अन्य मामलों में, यह ऐसे नामों का इस्तेमाल करता है जो उपयोगकर्ता के इनपुट से सबसे ज़्यादा मेल खाते हों. -
मोहल्ले के पतों को स्थानीय भाषा में फ़ॉर्मैट किया जाता है. यह ऐसी स्क्रिप्ट में होता है जिसे उपयोगकर्ता आसानी से पढ़ सकता है.
ऐसा तब ही किया जाता है, जब
inputपैरामीटर में दिए गए मिलते-जुलते शब्दों को चुना जाता है. -
बाकी सभी पतों को उनकी पसंदीदा भाषा में दिखाया जाता है. इसके लिए, मिलते-जुलते शब्दों को
inputपैरामीटर में मौजूद शब्दों से मैच करने का विकल्प चुना जाता है. अगर कोई नाम पसंदीदा भाषा में उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
-
LocationBias या जगह की जानकारी पर पाबंदी
खोज करने के इलाके के बारे में बताने के लिए,
locationBiasयाlocationRestrictionतय किया जा सकता है, लेकिन दोनों को नहीं.locationRestrictionके हिसाब से, वह क्षेत्र तय किया जा रहा है जिसमें नतीजे होने चाहिए. साथ ही,locationBiasका मतलब है कि वह क्षेत्र तय करना जिसमें नतीजे, इलाके के आस-पास होने चाहिए, लेकिन उसके बाहर भी हो सकते हैं.locationBias
यह बताता है कि किसी इलाके को किस इलाके में खोजा जाना है. इस जगह की जानकारी पूर्वाग्रह के तौर पर दिखाई जाती है. इसका मतलब है कि बताई गई जगह के आस-पास के नतीजे दिखाए जा सकते हैं. इनमें, ऐसी जगह से बाहर के नतीजे भी शामिल हैं.
locationRestriction
यह बताता है कि किसी इलाके को किस इलाके में खोजा जाना है. चुने गए इलाके से बाहर के नतीजे नहीं दिखाए जाते.
locationBiasयाlocationRestrictionइलाके को आयताकार व्यूपोर्ट या सर्कल के तौर पर बताएं.सर्कल को सेंटर पॉइंट और मीटर में रेडियस से तय किया जाता है. दायरा 0.0 से 50, 000.0 के बीच होना चाहिए. डिफ़ॉल्ट वैल्यू 0.0 है.
locationRestrictionके लिए, आपको दायरा 0.0 से ज़्यादा पर सेट करना होगा. ऐसा न करने पर, अनुरोध का कोई नतीजा नहीं मिलता.उदाहरण के लिए:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }रेक्टैंगल, अक्षांश-देशांतर का व्यूपोर्ट होता है. इसे
lowऔर हाई पॉइंट की दिशा में दो तिरछे तरीके से दिखाया जाता है. व्यूपोर्ट को क्लोज़्ड क्षेत्र माना जाता है. इसका मतलब है कि इसकी सीमा शामिल होती है. अक्षांश की सीमाएं -90 से 90 डिग्री के बीच होनी चाहिए, और देशांतर की सीमाएं -180 से 180 डिग्री के बीच होनी चाहिए, जिसमें ये भी शामिल हैं:- अगर
low=highहै, तो व्यूपोर्ट में वह सिंगल पॉइंट होता है. - अगर
low.longitude>high.longitudeहै, तो देशांतर की रेंज उलटी हो जाती है (व्यूपोर्ट 180 डिग्री देशांतर लाइन को पार करता है). - अगर
low.longitude= -180 डिग्री औरhigh.longitude= 180 डिग्री है, तो व्यूपोर्ट में सभी देशांतर शामिल होते हैं. - अगर
low.longitude= 180 डिग्री औरhigh.longitude= -180 डिग्री है, तो देशांतर की रेंज खाली होगी.
lowऔरhigh, दोनों में जानकारी भरी जानी चाहिए. साथ ही, दिखाया गया बॉक्स खाली नहीं छोड़ा जा सकता. व्यूपोर्ट का खाली होने पर गड़बड़ी होती है.उदाहरण के लिए, यह व्यूपोर्ट न्यूयॉर्क शहर को पूरी तरह से घेरता है:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }- अगर
-
origin
वह मूल बिंदु जहां से मंज़िल के लिए सीधी-लाइन की दूरी की गणना करनी है (
distanceMetersके रूप में दिखाई जाती है). अगर यह मान छोड़ा जाता है, तो सीधी रेखा की दूरी नहीं दिखाई जाएगी. अक्षांश और देशांतर निर्देशांक के हिसाब से होने चाहिए:"origin": { "latitude": 40.477398, "longitude": -74.259087 } -
regionCode
जवाब को फ़ॉर्मैट करने के लिए इस्तेमाल किया जाने वाला क्षेत्रीय कोड, जिसे ccTLD ("टॉप-लेवल डोमेन") के तौर पर दो वर्णों की वैल्यू के तौर पर बताया गया है. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड के जैसे होते हैं. हालांकि, इसमें कुछ खास अपवाद भी हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन और नॉर्दन आयरलैंड की इकाई के लिए इसका इस्तेमाल किया जा सकता है.
किसी जगह का अमान्य कोड डालने पर, एपीआई
INVALID_ARGUMENTगड़बड़ी दिखाता है. पैरामीटर, लागू कानून के आधार पर नतीजों पर असर डाल सकता है. -
sessionToken
सेशन टोकन, उपयोगकर्ता की जनरेट की गई ऐसी स्ट्रिंग होती हैं जो ऑटोकंप्लीट की सुविधा (नए) कॉल को "सेशन" के तौर पर ट्रैक करती हैं. ऑटोकंप्लीट (नया) सुविधा, बिलिंग के मकसद से, उपयोगकर्ता ऑटोकंप्लीट खोज की क्वेरी और उसे चुनने के चरणों को अलग-अलग सेशन में ग्रुप करने के लिए सेशन टोकन का इस्तेमाल करती है. ज़्यादा जानकारी के लिए, सेशन टोकन देखें.
ऑटोकंप्लीट की सुविधा (नए) के उदाहरण
जगह की पाबंदी और locationBias का इस्तेमाल करें
एपीआई, खोज वाली जगह को कंट्रोल करने के लिए डिफ़ॉल्ट रूप से आईपी बायसिंग का इस्तेमाल करता है. आईपी बायसिंग के तहत, एपीआई डिवाइस के आईपी पते का इस्तेमाल करके नतीजों को तय करता है. खोजने के लिए कोई इलाका बताने के लिए, आपके पास locationRestriction या locationBias का इस्तेमाल करने का भी विकल्प है. हालांकि, दोनों का इस्तेमाल नहीं किया जा सकता.
locationRestriction, खोजे जाने वाले हिस्से के बारे में बताता है. चुने गए इलाके से बाहर के नतीजे नहीं दिखाए जाते. यहां दिए गए उदाहरण में, locationRestriction का इस्तेमाल करके अनुरोध को सैन फ़्रांसिस्को के दायरे में 5,000 मीटर के दायरे तक सीमित किया गया है:
curl -X POST -d '{
"input": "Amoeba",
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7749,
"longitude": -122.4194
},
"radius": 5000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
तय की गई जगहों से जुड़े सभी नतीजे, suggestions कलेक्शन में शामिल होते हैं:
{
"suggestions": [
{
"placePrediction": {
"place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
"placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
"text": {
"text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
"matches": [
{
"endOffset": 6
}
]
},
"structuredFormat": {
"mainText": {
"text": "Amoeba Music",
"matches": [
{
"endOffset": 6
}
]
},
"secondaryText": {
"text": "Haight Street, San Francisco, CA, USA"
}
},
"types": [
"home_goods_store",
"establishment",
"store",
"point_of_interest",
"electronics_store"
]
}
}
]
}
locationBias के साथ, जगह की जानकारी पूर्वाग्रह की तरह काम करती है. इसका मतलब है कि बताई गई जगह के आस-पास के नतीजे दिखाए जा सकते हैं. इनमें, बताई गई जगह से बाहर के नतीजे भी शामिल हैं. अगले उदाहरण में, आपको locationBias का इस्तेमाल करने का अनुरोध बदलना है:
curl -X POST -d '{
"input": "Amoeba",
"locationBias": {
"circle": {
"center": {
"latitude": 37.7749,
"longitude": -122.4194
},
"radius": 5000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
नतीजों में अब कई और आइटम शामिल हैं. इनमें 5000 मीटर के दायरे से बाहर के नतीजे भी शामिल हैं:
{
"suggestions": [
{
"placePrediction": {
"place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
"placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
"text": {
"text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
"matches": [
{
"endOffset": 6
}
]
},
"structuredFormat": {
"mainText": {
"text": "Amoeba Music",
"matches": [
{
"endOffset": 6
}
]
},
"secondaryText": {
"text": "Haight Street, San Francisco, CA, USA"
}
},
"types": [
"electronics_store",
"point_of_interest",
"store",
"establishment",
"home_goods_store"
]
}
},
{
"placePrediction": {
"place": "places/ChIJr7uwwy58hYARBY-e7-QVwqw",
"placeId": "ChIJr7uwwy58hYARBY-e7-QVwqw",
"text": {
"text": "Amoeba Music, Telegraph Avenue, Berkeley, CA, USA",
"matches": [
{
"endOffset": 6
}
]
},
"structuredFormat": {
"mainText": {
"text": "Amoeba Music",
"matches": [
{
"endOffset": 6
}
]
},
"secondaryText": {
"text": "Telegraph Avenue, Berkeley, CA, USA"
}
},
"types": [
"electronics_store",
"point_of_interest",
"establishment",
"home_goods_store",
"store"
]
}
},
...
]
}
शामिल किए गएprimaryTypes का इस्तेमाल करें
includedPrimaryTypes पैरामीटर का इस्तेमाल करके,
टेबल A,
टेबल B
या सिर्फ़ (regions) या सिर्फ़ (cities) से
पांच टाइप की वैल्यू तय करें. जवाब में शामिल करने के लिए, जगह की जानकारी इनमें से किसी एक प्राइमरी टाइप की वैल्यू से मेल खानी चाहिए.
इस उदाहरण में, "सॉकर" की एक input स्ट्रिंग तय की गई है और "sporting_goods_store" टाइप की संस्थाओं तक नतीजों को सीमित करने के लिए, includedPrimaryTypes पैरामीटर का इस्तेमाल किया गया है:
curl -X POST -d '{
"input": "Soccer",
"includedPrimaryTypes": ["sporting_goods_store"],
"locationBias": {
"circle": {
"center": {
"latitude": 37.7749,
"longitude": -122.4194
},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
अगर includedPrimaryTypes पैरामीटर को छोड़ दिया जाता है, तो नतीजों में उस टाइप के ऐसे आकलन शामिल हो सकते हैं जिन्हें आपको नहीं चाहिए, जैसे कि "athletic_field".
क्वेरी के अनुमानों के लिए अनुरोध करें
क्वेरी के लिए मिलने वाले सुझाव, डिफ़ॉल्ट रूप से नहीं दिखते. रिस्पॉन्स में क्वेरी से जुड़े अनुमान जोड़ने के लिए, includeQueryPredictions अनुरोध पैरामीटर का इस्तेमाल करें. उदाहरण के लिए:
curl -X POST -d '{
"input": "Amoeba",
"includeQueryPredictions": true,
"locationBias": {
"circle": {
"center": {
"latitude": 37.7749,
"longitude": -122.4194
},
"radius": 5000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
suggestions कलेक्शन में अब जगह के बारे में अनुमान और क्वेरी के अनुमान, दोनों शामिल हैं.
जैसा कि ऊपर जवाब के बारे में जानकारी में दिखाया गया है. हर क्वेरी के अनुमान में, सुझाई गई टेक्स्ट सर्च स्ट्रिंग वाला text फ़ील्ड शामिल होता है. हालांकि, टेक्स्ट खोज (नया) का अनुरोध करके, दिखाई गई किसी भी क्वेरी के सुझाव के बारे में ज़्यादा जानकारी पाई जा सकती है.
ऑरिजिन का इस्तेमाल करें
इस उदाहरण में, origin को अनुरोध में अक्षांश और देशांतर निर्देशांक के तौर पर शामिल करें.
origin को शामिल करने पर, एपीआई के distanceMeters फ़ील्ड को रिस्पॉन्स में शामिल किया जाता है. इसमें origin से डेस्टिनेशन तक की सीधी लाइन की दूरी होती है.
यह उदाहरण मूल को सैन फ़्रांसिस्को के केंद्र पर सेट करता है:
curl -X POST -d '{
"input": "Amoeba",
"origin": {
"latitude": 37.7749,
"longitude": -122.4194
},
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7749,
"longitude": -122.4194
},
"radius": 5000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
जवाब में अब distanceMeters शामिल है:
{
"suggestions": [
{
"placePrediction": {
"place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
"placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
"text": {
"text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
"matches": [
{
"endOffset": 6
}
]
},
"structuredFormat": {
"mainText": {
"text": "Amoeba Music",
"matches": [
{
"endOffset": 6
}
]
},
"secondaryText": {
"text": "Haight Street, San Francisco, CA, USA"
}
},
"types": [
"home_goods_store",
"establishment",
"point_of_interest",
"store",
"electronics_store"
],
"distanceMeters": 3012
}
}
]
}
इसे आज़माएं!
एपीआई एक्सप्लोरर से आपको सैंपल के तौर पर अनुरोध करने की सुविधा मिलती है. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.
- पेज के दाईं ओर मौजूद, एपीआई आइकॉन
को चुनें. - विकल्प के तौर पर, स्टैंडर्ड पैरामीटर दिखाएं को बड़ा करें और
fieldsपैरामीटर को फ़ील्ड मास्क पर सेट करें. - विकल्प के तौर पर, अनुरोध के मुख्य हिस्से में बदलाव करें.
- लागू करें बटन चुनें. पॉप-अप में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, 'बड़ा करें' आइकॉन
चुनें.