- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- RankPreference
- LocationBias
- LocationRestriction
- EVOptions
टेक्स्ट क्वेरी पर आधारित जगह की खोज.
एचटीटीपी अनुरोध
POST https://places.googleapis.com/v1/places:searchText
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "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, 0.5, 1.0, ... , 5.0]. इसमें ये सभी वैल्यू भी शामिल होनी चाहिए. इनपुट रेटिंग सबसे करीब 0.5(सीलिंग) तक हो जाएगी. उदाहरण के लिए, 0.6 की रेटिंग से 1.0 से कम रेटिंग वाले सभी नतीजे हट जाएंगे. |
maxResultCount |
दिखाए जाने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. यह 1 से 20 के बीच होना चाहिए. डिफ़ॉल्ट संख्या 20 है. अगर यह संख्या सेट नहीं है, तो यह ऊपरी सीमा पर वापस चली जाती है. अगर संख्या ऋणात्मक पर सेट है या ऊपरी सीमा से ज़्यादा है, तो एक INVALID_LABEL गड़बड़ी दिखाई जाती है. |
priceLevels[] |
इसका इस्तेमाल, खोज को उन जगहों तक सीमित करने के लिए किया जाता है जिन्हें कीमत के कुछ लेवल के तौर पर मार्क किया गया है. उपयोगकर्ता, कीमत के लेवल का कोई भी कॉम्बिनेशन चुन सकते हैं. डिफ़ॉल्ट रूप से, कीमत के सभी लेवल चुने जा सकते हैं. |
strictTypeFiltering |
शामिल किए गए टाइप के लिए, सख्त टाइप को फ़िल्टर करने के लिए इस्तेमाल किया जाता है. अगर इसे 'सही है' पर सेट किया जाता है, तो सिर्फ़ एक तरह के नतीजे दिखाए जाएंगे. डिफ़ॉल्ट रूप से, 'गलत' पर सेट होता है. |
locationBias |
वह क्षेत्र जिसे खोजना है. इस जगह की जानकारी से जुड़ा कोई भेदभाव नहीं होता है, जिसका मतलब है कि दी गई जगह के हिसाब से नतीजे दिखाए जा सकते हैं. इसे स्थान पाबंदी के साथ सेट नहीं किया जा सकता. |
locationRestriction |
वह क्षेत्र जिसे खोजना है. इस जगह पर पाबंदी है. इसका मतलब है कि दी गई जगह से बाहर के नतीजे नहीं दिखाए जाएंगे. इसे locationBias के साथ सेट नहीं किया जा सकता. |
evOptions |
ज़रूरी नहीं. जगह की खोज के अनुरोध के लिए खोजे जा सकने वाले ईवी विकल्प सेट करें. |
जवाब का मुख्य भाग
places.searchText के लिए रिस्पॉन्स प्रोटो.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"places": [
{
object ( |
फ़ील्ड | |
---|---|
places[] |
टेक्स्ट की मदद से की गई खोज की शर्तों को पूरा करने वाली जगहों की सूची. |
RankPreference
जवाब में नतीजों को रैंक कैसे किया जाएगा.
Enums | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
"न्यूयॉर्क शहर के रेस्टोरेंट" जैसी कैटगरी से जुड़ी क्वेरी के लिए, RELEVANCE डिफ़ॉल्ट होता है. हमारा सुझाव है कि "माउंटेन व्यू, सीए" जैसी अन्य कैटगरी से जुड़ी क्वेरी के लिए, आप RankPreference को सेट न करें. |
DISTANCE |
दूरी के आधार पर नतीजों की रैंकिंग करता है. |
RELEVANCE |
प्रासंगिकता के मुताबिक नतीजों की रैंकिंग करता है. सामान्य रैंकिंग स्टैक के हिसाब से क्रम में लगाएं. |
LocationBias
वह क्षेत्र जिसे खोजना है. इस जगह की जानकारी से जुड़ा कोई भेदभाव नहीं होता है, जिसका मतलब है कि दी गई जगह के हिसाब से नतीजे दिखाए जा सकते हैं.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
rectangle |
रेक्टैंगल बॉक्स, जिसके उत्तर-पूर्व और दक्षिण-पश्चिम कोने से पता चलता है. |
circle |
केंद्र बिंदु और त्रिज्या के आधार पर परिभाषित वृत्त. |
LocationRestriction
वह क्षेत्र जिसे खोजना है. इस जगह पर पाबंदी है. इसका मतलब है कि दी गई जगह से बाहर के नतीजे नहीं दिखाए जाएंगे.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
rectangle |
रेक्टैंगल बॉक्स, जिसके उत्तर-पूर्व और दक्षिण-पश्चिम कोने से पता चलता है. |
EVOptions
जगह की खोज का अनुरोध करने वाले ईवी के विकल्प, जिन्हें खोजा जा सकता है.
जेएसओएन के काेड में दिखाना |
---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
फ़ील्ड | |
---|---|
minimumChargingRateKw |
ज़रूरी नहीं. किलोवाट में, चार्जिंग की ज़रूरी दर. तय की गई दर से कम चार्ज रेट वाली जगह को फ़िल्टर करके, अलग कर दिया जाता है. |
connectorTypes[] |
ज़रूरी नहीं. पसंदीदा ईवी कनेक्टर टाइप की सूची. जो जगह सूची में दिए गए किसी भी तरह के कनेक्टर के साथ काम नहीं करती उसे फ़िल्टर करके बाहर कर दिया गया है. |