- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- RankPreference
- LocationBias
- LocationRestriction
- EVOptions
- SearchAlongRouteParameters
- Polyline
- 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 |
वह देश/इलाका जहां से अनुरोध किया गया है. इसके लिए, यूनिकोड देश/इलाके का कोड (सीएलडीआर) इस्तेमाल किया जाता है. इस पैरामीटर का इस्तेमाल, जगह की जानकारी दिखाने के लिए किया जाता है. जैसे, अगर उपलब्ध हो, तो क्षेत्र के हिसाब से जगह का नाम. लागू कानून के आधार पर, इस पैरामीटर से नतीजों पर असर पड़ सकता है. ज़्यादा जानकारी के लिए, 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 |
इस्तेमाल बंद कर दिया गया है: इसके बजाय, हर पेज पर ज़्यादा से ज़्यादा कितने नतीजे दिखाए जा सकते हैं. अगर उपलब्ध नतीजों की संख्या अगर |
pageSize |
ज़रूरी नहीं. हर पेज पर ज़्यादा से ज़्यादा कितने नतीजे दिखाए जा सकते हैं. अगर उपलब्ध नतीजों की संख्या अगर |
pageToken |
ज़रूरी नहीं. यह एक पेज टोकन है, जो TextSearch के पिछले कॉल से मिला था. अगला पेज पाने के लिए, यह जानकारी दें. पेज नंबर के हिसाब से नतीजे दिखाने के दौरान, TextSearch को दिए गए |
priceLevels[] |
इस कुकी का इस्तेमाल, खोज के नतीजों को उन जगहों तक सीमित करने के लिए किया जाता है जिन्हें कीमत के कुछ लेवल के तौर पर मार्क किया गया है. उपयोगकर्ता, कीमत के लेवल का कोई भी कॉम्बिनेशन चुन सकते हैं. डिफ़ॉल्ट रूप से, सभी प्राइस लेवल चुनने का विकल्प. |
strictTypeFiltering |
इस कुकी का इस्तेमाल, शामिल किए गए टाइप के लिए सख्त फ़िल्टरिंग सेट करने के लिए किया जाता है. अगर इसे 'सही है' पर सेट किया जाता है, तो सिर्फ़ एक ही तरह के नतीजे दिखाए जाएंगे. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होती है. |
locationBias |
वह क्षेत्र जिसमें खोजना है. इस जगह की जानकारी को पूर्वाग्रह के तौर पर इस्तेमाल किया जाता है. इसका मतलब है कि दी गई जगह के आस-पास के नतीजे दिखाए जा सकते हैं. इसे locationRestriction के साथ सेट नहीं किया जा सकता. |
locationRestriction |
वह क्षेत्र जिसमें खोजना है. इस जगह की जानकारी का इस्तेमाल, खोज के नतीजों को सीमित करने के लिए किया जाता है. इसका मतलब है कि दी गई जगह के बाहर के नतीजे नहीं दिखाए जाएंगे. इसे locationBias के साथ सेट नहीं किया जा सकता. |
evOptions |
ज़रूरी नहीं. किसी जगह को खोजने के अनुरोध के लिए, ईवी के खोजे जा सकने वाले विकल्प सेट करता है. |
routingParameters |
ज़रूरी नहीं. नतीजों पर रीडायरेक्ट करने के लिए अतिरिक्त पैरामीटर. |
searchAlongRouteParameters |
ज़रूरी नहीं. रास्ते के आस-पास खोजने के लिए, अतिरिक्त पैरामीटर वाला प्रोटो. |
includePureServiceAreaBusinesses |
ज़रूरी नहीं. अगर फ़ील्ड को 'सही है' पर सेट किया गया है, तो घर या दुकान पर सेवा देने वाले कारोबारों को शामिल करें. घर या दुकान पर सेवा देने वाला कारोबार, ग्राहकों के पते पर जाकर सेवा देता है या डिलीवरी करता है. वह अपने कारोबार के पते पर ग्राहकों को सेवा नहीं देता. उदाहरण के लिए, प्लंबर या सफ़ाई की सेवाएं देने वाले कारोबार. इन कारोबारों का कोई पता या जगह Google Maps पर मौजूद नहीं है. इन कारोबारों के लिए, Places API से |
includeFutureOpeningBusinesses |
ज़रूरी नहीं. अगर यह सही है, तो उन कारोबारों को शामिल करें जो अभी तक खुले नहीं हैं, लेकिन आने वाले समय में खुलेंगे. |
जवाब का मुख्य भाग
places.searchText के लिए रिस्पॉन्स प्रोटो.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
| JSON फ़ॉर्मैट में दिखाया गया है |
|---|
{ "places": [ { object ( |
| फ़ील्ड | |
|---|---|
places[] |
उन जगहों की सूची जो उपयोगकर्ता की टेक्स्ट सर्च की ज़रूरी शर्तों को पूरा करती हैं. |
routingSummaries[] |
रास्ते की जानकारी देने वाली सूचियों की एक सूची. इसमें हर एंट्री, |
contextualContents[] |
एक्सपेरिमेंट के तौर पर उपलब्ध: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं. कॉन्टेक्स्ट के हिसाब से कॉन्टेंट की सूची. इसमें हर एंट्री, जगहों की जानकारी वाले फ़ील्ड में मौजूद उसी इंडेक्स में मौजूद जगह से जुड़ी होती है. अनुरोध में मौजूद |
nextPageToken |
यह एक ऐसा टोकन है जिसे |
searchUri |
इस लिंक की मदद से, उपयोगकर्ता Google Maps पर उसी टेक्स्ट क्वेरी से खोज कर सकता है जो अनुरोध में दी गई है. |
अनुमति पाने के लिंक
इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/maps-platform.places.textsearchhttps://www.googleapis.com/auth/maps-platform.placeshttps://www.googleapis.com/auth/cloud-platform
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[] |
ज़रूरी नहीं. पसंदीदा ईवी कनेक्टर टाइप की सूची. जिस जगह पर कनेक्टर के किसी भी टाइप का इस्तेमाल नहीं किया जा सकता उसे फ़िल्टर कर दिया जाता है. |
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 इनमें से सिर्फ़ एक हो सकता है: |
|
encodedPolyline |
यह कोड में बदला गया पॉलीलाइन है, जिसे Routes API डिफ़ॉल्ट रूप से दिखाता है. एन्कोडर और डिकोडर टूल देखें. |
ContextualContent
ऐसा कॉन्टेंट जो जगह की क्वेरी के हिसाब से हो.
| JSON के काेड में दिखाना |
|---|
{ "reviews": [ { object ( |
| फ़ील्ड | |
|---|---|
reviews[] |
इस जगह के बारे में समीक्षाओं की सूची. ये समीक्षाएं, जगह की क्वेरी के हिसाब से होती हैं. |
photos[] |
इस जगह की फ़ोटो के बारे में जानकारी (रेफ़रंस के साथ). यह जानकारी, जगह की क्वेरी के हिसाब से होती है. |
justifications[] |
जगह के बारे में जानकारी देने वाले तथ्य. |
वजह
जगह के बारे में जानकारी देने वाले तथ्य. जस्टिफ़िकेशन से इस सवाल का जवाब मिलता है कि कोई जगह असली उपयोगकर्ता की दिलचस्पी क्यों बढ़ा सकती है.
| JSON के काेड में दिखाना |
|---|
{ // Union field |
| फ़ील्ड | |
|---|---|
यूनियन फ़ील्ड
|
|
reviewJustification |
|
businessAvailabilityAttributesJustification |
|
ReviewJustification
उपयोगकर्ता की समीक्षाओं के लिए वजहें. इससे उपयोगकर्ता की समीक्षा के उस सेक्शन को हाइलाइट किया जाता है जिसमें असली उपयोगकर्ता की दिलचस्पी हो सकती है. उदाहरण के लिए, अगर खोज क्वेरी "लकड़ी के चूल्हे पर बना पिज़्ज़ा" है, तो समीक्षा के औचित्य में खोज क्वेरी से जुड़ा टेक्स्ट हाइलाइट किया जाता है.
| JSON के काेड में दिखाना |
|---|
{ "highlightedText": { object ( |
| फ़ील्ड | |
|---|---|
highlightedText |
|
review |
वह समीक्षा जिससे हाइलाइट किया गया टेक्स्ट जनरेट किया गया है. |
HighlightedText
जस्टिफ़िकेशन के हिसाब से हाइलाइट किया गया टेक्स्ट. यह समीक्षा का सबसेट है. हाइलाइट किए जाने वाले सटीक शब्द को HighlightedTextRange से मार्क किया जाता है. हाइलाइट किए गए टेक्स्ट में कई शब्द हो सकते हैं.
| JSON के काेड में दिखाना |
|---|
{
"text": string,
"highlightedTextRanges": [
{
object ( |
| फ़ील्ड | |
|---|---|
text |
|
highlightedTextRanges[] |
हाइलाइट किए गए टेक्स्ट की रेंज की सूची. |
HighlightedTextRange
हाइलाइट किए गए टेक्स्ट की रेंज.
| JSON के काेड में दिखाना |
|---|
{ "startIndex": integer, "endIndex": integer } |
| फ़ील्ड | |
|---|---|
startIndex |
|
endIndex |
|
BusinessAvailabilityAttributesJustification
BusinessAvailabilityAttributes के लिए औचित्य. इससे किसी कारोबार की कुछ ऐसी विशेषताओं के बारे में पता चलता है जिनमें असली उपयोगकर्ता की दिलचस्पी हो सकती है.
| JSON के काेड में दिखाना |
|---|
{ "takeout": boolean, "delivery": boolean, "dineIn": boolean } |
| फ़ील्ड | |
|---|---|
takeout |
अगर किसी जगह पर खाना पैक कराकर ले जाने की सुविधा उपलब्ध है. |
delivery |
अगर किसी जगह पर डिलीवरी की सुविधा उपलब्ध है. |
dineIn |
अगर किसी जगह पर बैठकर खाने की सुविधा उपलब्ध है. |