- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- LocationBias
- LocationRestriction
- सुझाव
- PlacePrediction
- FormattableText
- StringRange
- StructuredFormat
- QueryPrediction
दिए गए इनपुट के लिए सुझाव दिखाता है.
एचटीटीपी अनुरोध
POST https://places.googleapis.com/v1/places:autocomplete
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "input": string, "locationBias": { object ( |
फ़ील्ड | |
---|---|
input |
ज़रूरी है. वह टेक्स्ट स्ट्रिंग जिस पर खोजना है. |
locationBias |
ज़रूरी नहीं. चुनी गई जगह के लिए पक्षपातपूर्ण होता है.
|
locationRestriction |
ज़रूरी नहीं. नतीजों को किसी खास जगह पर सीमित करें.
|
includedPrimaryTypes[] |
ज़रूरी नहीं. इसमें, जगह के टाइप (https://developers.google.com/maps/documentation/places/web-service/place-types) या सिर्फ़ (क्षेत्रों) या सिर्फ़ (शहरों) में, टेबल A या टेबल B से "रेस्टोरेंट" या "gas_station") शामिल होता है. किसी स्थान को केवल तभी लौटाया जाता है, जब उसका प्राथमिक प्रकार इस सूची में शामिल होता है. ज़्यादा से ज़्यादा पांच वैल्यू दी जा सकती हैं. अगर कोई टाइप तय नहीं किया गया है, तो सभी तरह की जगहें दिखाई जाती हैं. |
includedRegionCodes[] |
ज़रूरी नहीं. सिर्फ़ बताए गए क्षेत्रों में नतीजे शामिल करें. इन कोड में ज़्यादा से ज़्यादा 15 CLDR दो वर्ण वाले क्षेत्र कोड डालें. किसी खाली सेट से नतीजों पर पाबंदी नहीं होगी. अगर |
languageCode |
ज़रूरी नहीं. वह भाषा जिसमें नतीजे देने हैं. डिफ़ॉल्ट तौर पर यह en-US पर सेट होता है. अगर |
regionCode |
ज़रूरी नहीं. क्षेत्र का कोड, जिसे CLDR दो वर्णों वाले क्षेत्र के कोड के तौर पर दिखाया जाता है. इससे पते के फ़ॉर्मैट और नतीजों की रैंकिंग पर असर पड़ता है. साथ ही, नतीजों के दिखने पर भी असर पड़ सकता है. इससे, बताए गए क्षेत्र के लिए नतीजे सीमित नहीं होते. किसी क्षेत्र के लिए नतीजों पर पाबंदी लगाने के लिए, |
origin |
ज़रूरी नहीं. वह मूल बिंदु जहां से मंज़िल के लिए जियोडेसिक दूरी की गणना की जाती है ( |
inputOffset |
ज़रूरी नहीं. अगर इस एट्रिब्यूट की वैल्यू खाली है, तो इसकी डिफ़ॉल्ट वैल्यू |
includeQueryPredictions |
ज़रूरी नहीं. अगर सही है, तो जवाब में जगह और क्वेरी, दोनों के अनुमान शामिल होंगे. अगर ऐसा नहीं होता है, तो जवाब में सिर्फ़ जगह के लिए सुझाव दिखाए जाएंगे. |
sessionToken |
ज़रूरी नहीं. इस स्ट्रिंग की मदद से बिलिंग के लिए, ऑटोकंप्लीट की सुविधा वाले सेशन की पहचान की जाती है. यूआरएल और फ़ाइल नाम के लिए सुरक्षित base64 स्ट्रिंग होनी चाहिए, जिसमें ज़्यादा से ज़्यादा 36 ASCII वर्ण हों. अन्यथा एक INVALID_LAMBDA गड़बड़ी दिखाई जाती है. सेशन तब शुरू होता है, जब उपयोगकर्ता क्वेरी टाइप करना शुरू करता है और किसी जगह को चुनने के बाद खत्म होता है. इसके बाद, जगह की जानकारी या पते की पुष्टि करने के लिए कॉल किया जाता है. हर सेशन में एक से ज़्यादा क्वेरी हो सकती हैं. इसके बाद, एक जगह की जानकारी या पते की पुष्टि का अनुरोध किया जा सकता है. किसी सेशन में हर अनुरोध के लिए इस्तेमाल किए जाने वाले क्रेडेंशियल, एक ही Google Cloud Console प्रोजेक्ट से जुड़े होने चाहिए. सेशन खत्म होने के बाद, टोकन मान्य नहीं रहता. आपके ऐप्लिकेशन को हर सेशन के लिए नया टोकन जनरेट करना होगा. अगर हमारा सुझाव है कि आप ये दिशा-निर्देश इस्तेमाल करें:
|
जवाब का मुख्य भाग
places.autocomplete के लिए रिस्पॉन्स प्रोटो.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"suggestions": [
{
object ( |
फ़ील्ड | |
---|---|
suggestions[] |
इसमें सुझावों की सूची होती है. इस सूची को, काम के घटते क्रम में लगाया जाता है. |
LocationBias
खोजी जाने वाली जगह. बताए गए क्षेत्र के लिए परिणाम पक्षपातपूर्ण हो सकते हैं.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
rectangle |
उत्तर-पूर्व और दक्षिण-पश्चिम कोने के हिसाब से तय किया गया व्यूपोर्ट. |
circle |
केंद्र बिंदु और त्रिज्या से तय किया गया वृत्त. |
LocationRestriction
खोजी जाने वाली जगह. नतीजे, बताए गए क्षेत्र के लिए ही सीमित होंगे.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
rectangle |
उत्तर-पूर्व और दक्षिण-पश्चिम कोने के हिसाब से तय किया गया व्यूपोर्ट. |
circle |
केंद्र बिंदु और त्रिज्या से तय किया गया वृत्त. |
सुझाव
अपने-आप पूरा होने वाले सुझाव का नतीजा.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
placePrediction |
किसी जगह के लिए सुझाव. |
queryPrediction |
किसी क्वेरी के लिए सुझाव. |
PlacePrediction
किसी स्थान के लिए ऑटोकंप्लीट सुविधा की मदद से मिलने वाले सुझाव के लिए अनुमान.
जेएसओएन के काेड में दिखाना |
---|
{ "place": string, "placeId": string, "text": { object ( |
फ़ील्ड | |
---|---|
place |
सुझाई गई जगह का संसाधन नाम. इस नाम का इस्तेमाल, उन एपीआई में किया जा सकता है जो जगहों के नाम स्वीकार करते हैं. |
placeId |
सुझाई गई जगह का यूनीक आइडेंटिफ़ायर. इस आइडेंटिफ़ायर का इस्तेमाल, जगह के आईडी स्वीकार करने वाले अन्य एपीआई में किया जा सकता है. |
text |
इसमें लौटाए गए नतीजे के लिए ऐसा नाम होता है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. आम तौर पर, कारोबार की जगहों के नतीजों के लिए, यह कारोबार का नाम और पता होता है. उन डेवलपर को यह टेक्स्ट places.get से मिले अगर अनुरोध |
structuredFormat |
मुख्य जानकारी में जगह के अनुमान का ब्रेकडाउन, जिसमें जगह का नाम और सेकंडरी टेक्स्ट शामिल है. इसमें, साफ़ तौर पर जानकारी देने वाली अन्य सुविधाएं शामिल हैं (जैसे, कोई शहर या इलाका).
|
types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types में टेबल A या टेबल B से इस जगह पर लागू होने वाले टाइप की सूची. टाइप, किसी जगह की कैटगरी है. शेयर किए गए टाइप वाली जगहों की विशेषताएं एक जैसी होंगी. |
distanceMeters |
अगर |
FormattableText
जगह या क्वेरी के अनुमान को दिखाने वाला टेक्स्ट. टेक्स्ट को ऐसे ही इस्तेमाल किया जा सकता है या फ़ॉर्मैट किया गया है.
जेएसओएन के काेड में दिखाना |
---|
{
"text": string,
"matches": [
{
object ( |
फ़ील्ड | |
---|---|
text |
वह टेक्स्ट जिसे |
matches[] |
स्ट्रिंग रेंज की सूची, जिससे पता चलता है कि ये वैल्यू |
StringRange
दिए गए टेक्स्ट में सबस्ट्रिंग की पहचान करता है.
जेएसओएन के काेड में दिखाना |
---|
{ "startOffset": integer, "endOffset": integer } |
फ़ील्ड | |
---|---|
startOffset |
स्ट्रिंग के पहले यूनिकोड वर्ण का शून्य-आधारित ऑफ़सेट (शामिल है). |
endOffset |
आखिरी यूनिकोड वर्ण का शून्य-आधारित ऑफ़सेट (खास तौर पर). |
StructuredFormat
इसमें, जगह या क्वेरी के लिए किए गए सुझाव को मुख्य टेक्स्ट और सेकंडरी टेक्स्ट में बांटा गया है.
जगह के अनुमान के लिए, मुख्य टेक्स्ट में जगह का खास नाम होता है. क्वेरी के सुझावों के लिए, मुख्य टेक्स्ट में क्वेरी मौजूद होती है.
दूसरे टेक्स्ट में, जगह की पहचान को और बेहतर बनाने या क्वेरी को बेहतर बनाने के लिए, साफ़ तौर पर जानकारी देने वाली अतिरिक्त सुविधाएं (जैसे, शहर या इलाका) शामिल की गई हैं.
जेएसओएन के काेड में दिखाना |
---|
{ "mainText": { object ( |
फ़ील्ड | |
---|---|
mainText |
इससे जगह या क्वेरी का नाम पता चलता है. |
secondaryText |
ज़्यादा साफ़ तौर पर जानकारी देने वाली सुविधाएं दिखाता है (जैसे कि शहर या इलाका). इससे जगह की पहचान को बेहतर तरीके से समझा जा सकता है या क्वेरी को बेहतर बनाया जा सकता है. |
QueryPrediction
क्वेरी के अपने-आप पूरे होने की सुविधा के लिए अनुमान के नतीजे.
जेएसओएन के काेड में दिखाना |
---|
{ "text": { object ( |
फ़ील्ड | |
---|---|
text |
अनुमानित टेक्स्ट. यह टेक्स्ट किसी जगह के बारे में नहीं बताता. यह एक ऐसी टेक्स्ट क्वेरी है जिसे सर्च एंडपॉइंट में इस्तेमाल किया जा सकता है (उदाहरण के लिए, टेक्स्ट सर्च). उन डेवलपर को अगर अनुरोध |
structuredFormat |
यह क्वेरी के अनुमान को क्वेरी के मुख्य टेक्स्ट में बांटता है. इसके अलावा, ऐसे सेकंडरी टेक्स्ट का इस्तेमाल करता है जिसमें क्वेरी के बारे में साफ़ तौर पर जानकारी दी गई हो. जैसे, कोई शहर या इलाका.
|