- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- RankPreference
- LocationBias
- LocationRestriction
- EVOptions
- ContextualContent
- वजह
- ReviewJustification
- HighlightedText
- HighlightedTextRange
- BusinessAvailabilityAttributesJustification
टेक्स्ट क्वेरी के आधार पर जगह की खोज.
एचटीटीपी अनुरोध
POST https://places.googleapis.com/v1/places:searchText
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
JSON के काेड में दिखाना |
---|
{ "textQuery": string, "languageCode": string, "regionCode": string, "rankPreference": enum ( |
फ़ील्ड | |
---|---|
textQuery |
ज़रूरी है. टेक्स्ट वाली खोज के लिए टेक्स्ट क्वेरी. |
languageCode |
जगह की जानकारी, उपलब्ध होने पर पसंदीदा भाषा में दिखाई जाएगी. अगर भाषा कोड के बारे में जानकारी नहीं है या जानकारी मौजूद नहीं है, तो किसी भी भाषा की जानकारी देने के लिए, उसे अंग्रेज़ी भाषा के लिए प्राथमिकता दी जा सकती है. हालांकि, ऐसा सिर्फ़ तब होगा, जब ऐसी जानकारी मौजूद हो. इस्तेमाल की जा सकने वाली भाषाओं की मौजूदा सूची: https://developers.google.com/maps/faq#languagesupport. |
regionCode |
उस जगह का यूनिकोड देश/क्षेत्र कोड (CLDR) जहां से अनुरोध किया जा रहा है. इस पैरामीटर का इस्तेमाल, जगह की जानकारी दिखाने के लिए किया जाता है. जैसे, किसी इलाके के लिए जगह का नाम (अगर उपलब्ध है). पैरामीटर, लागू कानून के आधार पर नतीजों पर असर डाल सकता है. ज़्यादा जानकारी के लिए, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html देखें. ध्यान दें कि फ़िलहाल, तीन अंकों वाले इलाके के कोड इस्तेमाल नहीं किए जा सकते. |
rankPreference |
जवाब में नतीजों को कैसे रैंक किया जाएगा. |
includedType |
अनुरोध की गई जगह का टाइप. काम करने वाले टाइप की पूरी सूची: https://developers.google.com/maps/documentation/places/web-service/place-types. सिर्फ़ एक तरह के शामिल किए जा सकते हैं. |
openNow |
इसका इस्तेमाल उन जगहों तक पहुंचने के लिए किया जाता है जो फ़िलहाल खुली हैं. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. |
minRating |
उन नतीजों को फ़िल्टर करें जिनकी औसत उपयोगकर्ता रेटिंग इस सीमा से बिलकुल कम है. मान्य वैल्यू, 0.5 के बीच की वैल्यू यानी 0 से 5 के बीच का फ़्लोट होनी चाहिए. इसे 0.5 के बीच के बीच की वैल्यू पर भी सेट किया जाना चाहिए. जैसे, [0, 0.5, 1.0, ... , 5.0]. इनपुट रेटिंग को निकटतम 0.5(छत) तक पूर्णांकित किया जाएगा. उदाहरण के लिए, अगर रेटिंग 0.6 है, तो उससे 1.0 से कम रेटिंग वाले सभी नतीजे हट जाएंगे. |
maxResultCount |
अब काम नहीं करता: इसके बजाय, हर पेज पर दिखाए जा सकने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. अगर उपलब्ध नतीजों की संख्या अगर |
pageSize |
ज़रूरी नहीं. हर पेज पर दिखाए जा सकने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. अगर उपलब्ध नतीजों की संख्या अगर |
pageToken |
ज़रूरी नहीं. पिछले TextSearch कॉल से मिला पेज टोकन. अगले पेज को वापस पाने के लिए, यह जानकारी दें. पेज पर नंबर डालते समय, |
priceLevels[] |
इसका इस्तेमाल, खोज को उन जगहों तक सीमित करने के लिए किया जाता है जिन्हें कीमत के खास लेवल के तौर पर मार्क किया गया है. उपयोगकर्ता, कीमत के लेवल का कोई भी कॉम्बिनेशन चुन सकते हैं. कीमत के सभी लेवल चुनने का डिफ़ॉल्ट तरीका. |
strictTypeFiltering |
शामिल किए गए टाइप के लिए, सख्त टाइप को फ़िल्टर करने के लिए इसका इस्तेमाल किया जाता है. अगर नीति को 'सही है' पर सेट किया जाता है, तो सिर्फ़ उसी टाइप के नतीजे दिखाए जाएंगे. डिफ़ॉल्ट रूप से 'गलत' पर सेट होती है. |
locationBias |
खोजी जाने वाली जगह. इस जगह की जानकारी पूर्वाग्रह के तौर पर दिखाई जाती है. इसका मतलब है कि दी गई जगह के आस-पास के नतीजे दिखाए जा सकते हैं. जगह की पाबंदी के साथ सेट नहीं किया जा सकता. |
locationRestriction |
खोजी जाने वाली जगह. इस जगह की जानकारी पाबंदी के तौर पर दी गई है. इसका मतलब है कि इस जगह से बाहर के नतीजे नहीं दिखाए जाएंगे. locationBias के साथ सेट नहीं किया जा सकता. |
evOptions |
ज़रूरी नहीं. किसी जगह की जानकारी खोजने के अनुरोध के लिए, खोजे जा सकने वाले ईवी के विकल्प सेट करें. |
जवाब का मुख्य भाग
places.searchText के लिए रिस्पॉन्स प्रोटो.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{ "places": [ { object ( |
फ़ील्ड | |
---|---|
places[] |
ऐसी जगहों की सूची जो उपयोगकर्ता की टेक्स्ट से जुड़ी खोज की शर्तों को पूरा करती है. |
contextualContents[] |
प्रयोग के तौर पर उपलब्ध: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं. संदर्भ के हिसाब से कॉन्टेंट की ऐसी सूची जिसमें हर एंट्री, जगहों वाले फ़ील्ड में एक ही इंडेक्स में, उससे जुड़ी जगह से जुड़ी होती है. अनुरोध में मौजूद |
nextPageToken |
एक टोकन, जिसे अगला पेज फिर से पाने के लिए |
RankPreference
जवाब में नतीजों को कैसे रैंक किया जाएगा.
Enums | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
"नई दिल्ली के रेस्टोरेंट" जैसी कैटगरी से जुड़ी क्वेरी के लिए, RELEVANCE डिफ़ॉल्ट होता है. "माउंटेन व्यू, सीए" जैसे गैर-कैटगरिकल क्वेरी के लिए हमारा सुझाव है कि आप RankPreference को सेट न करें. |
DISTANCE |
दूरी के हिसाब से नतीजों को रैंक करता है. |
RELEVANCE |
नतीजों को प्रासंगिकता के हिसाब से रैंक करता है. सामान्य रैंकिंग स्टैक के हिसाब से तय किया गया क्रम. |
LocationBias
खोजी जाने वाली जगह. इस जगह की जानकारी पूर्वाग्रह के तौर पर दिखाई जाती है. इसका मतलब है कि दी गई जगह के आस-पास के नतीजे दिखाए जा सकते हैं.
JSON के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
rectangle |
उत्तर-पूर्व और दक्षिण-पश्चिम कोने के हिसाब से बना एक आयत बॉक्स. |
circle |
केंद्र बिंदु और त्रिज्या से तय किया गया वृत्त. |
LocationRestriction
खोजी जाने वाली जगह. इस जगह की जानकारी पाबंदी के तौर पर दी गई है. इसका मतलब है कि इस जगह से बाहर के नतीजे नहीं दिखाए जाएंगे.
JSON के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
rectangle |
उत्तर-पूर्व और दक्षिण-पश्चिम कोने के हिसाब से बना एक आयत बॉक्स. |
EVOptions
किसी जगह की जानकारी खोजने के अनुरोध से जुड़े ईवी के विकल्प.
JSON के काेड में दिखाना |
---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
फ़ील्ड | |
---|---|
minimumChargingRateKw |
ज़रूरी नहीं. चार्जिंग की कम से कम दर, किलोवाट में. तय की गई दर से कम चार्जिंग दर वाली जगह को फ़िल्टर करके बाहर कर दिया गया है. |
connectorTypes[] |
ज़रूरी नहीं. ईवी कनेक्टर के पसंदीदा टाइप की सूची. जिस जगह पर दिए गए कनेक्टर टाइप में से कोई भी काम नहीं करता उसे फ़िल्टर करके बाहर कर दिया जाता है. |
ContextualContent
प्रयोग के तौर पर उपलब्ध: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.
ऐसा कॉन्टेंट जो किसी जगह से जुड़ी क्वेरी के हिसाब से हो.
JSON के काेड में दिखाना |
---|
{ "reviews": [ { object ( |
फ़ील्ड | |
---|---|
reviews[] |
इस जगह से जुड़ी समीक्षाओं की सूची, जगह से जुड़ी क्वेरी से जुड़ी हुई है. |
photos[] |
इस जगह की फ़ोटो के बारे में जानकारी (इसमें रेफ़रंस भी शामिल हैं), जगह से जुड़ी क्वेरी से मिलती-जुलती है. |
justifications[] |
प्रयोग के तौर पर उपलब्ध: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं. जगह के लिए वजह. |
वजह
प्रयोग के तौर पर उपलब्ध: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.
जगह के लिए वजह. सही वजह से इस सवाल का जवाब मिलता है कि किसी जगह के विज्ञापन में असली उपयोगकर्ता की दिलचस्पी क्यों हो सकती है.
JSON के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
reviewJustification |
प्रयोग के तौर पर उपलब्ध: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं. |
businessAvailabilityAttributesJustification |
प्रयोग के तौर पर उपलब्ध: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं. |
ReviewJustification
प्रयोग के तौर पर उपलब्ध: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.
उपयोगकर्ता की समीक्षा की वजह. इससे उपयोगकर्ता की समीक्षा के उस सेक्शन को हाइलाइट किया जाता है जिसमें असली उपयोगकर्ता की दिलचस्पी हो सकती है. उदाहरण के लिए, अगर खोज क्वेरी "फ़ायरवुड पिज़्ज़ा" है, तो समीक्षा की वजह बताई गई खोज क्वेरी से मेल खाने वाले टेक्स्ट को हाइलाइट करती है.
JSON के काेड में दिखाना |
---|
{ "highlightedText": { object ( |
फ़ील्ड | |
---|---|
highlightedText |
|
review |
वह समीक्षा जिससे हाइलाइट किया गया टेक्स्ट जनरेट किया गया है. |
HighlightedText
वजह के आधार पर हाइलाइट किया गया टेक्स्ट. यह समीक्षा का ही एक सबसेट है. हाइलाइट किए जाने वाले शब्द को हाइलाइटedTextRange की मदद से मार्क किया जाता है. ऐसा हो सकता है कि हाइलाइट किए गए टेक्स्ट में कई शब्द हों.
JSON के काेड में दिखाना |
---|
{
"text": string,
"highlightedTextRanges": [
{
object ( |
फ़ील्ड | |
---|---|
text |
|
highlightedTextRanges[] |
हाइलाइट किए गए टेक्स्ट की रेंज की सूची. |
HighlightedTextRange
हाइलाइट किए गए टेक्स्ट की सीमा.
JSON के काेड में दिखाना |
---|
{ "startIndex": integer, "endIndex": integer } |
फ़ील्ड | |
---|---|
startIndex |
|
endIndex |
|
BusinessAvailabilityAttributesJustification
प्रयोग के तौर पर उपलब्ध: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं. BusinessAvailabilityAttributes की वजह. इससे किसी कारोबार की कुछ ऐसी विशेषताएं दिखती हैं जिनमें असली उपयोगकर्ता की दिलचस्पी हो सकती है.
JSON के काेड में दिखाना |
---|
{ "takeout": boolean, "delivery": boolean, "dineIn": boolean } |
फ़ील्ड | |
---|---|
takeout |
अगर कोई जगह टेकआउट की सुविधा देती है. |
delivery |
अगर यहां डिलीवरी की सुविधा है. |
dineIn |
अगर किसी जगह पर बैठकर खाने की सुविधा है. |