- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- RankPreference
- LocationBias
- LocationRestriction
- EVOptions
- SearchAlongRouteParameters
- पॉलीलाइन
- ContextualContent
- जस्टिफ़िकेशन
- ReviewJustification
- HighlightedText
- HighlightedTextRange
- BusinessAvailabilityAttributesJustification
टेक्स्ट क्वेरी के आधार पर जगह खोजना.
एचटीटीपी अनुरोध
POST https://places.googleapis.com/v1/places:searchText
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:
JSON के काेड में दिखाना |
---|
{ "textQuery": string, "languageCode": string, "regionCode": string, "rankPreference": enum ( |
फ़ील्ड | |
---|---|
text |
ज़रूरी है. टेक्स्ट की मदद से खोजने के लिए टेक्स्ट क्वेरी. |
language |
अगर आपने अपनी पसंदीदा भाषा सेट की है, तो जगह की जानकारी उसी भाषा में दिखेगी. अगर भाषा कोड की जानकारी नहीं दी गई है या उसे पहचाना नहीं जा सका है, तो किसी भी भाषा में जगह की जानकारी दिखाई जा सकती है. अगर ऐसी जानकारी मौजूद है, तो अंग्रेज़ी को प्राथमिकता दी जाएगी. इस्तेमाल की जा सकने वाली भाषाओं की मौजूदा सूची: https://developers.google.com/maps/faq#languagesupport. |
region |
उस जगह का यूनिकोड देश/इलाका कोड (CLDR), जहां से अनुरोध किया गया है. इस पैरामीटर का इस्तेमाल, जगह की जानकारी दिखाने के लिए किया जाता है. जैसे, इलाके के हिसाब से जगह का नाम, अगर उपलब्ध हो. लागू कानून के आधार पर, इस पैरामीटर से नतीजों पर असर पड़ सकता है. ज़्यादा जानकारी के लिए, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html पर जाएं. ध्यान दें कि फ़िलहाल, तीन अंकों वाले क्षेत्र कोड का इस्तेमाल नहीं किया जा सकता. |
rank |
जवाब में नतीजों को किस तरह रैंक किया जाएगा. |
included |
जगह का वह टाइप जिसका अनुरोध किया गया है. इस्तेमाल किए जा सकने वाले टाइप की पूरी सूची: https://developers.google.com/maps/documentation/places/web-service/place-types. इसमें सिर्फ़ एक तरह के डेटा को शामिल किया जा सकता है. |
open |
इसका इस्तेमाल, खोज को सिर्फ़ उन जगहों तक सीमित करने के लिए किया जाता है जो फ़िलहाल खुली हैं. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होती है. |
min |
ऐसे नतीजों को फ़िल्टर करें जिनकी औसत उपयोगकर्ता रेटिंग, इस सीमा से काफ़ी कम हो. वैल्यू, 0.5 के कैडेंस पर 0 से 5 के बीच की होनी चाहिए. जैसे, [0, 0.5, 1.0, ... , 5.0]. इनपुट रेटिंग को 0.5 तक राउंड अप किया जाएगा. उदाहरण के लिए, 0.6 की रेटिंग से, 1.0 से कम रेटिंग वाले सभी नतीजे हट जाएंगे. |
maxResultCount |
बंद कर दिया गया है: इसके बजाय, हर पेज पर दिखाए जा सकने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. अगर उपलब्ध नतीजों की संख्या अगर |
page |
ज़रूरी नहीं. हर पेज पर दिखाए जा सकने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. अगर उपलब्ध नतीजों की संख्या अगर |
page |
ज़रूरी नहीं. TextSearch के पिछले कॉल से मिला पेज टोकन. अगला पेज देखने के लिए, यह डालें. पेजेशन करते समय, TextSearch को दिए गए |
price |
इसका इस्तेमाल, खोज को सिर्फ़ उन जगहों तक सीमित करने के लिए किया जाता है जिन्हें किराये के हिसाब से कुछ खास लेवल के तौर पर मार्क किया गया हो. उपयोगकर्ता, कीमत के लेवल का कोई भी कॉम्बिनेशन चुन सकते हैं. डिफ़ॉल्ट रूप से, कीमत के सभी लेवल चुनें. |
strict |
includedType के लिए, सख्त टाइप फ़िल्टरिंग सेट करने के लिए इस्तेमाल किया जाता है. अगर इसे 'सही है' पर सेट किया जाता है, तो सिर्फ़ एक ही तरह के नतीजे दिखाए जाएंगे. डिफ़ॉल्ट रूप से गलत पर सेट होती है. |
location |
वह इलाका जहां आपको खोज करनी है. यह जगह, बायस के तौर पर काम करती है. इसका मतलब है कि आपको उस जगह के आस-पास के नतीजे मिल सकते हैं. इसे locationRestriction के साथ सेट नहीं किया जा सकता. |
location |
वह इलाका जहां आपको खोज करनी है. यह जगह, पाबंदी के तौर पर काम करती है. इसका मतलब है कि दी गई जगह से बाहर के नतीजे नहीं दिखाए जाएंगे. इसे locationBias के साथ सेट नहीं किया जा सकता. |
ev |
ज़रूरी नहीं. जगह खोजने के अनुरोध के लिए, ईवी के ऐसे विकल्प सेट करें जिनके लिए खोज की जा सकती है. |
routing |
ज़रूरी नहीं. नतीजों पर भेजने के लिए अतिरिक्त पैरामीटर. |
search |
ज़रूरी नहीं. किसी रास्ते के आस-पास खोजने के लिए, अतिरिक्त पैरामीटर प्रोटो. |
include |
ज़रूरी नहीं. अगर फ़ील्ड को 'सही है' पर सेट किया गया है, तो घर या दुकान पर सेवा देने वाले कारोबारों को शामिल करें. घर या दुकान पर सेवा देने वाला कारोबार वह कारोबार होता है जो ग्राहकों को उनके पते पर सेवा देता है या डिलीवरी करता है. हालांकि, कारोबार का कोई स्थायी पता नहीं होता. उदाहरण के लिए, प्लंबर या सफ़ाई की सेवाएं देने वाले कारोबार. उन कारोबारों का Google Maps पर कोई पता या जगह की जानकारी मौजूद नहीं है. इन कारोबारों के लिए, जगहों की जानकारी में |
जवाब का मुख्य भाग
places.searchText के लिए रिस्पॉन्स प्रोटो.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{ "places": [ { object ( |
फ़ील्ड | |
---|---|
places[] |
उन जगहों की सूची जो उपयोगकर्ता की टेक्स्ट खोज की ज़रूरी शर्तों को पूरा करती हैं. |
routing |
रूटिंग की खास जानकारी वाली सूची, जहां हर एंट्री |
contextual |
एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative देखें. कॉन्टेक्स्ट के हिसाब से कॉन्टेंट की सूची, जहां हर एंट्री, जगहों के फ़ील्ड में उसी इंडेक्स में मौजूद जगह से जुड़ी होती है. अनुरोध में मौजूद |
next |
अगला पेज पाने के लिए, |
search |
लिंक की मदद से, उपयोगकर्ता उसी टेक्स्ट क्वेरी से खोज कर सकता है जो Google Maps पर अनुरोध में दी गई थी. |
RankPreference
जवाब में नतीजों को किस तरह रैंक किया जाएगा.
Enums | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
"न्यूयॉर्क सिटी में रेस्टोरेंट" जैसी कैटगरी वाली क्वेरी के लिए, काम की जानकारी दिखाने की सुविधा डिफ़ॉल्ट रूप से चालू होती है. हमारा सुझाव है कि "Mountain View, CA" जैसी कैटगरी वाली क्वेरी के लिए, rankPreference को सेट न करें. |
DISTANCE |
नतीजों को दूरी के हिसाब से रैंक करता है. |
RELEVANCE |
नतीजों को काम के होने के हिसाब से रैंक करता है. क्रम को सामान्य रैंकिंग स्टैक के हिसाब से तय किया जाता है. |
LocationBias
वह इलाका जहां आपको खोज करनी है. यह जगह, बायस के तौर पर काम करती है. इसका मतलब है कि आपको उस जगह के आस-पास के नतीजे मिल सकते हैं.
JSON के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
rectangle |
उत्तर-पूर्व और दक्षिण-पश्चिम कोने से तय किया गया रेक्टैंगल बॉक्स. |
circle |
केंद्र बिंदु और त्रिज्या से तय किया गया वृत्त. |
LocationRestriction
वह इलाका जहां आपको खोज करनी है. यह जगह, पाबंदी के तौर पर काम करती है. इसका मतलब है कि दी गई जगह से बाहर के नतीजे नहीं दिखाए जाएंगे.
JSON के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
rectangle |
उत्तर-पूर्व और दक्षिण-पश्चिम कोने से तय किया गया रेक्टैंगल बॉक्स. |
EVOptions
जगह खोजने के अनुरोध के लिए, ईवी के ऐसे विकल्प जिन्हें खोजा जा सकता है.
JSON के काेड में दिखाना |
---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
फ़ील्ड | |
---|---|
minimum |
ज़रूरी नहीं. चार्जिंग की कम से कम दर, किलोवॉट में. अगर किसी जगह पर चार्जिंग की दर, तय की गई दर से कम है, तो उसे फ़िल्टर कर दिया जाता है. |
connector |
ज़रूरी नहीं. ईवी कनेक्टर के पसंदीदा टाइप की सूची. सूची में शामिल किसी भी कनेक्टर टाइप के साथ काम न करने वाली जगह को फ़िल्टर कर दिया जाता है. |
SearchAlongRouteParameters
Routes API से पहले से कैलकुलेट की गई पॉलीलाइन की जानकारी देता है. इससे, खोज के लिए रास्ते की जानकारी मिलती है. किसी रास्ते के हिसाब से खोजने की सुविधा, खोज के नतीजों में अपने हिसाब से बदलाव करने के लिए, locationBias
या locationRestriction
अनुरोध करने के विकल्प का इस्तेमाल करने जैसी ही है. हालांकि, locationBias
और locationRestriction
विकल्पों की मदद से, खोज के नतीजों में किसी इलाके को प्राथमिकता दी जा सकती है. वहीं, इस विकल्प की मदद से, यात्रा के रास्ते के हिसाब से नतीजों को प्राथमिकता दी जा सकती है.
इस बात की कोई गारंटी नहीं है कि नतीजे, दिए गए रास्ते पर ही मिलेंगे. इसके बजाय, नतीजों को पॉलीलाइन से तय किए गए खोज क्षेत्र में रैंक किया जाता है. इसके अलावा, locationBias
या locationRestriction
के आधार पर भी नतीजों को रैंक किया जा सकता है. यह रैंकिंग, शुरुआती पॉइंट से डेस्टिनेशन तक के कम से कम समय के आधार पर तय की जाती है. हो सकता है कि नतीजे किसी अन्य रास्ते के हिसाब से हों. ऐसा तब हो सकता है, जब दी गई पॉलीलाइन में, ऑरिजिन से डेस्टिनेशन तक का सबसे अच्छा रास्ता न बताया गया हो.
JSON के काेड में दिखाना |
---|
{
"polyline": {
object ( |
फ़ील्ड | |
---|---|
polyline |
ज़रूरी है. रास्ते की पॉलीलाइन. |
पॉलीलाइन
रास्ते की पॉलीलाइन. सिर्फ़ कोड में बदली गई पॉलीलाइन के साथ काम करता है. इसे स्ट्रिंग के तौर पर पास किया जा सकता है. इसमें कम से कम डेटा खोने के साथ कंप्रेस किया गया डेटा शामिल होता है. यह Routes API का डिफ़ॉल्ट आउटपुट है.
JSON के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड polyline_type . पॉलीलाइन का टाइप बताता है. Routes API का आउटपुट डिफ़ॉल्ट रूप से encoded_polyline पर सेट होता है. polyline_type इनमें से कोई एक हो सकता है: |
|
encoded |
Routes API डिफ़ॉल्ट रूप से, कोड में बदली गई पॉलीलाइन दिखाता है. एन्कोडर और डिकोडर टूल देखें. |
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 |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
review |
एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative देखें. |
business |
एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, 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 देखें.
उपयोगकर्ता की समीक्षा की वजहें. इससे, यूज़र रिव्यू के उस सेक्शन को हाइलाइट किया जाता है जिसमें असली उपयोगकर्ता की दिलचस्पी हो सकती है. उदाहरण के लिए, अगर खोज क्वेरी "firewood pizza" है, तो समीक्षा की वजह से खोज क्वेरी से जुड़े टेक्स्ट को हाइलाइट किया जाता है.
JSON के काेड में दिखाना |
---|
{ "highlightedText": { object ( |
फ़ील्ड | |
---|---|
highlighted |
|
review |
वह समीक्षा जिससे हाइलाइट किया गया टेक्स्ट जनरेट हुआ है. |
HighlightedText
टेक्स्ट को जस्टिफ़िकेशन के हिसाब से हाइलाइट किया गया है. यह समीक्षा का सबसेट होता है. हाइलाइट किए जाने वाले शब्द को HighlightedTextRange से मार्क किया जाता है. टेक्स्ट में कई शब्द हाइलाइट किए जा सकते हैं.
JSON के काेड में दिखाना |
---|
{
"text": string,
"highlightedTextRanges": [
{
object ( |
फ़ील्ड | |
---|---|
text |
|
highlighted |
हाइलाइट किए गए टेक्स्ट की रेंज की सूची. |
HighlightedTextRange
हाइलाइट किए गए टेक्स्ट की रेंज.
JSON के काेड में दिखाना |
---|
{ "startIndex": integer, "endIndex": integer } |
फ़ील्ड | |
---|---|
start |
|
end |
|
BusinessAvailabilityAttributesJustification
एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative देखें. BusinessAvailabilityAttributes एट्रिब्यूट की वजहें. इससे, कारोबार के कुछ ऐसे एट्रिब्यूट के बारे में पता चलता है जिनमें असली उपयोगकर्ता की दिलचस्पी हो सकती है.
JSON के काेड में दिखाना |
---|
{ "takeout": boolean, "delivery": boolean, "dineIn": boolean } |
फ़ील्ड | |
---|---|
takeout |
क्या यहां पर, खाना पैक कराकर ले जाने की सुविधा उपलब्ध है. |
delivery |
अगर किसी जगह पर डिलीवरी की सुविधा उपलब्ध है. |
dine |
अगर किसी जगह पर बैठकर खाने की सुविधा उपलब्ध है. |