Package google.maps.places.v1

इंडेक्स

जगहें

Places API की सेवा की परिभाषा. ध्यान दें: हर अनुरोध (अपने-आप पूरा होने के अनुरोधों को छोड़कर) के लिए, अनुरोध प्रोटो के बाहर एक फ़ील्ड मास्क सेट करना ज़रूरी होता है (all/*, नहीं माना जाता है). फ़ील्ड मास्क को एचटीटीपी हेडर X-Goog-FieldMask के ज़रिए सेट किया जा सकता है. देखें: https://developers.google.com/maps/documentation/places/web-service/choose-fields

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

दिए गए इनपुट के लिए अनुमान दिखाता है.

GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

फ़ोटो रेफ़रंस स्ट्रिंग वाला फ़ोटो मीडिया पाएं.

GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

किसी जगह के संसाधन के नाम के आधार पर उसकी जानकारी पाएं, जो places/{place_id} फ़ॉर्मैट की एक स्ट्रिंग है.

SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

आस-पास के स्थान खोजें.

SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

टेक्स्ट क्वेरी पर आधारित जगह की खोज.

AuthorAttribution

यूजीसी (लोगों का बनाया कॉन्टेंट) डेटा के लेखक के बारे में जानकारी. Photo और Review में इस्तेमाल किया जाता है.

फ़ील्ड
display_name

string

Photo या Review के लेखक का नाम.

uri

string

Photo या Review के लेखक का यूआरआई.

photo_uri

string

Photo या Review के लेखक की प्रोफ़ाइल फ़ोटो यूआरआई.

AutocompletePlacesRequest

Autocomplete Places के लिए प्रोटो का अनुरोध करें.

फ़ील्ड
input

string

ज़रूरी है. वह टेक्स्ट स्ट्रिंग जिस पर खोज करनी है.

location_bias

LocationBias

ज़रूरी नहीं. किसी खास जगह के पूर्वाग्रह के नतीजे.

location_bias या location_restriction में से ज़्यादा से ज़्यादा एक सेट किया जाना चाहिए. अगर दोनों में से कोई भी सेट नहीं किया जाता है, तो नतीजे के लिए आईपी पते का इस्तेमाल किया जाएगा. इसका मतलब है कि आईपी पते को सटीक जगह के तौर पर मैप किया जाएगा और नतीजे के तौर पर एक मापदंड के तौर पर इस्तेमाल किया जाएगा.

location_restriction

LocationRestriction

ज़रूरी नहीं. किसी खास जगह के लिए नतीजे सीमित करें.

location_bias या location_restriction में से ज़्यादा से ज़्यादा एक सेट किया जाना चाहिए. अगर दोनों में से कोई भी सेट नहीं किया जाता है, तो नतीजे के लिए आईपी पते का इस्तेमाल किया जाएगा. इसका मतलब है कि आईपी पते को सटीक जगह के तौर पर मैप किया जाएगा और नतीजे के तौर पर एक मापदंड के तौर पर इस्तेमाल किया जाएगा.

included_primary_types[]

string

ज़रूरी नहीं. https://developers.google.com/maps/documentation/places/web-service/place-types से शामिल की गई मुख्य जगह का टाइप (उदाहरण के लिए, "रेस्टोरेंट" या "gas_station"). किसी जगह को सिर्फ़ तब दिखाया जाता है, जब उसका मुख्य टाइप इस सूची में शामिल हो. ज़्यादा से ज़्यादा पांच वैल्यू दी जा सकती हैं. अगर कोई भी टाइप तय नहीं किया गया है, तो सभी तरह की जगहें दिखाई जाती हैं.

included_region_codes[]

string

ज़रूरी नहीं. सिर्फ़ बताए गए क्षेत्रों में नतीजे शामिल करें. इन क्षेत्रों के लिए, ज़्यादा से ज़्यादा 15 CLDR दो वर्ण वाले क्षेत्र कोड बताए गए हैं. अगर कोई सेट खाली है, तो नतीजों पर पाबंदी नहीं लगेगी. अगर location_restriction और included_region_codes, दोनों सेट हैं, तो नतीजे चौराहे वाली जगह में दिखेंगे.

language_code

string

ज़रूरी नहीं. वह भाषा जिसमें नतीजे देने हैं. डिफ़ॉल्ट तौर पर en-US होता है. अगर input में इस्तेमाल की गई भाषा language_code से अलग है या दिखाई गई जगह का स्थानीय भाषा से language_code में अनुवाद मौजूद न हो, तो नतीजे अलग-अलग भाषाओं में हो सकते हैं.

region_code

string

ज़रूरी नहीं. क्षेत्र का कोड, जिसे CLDR दो वर्णों वाले क्षेत्रीय कोड के रूप में दिखाया जाता है. इससे पते के फ़ॉर्मैट और नतीजों की रैंकिंग पर असर पड़ता है. साथ ही, दिखाए जाने वाले नतीजों पर भी असर पड़ सकता है. इससे, बताए गए इलाके के लिए नतीजे सीमित नहीं होते. नतीजों को किसी क्षेत्र तक सीमित करने के लिए, region_code_restriction का इस्तेमाल करें.

origin

LatLng

ज़रूरी नहीं. वह मूल बिंदु जहां से मंज़िल की भौगोलिक दूरी की गणना करना है (distance_meters के रूप में लौटाया गया है). अगर इस मान को शामिल नहीं किया जाता है, तो भौगोलिक दूरी नहीं दी जाएगी.

input_offset

int32

ज़रूरी नहीं. input का शून्य-आधारित यूनिकोड वर्ण ऑफ़सेट, जो input में कर्सर की स्थिति को दिखाता है. कर्सर की स्थिति से, खोज के नतीजों पर असर पड़ सकता है.

अगर यह फ़ील्ड खाली है, तो डिफ़ॉल्ट रूप से input की लंबाई होती है.

include_query_predictions

bool

ज़रूरी नहीं. सही होने पर, जवाब में जगह और क्वेरी के अनुमान, दोनों शामिल होंगे. ऐसा न होने पर जवाब सिर्फ़ जगह के अनुमान दिखाएगा.

session_token

string

ज़रूरी नहीं. वह स्ट्रिंग जो बिलिंग के मकसद से, ऑटोकंप्लीट सेशन की पहचान करती है. यह एक यूआरएल और फ़ाइल नाम वाली सेफ़ base64 स्ट्रिंग होनी चाहिए, जिसमें ज़्यादा से ज़्यादा 36 ASCII वर्ण हों. अगर ऐसा नहीं होता है, तो एक INVALID_LABEL गड़बड़ी मिलती है.

सेशन तब शुरू होता है, जब उपयोगकर्ता कोई क्वेरी टाइप करना शुरू करता है और जगह चुनने के बाद जगह की जानकारी या पते की पुष्टि करने के लिए कॉल पूरा करता है. हर सेशन में कई क्वेरी हो सकती हैं. इसके बाद, जगह की जानकारी या पते की पुष्टि करने का एक अनुरोध हो सकता है. किसी सेशन में हर अनुरोध के लिए इस्तेमाल किए जाने वाले क्रेडेंशियल, एक ही Google Cloud Console प्रोजेक्ट से जुड़े होने चाहिए. सेशन खत्म होने के बाद, टोकन मान्य नहीं रहता. आपके ऐप्लिकेशन को हर सेशन के लिए नया टोकन जनरेट करना होगा. अगर session_token पैरामीटर हटाया जाता है या किसी सेशन टोकन का फिर से इस्तेमाल किया जाता है, तो सेशन से इस तरह शुल्क लिया जाता है जैसे कोई सेशन टोकन नहीं दिया गया था. हर अनुरोध का बिल अलग से लिया जाता है.

हमारा सुझाव है कि आप नीचे दिए गए दिशा-निर्देशों का पालन करें:

  • ऑटोकंप्लीट की सुविधा वाले सभी कॉल के लिए, सेशन टोकन का इस्तेमाल करें.
  • हर सेशन के लिए नया टोकन जनरेट करें. हमारा सुझाव है कि आप वर्शन 4 के यूयूआईडी का इस्तेमाल करें.
  • पक्का करें कि किसी सेशन में, जगह की जानकारी अपने-आप पूरी होने, जगह की जानकारी, और पते की पुष्टि करने के सभी अनुरोधों के लिए इस्तेमाल किए गए क्रेडेंशियल, एक ही Cloud Console प्रोजेक्ट से जुड़े हों.
  • हर नए सेशन के लिए एक यूनीक सेशन टोकन पास करना न भूलें. एक से ज़्यादा सेशन के लिए एक ही टोकन का इस्तेमाल करने से, हर अनुरोध की बिलिंग अलग-अलग होगी.

LocationBias

वह क्षेत्र जिसे खोजना है. ऐसा हो सकता है कि नतीजे किसी खास इलाके के हिसाब से हों.

फ़ील्ड

यूनियन फ़ील्ड type.

type इनमें से सिर्फ़ एक हो सकती है:

rectangle

Viewport

उत्तर-पूर्व और दक्षिण-पश्चिम कोने के ज़रिए तय किया गया व्यूपोर्ट.

circle

Circle

केंद्र बिंदु और त्रिज्या के आधार पर परिभाषित वृत्त.

LocationRestriction

वह क्षेत्र जिसे खोजना है. चुने गए इलाके के हिसाब से नतीजे दिखाए जाएंगे.

फ़ील्ड

यूनियन फ़ील्ड type.

type इनमें से सिर्फ़ एक हो सकती है:

rectangle

Viewport

उत्तर-पूर्व और दक्षिण-पश्चिम कोने के ज़रिए तय किया गया व्यूपोर्ट.

circle

Circle

केंद्र बिंदु और त्रिज्या के आधार पर परिभाषित वृत्त.

AutocompletePlacesResponse

Autocomplete Places के लिए रिस्पॉन्स प्रोटो.

फ़ील्ड
suggestions[]

Suggestion

इसमें सुझावों की सूची शामिल होती है. यह काम के हिसाब से घटते क्रम में होती है.

सुझाव

ऑटोकंप्लीट के सुझाव का नतीजा.

फ़ील्ड

यूनियन फ़ील्ड kind.

kind इनमें से सिर्फ़ एक हो सकती है:

place_prediction

PlacePrediction

किसी जगह के लिए सुझाव.

query_prediction

QueryPrediction

किसी क्वेरी के लिए सुझाव.

FormattableText

जगह या क्वेरी का अनुमान दिखाने वाला टेक्स्ट. टेक्स्ट को इस तरह से इस्तेमाल किया जा सकता है जिस तरह से टेक्स्ट को फ़ॉर्मैट किया गया है या जिस पर उसे फ़ॉर्मैट किया गया है.

फ़ील्ड
text

string

वह टेक्स्ट जिसे matches के साथ फ़ॉर्मैट या इस्तेमाल किया जा सकता है.

matches[]

StringRange

स्ट्रिंग रेंज की सूची, जिससे पता चलता है कि text में, इनपुट अनुरोध कहां मेल खाता है. रेंज का इस्तेमाल, text के खास हिस्सों को फ़ॉर्मैट करने के लिए किया जा सकता है. अगर मैचिंग का पता स्ट्रिंग मैचिंग के अलावा किसी अन्य मापदंड (उदाहरण के लिए, वर्तनी में सुधार या ट्रांसलिट्रेशन) से लगाया गया था, तो हो सकता है कि सबस्ट्रिंग input से पूरी तरह मेल न खाती हों.

ये वैल्यू, text के यूनिकोड वर्ण ऑफ़सेट हैं. बढ़ते हुए ऑफ़सेट वैल्यू में, रेंज को ऑर्डर करने की गारंटी दी जाती है.

PlacePrediction

जगह के अपने-आप पूरे होने की सुविधा के अनुमान के लिए मिले नतीजे.

फ़ील्ड
place

string

सुझाई गई जगह के संसाधन का नाम. इस नाम का इस्तेमाल ऐसे अन्य एपीआई में किया जा सकता है जो जगहों के नाम स्वीकार करते हैं.

place_id

string

सुझाई गई जगह का यूनीक आइडेंटिफ़ायर. इस आइडेंटिफ़ायर का इस्तेमाल, ऐसे अन्य एपीआई में किया जा सकता है जो जगह के आईडी स्वीकार करते हैं.

text

FormattableText

इसमें नतीजे का ऐसा नाम होता है जिसे कोई भी व्यक्ति आसानी से पढ़ सके. कारोबार की जगहों के नतीजों के लिए, आम तौर पर यह कारोबार का नाम और पता होता है.

उन डेवलपर को text का इस्तेमाल करने का सुझाव दिया जाता है जो सिर्फ़ एक यूज़र इंटरफ़ेस (यूआई) एलिमेंट दिखाना चाहते हैं. जो डेवलपर दो अलग-अलग, लेकिन मिलते-जुलते यूआई एलिमेंट दिखाना चाहते हैं वे structured_format का इस्तेमाल कर सकते हैं. किसी जगह का अनुमान लगाने के दो अलग-अलग तरीके हैं. उपयोगकर्ताओं को structured_format को text या इस तरह पार्स करने की कोशिश नहीं करनी चाहिए.

यह टेक्स्ट, GetPlace से मिले display_name से अलग हो सकता है.

अगर input और language_code अलग-अलग भाषाओं में हैं या जगह की स्थानीय भाषा से language_code में अनुवाद उपलब्ध न हो, तो हो सकता है कि अनुरोध मिले-जुले भाषाओं में हो.

structured_format

StructuredFormat

जगह के अनुमान को मुख्य टेक्स्ट में बांटते हुए, जिसमें जगह का नाम शामिल है. साथ ही, ऐसा दूसरा टेक्स्ट जिसमें जगह की साफ़ तौर पर जानकारी देने वाली अन्य सुविधाएं (जैसे कि शहर या इलाका) शामिल हैं.

उन डेवलपर को structured_format का इस्तेमाल करने का सुझाव दिया जाता है जो दो अलग-अलग, लेकिन मिलते-जुलते यूज़र इंटरफ़ेस (यूआई) एलिमेंट दिखाना चाहते हैं. जो डेवलपर सिर्फ़ एक यूज़र इंटरफ़ेस (यूआई) एलिमेंट दिखाना चाहते हैं वे text का इस्तेमाल कर सकते हैं. किसी जगह का अनुमान लगाने के दो अलग-अलग तरीके हैं. उपयोगकर्ताओं को structured_format को text या इस तरह पार्स करने की कोशिश नहीं करनी चाहिए.

types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types में टेबल A या टेबल B से, इस जगह पर लागू होने वाले टाइप की सूची.

टाइप, किसी जगह की कैटगरी है. शेयर किए गए टाइप वाली जगहों की विशेषताएं एक जैसी होंगी.

distance_meters

int32

अगर origin बताया गया है, तो origin से मीटर में जियोडेसिक की लंबाई. ऐसा हो सकता है कि रूट जैसे कुछ अनुमान इस फ़ील्ड में न दिखें.

QueryPrediction

ऑटोकंप्लीट की सुविधा के अनुमान के लिए, अनुमान के नतीजे.

फ़ील्ड
text

FormattableText

अनुमानित टेक्स्ट. यह टेक्स्ट किसी जगह के बारे में नहीं बताता है, बल्कि यह एक ऐसी टेक्स्ट क्वेरी है जिसका इस्तेमाल खोज एंडपॉइंट में किया जा सकता है. उदाहरण के लिए, टेक्स्ट की खोज.

उन डेवलपर को text का इस्तेमाल करने का सुझाव दिया जाता है जो सिर्फ़ एक यूज़र इंटरफ़ेस (यूआई) एलिमेंट दिखाना चाहते हैं. जो डेवलपर दो अलग-अलग, लेकिन मिलते-जुलते यूआई एलिमेंट दिखाना चाहते हैं वे structured_format का इस्तेमाल कर सकते हैं. किसी क्वेरी का अनुमान दिखाने के लिए, ये दो अलग-अलग तरीके हैं. उपयोगकर्ताओं को structured_format को text या इस तरह पार्स करने की कोशिश नहीं करनी चाहिए.

अगर input और language_code अलग-अलग भाषाओं में हैं या क्वेरी के कुछ हिस्से का स्थानीय भाषा से language_code में अनुवाद नहीं है, तो हो सकता है कि यह अनुरोध मिले-जुले भाषाओं में हो.

structured_format

StructuredFormat

क्वेरी के अनुमान को मुख्य टेक्स्ट में बांटते हुए, जिसमें क्वेरी को शामिल किया गया हो. इसके अलावा, ऐसा दूसरा टेक्स्ट जिसमें साफ़ तौर पर जानकारी देने वाली अन्य सुविधाओं (जैसे कि कोई शहर या इलाका) की जानकारी दी गई हो.

उन डेवलपर को structured_format का इस्तेमाल करने का सुझाव दिया जाता है जो दो अलग-अलग, लेकिन मिलते-जुलते यूज़र इंटरफ़ेस (यूआई) एलिमेंट दिखाना चाहते हैं. जो डेवलपर सिर्फ़ एक यूज़र इंटरफ़ेस (यूआई) एलिमेंट दिखाना चाहते हैं वे text का इस्तेमाल कर सकते हैं. किसी क्वेरी का अनुमान दिखाने के लिए, ये दो अलग-अलग तरीके हैं. उपयोगकर्ताओं को structured_format को text या इस तरह पार्स करने की कोशिश नहीं करनी चाहिए.

StringRange

दिए गए टेक्स्ट में किसी सबस्ट्रिंग की पहचान करता है.

फ़ील्ड
start_offset

int32

स्ट्रिंग के पहले यूनिकोड वर्ण का शून्य-आधारित ऑफ़सेट (शामिल).

end_offset

int32

आखिरी यूनिकोड वर्ण का शून्य-आधारित ऑफ़सेट (खास).

StructuredFormat

इसमें किसी जगह या क्वेरी के अनुमान का ब्रेकडाउन, मुख्य टेक्स्ट और सेकंडरी टेक्स्ट में शामिल होता है.

स्थान के पूर्वानुमानों के लिए, मुख्य टेक्स्ट में स्थान का विशिष्ट नाम होता है. क्वेरी के सुझावों के लिए, मुख्य टेक्स्ट में क्वेरी शामिल होती है.

दूसरे टेक्स्ट में, जगह को बेहतर तरीके से पहचानने या क्वेरी को बेहतर बनाने के लिए, ज़्यादा साफ़ तौर पर जानकारी देने वाली सुविधाएं शामिल हैं, जैसे कि शहर या इलाका.

फ़ील्ड
main_text

FormattableText

जगह या क्वेरी के नाम के बारे में बताता है.

secondary_text

FormattableText

जगह की पहचान करने या क्वेरी को बेहतर बनाने के लिए दूसरी सुविधाओं (जैसे कि शहर या क्षेत्र) की जानकारी देता है.

सर्कल

LatLng के केंद्र और त्रिज्या के रूप में एक गोल घेरा.

फ़ील्ड
center

LatLng

ज़रूरी है. बीच का अक्षांश और देशांतर.

अक्षांश की सीमा [-90.0, 90.0] के बीच होनी चाहिए. देशांतर की सीमा [-180.0, 180.0] के बीच होनी चाहिए.

radius

double

ज़रूरी है. मीटर में मापी गई दूरी. दायरा [0.0, 50000.0] के अंदर होना चाहिए.

ContentBlock

कॉन्टेंट का एक ब्लॉक, जिसे अलग-अलग दिखाया जा सकता है.

फ़ील्ड
topic

string

कॉन्टेंट का विषय, जैसे कि "खास जानकारी" या "रेस्टोरेंट".

content

LocalizedText

विषय से जुड़ा कॉन्टेंट.

references

References

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

कॉन्टेंट के इस ब्लॉक से जुड़ी पहचान फ़ाइलें.

ContextualContent

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

जगह से जुड़ी क्वेरी के हिसाब से कॉन्टेंट.

फ़ील्ड
reviews[]

Review

इस जगह की समीक्षाओं की सूची, जगह से जुड़ी क्वेरी से जारी.

photos[]

Photo

इस जगह की फ़ोटो के बारे में जानकारी (इसमें पहचान फ़ाइलें भी शामिल हैं). यह जगह से जुड़ी क्वेरी से जुड़ी है.

justifications[]

Justification

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

जगह के लिए वजहें.

सही ठहराने की वजह

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

जगह के लिए वजहें. वजहों से इस सवाल का जवाब मिलता है कि कोई जगह असली उपयोगकर्ता में दिलचस्पी क्यों ले सकती है.

फ़ील्ड

यूनियन फ़ील्ड justification.

justification इनमें से सिर्फ़ एक हो सकती है:

review_justification

ReviewJustification

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, 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 पर जाएं. BusinessAvailability एट्रिब्यूट की वजहें. यह कारोबार के कुछ ऐसे एट्रिब्यूट दिखाता है जो असली उपयोगकर्ता में दिलचस्पी दिखा सकते हैं.

फ़ील्ड
takeout

bool

अगर कोई रेस्टोरेंट, खाना पैक कराकर ले जाने की सुविधा देता है.

delivery

bool

क्या कोई जगह डिलीवरी की सुविधा देती है.

dine_in

bool

अगर किसी जगह पर बैठकर खाने की सुविधा है.

ReviewJustification

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

उपयोगकर्ता की ओर से की गई समीक्षा की वजहें. यह उपयोगकर्ता की समीक्षा के उस सेक्शन को हाइलाइट करता है जिसमें असली उपयोगकर्ता की दिलचस्पी हो सकती है. उदाहरण के लिए, अगर खोज क्वेरी "फ़ायरवुड पिज़्ज़ा" है, तो क्वेरी के हिसाब से काम के टेक्स्ट को समीक्षा की वजह से हाइलाइट किया जाता है.

फ़ील्ड
highlighted_text

HighlightedText

review

Review

वह समीक्षा जिससे हाइलाइट किया गया टेक्स्ट जनरेट किया गया है.

HighlightedText

वजह के तौर पर हाइलाइट किया गया टेक्स्ट. यह समीक्षा का सबसेट है. हाइलाइट किए जाने वाले सटीक शब्द को SpotlightedTextRange के ज़रिए मार्क किया जाता है. हाइलाइट किए गए टेक्स्ट में कई शब्द हो सकते हैं.

फ़ील्ड
text

string

highlighted_text_ranges[]

HighlightedTextRange

हाइलाइट किए गए टेक्स्ट के रेंज की सूची.

HighlightedTextRange

हाइलाइट किए गए टेक्स्ट की रेंज.

फ़ील्ड
start_index

int32

end_index

int32

EVChargeOptions

जगह पर होस्ट किए गए ईवी चार्ज स्टेशन के बारे में जानकारी. शब्दावली https://afdc.energy.gov/fuels/electricity_infrastructure.html का पालन करती है. एक पोर्ट एक बार में एक कार को चार्ज कर सकता है. एक पोर्ट में एक या उससे ज़्यादा कनेक्टर होते हैं. एक स्टेशन में एक या उससे ज़्यादा पोर्ट हैं.

फ़ील्ड
connector_count

int32

इस स्टेशन पर कनेक्टर की संख्या. हालांकि, कुछ पोर्ट में एक से ज़्यादा कनेक्टर हो सकते हैं, लेकिन एक बार में सिर्फ़ एक कार को चार्ज किया जा सकता है. उदाहरण के लिए, कनेक्टर की संख्या, एक साथ चार्ज होने वाली सभी कारों की कुल संख्या से ज़्यादा हो सकती है.

connector_aggregation[]

ConnectorAggregation

ईवी चार्जिंग कनेक्टर के एग्रीगेशन की सूची, जिसमें एक ही तरह के कनेक्टर और चार्ज रेट एक जैसी होते हैं.

ConnectorAggregation

ईवी के चार्जिंग की जानकारी को [टाइप, max_charge_rate_kw] के हिसाब से ग्रुप में बांटा गया है. यह उन कनेक्टर का ईवी चार्ज एग्रीगेशन दिखाता है जिनका टाइप और चार्ज करने की ज़्यादा से ज़्यादा दर, किलोमीटर में एक जैसी होती है.

फ़ील्ड
type

EVConnectorType

इस एग्रीगेशन का कनेक्टर टाइप.

max_charge_rate_kw

double

एग्रीगेशन में मौजूद हर कनेक्टर के किलोवॉट में, चार्जिंग की ज़्यादा से ज़्यादा स्टैटिक दर.

count

int32

इस एग्रीगेशन में कनेक्टर की संख्या.

availability_last_update_time

Timestamp

वह टाइमस्टैंप जब इस एग्रीगेशन में, कनेक्टर की उपलब्धता की जानकारी को पिछली बार अपडेट किया गया था.

available_count

int32

इस एग्रीगेशन में मौजूद कनेक्टर की संख्या, फ़िलहाल उपलब्ध है.

out_of_service_count

int32

इस एग्रीगेशन में उन कनेक्टर की संख्या जो फ़िलहाल काम नहीं कर रहे हैं.

EVConnectorType

ईवी चार्जिंग कनेक्टर के टाइप के बारे में ज़्यादा जानकारी/कॉन्टेक्स्ट के लिए, http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 पर जाएं.

Enums
EV_CONNECTOR_TYPE_UNSPECIFIED तय नहीं किया गया कनेक्टर.
EV_CONNECTOR_TYPE_OTHER अन्य तरह के कनेक्टर.
EV_CONNECTOR_TYPE_J1772 J1772 टाइप 1 कनेक्टर.
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 टाइप 2 कनेक्टर. इसे अक्सर MENNEKES कहा जाता है.
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO टाइप कनेक्टर.
EV_CONNECTOR_TYPE_CCS_COMBO_1 कंबाइंड चार्जिंग सिस्टम (एसी और डीसी). SAE के आधार पर. टाइप-1 J-1772 कनेक्टर
EV_CONNECTOR_TYPE_CCS_COMBO_2 कंबाइंड चार्जिंग सिस्टम (एसी और डीसी). टाइप-2 Mennekes कनेक्टर के आधार पर
EV_CONNECTOR_TYPE_TESLA सामान्य TESLA कनेक्टर. उत्तरी अमेरिका में यह NACS है, लेकिन दुनिया के दूसरे हिस्सों में यह गैर-NACS भी हो सकता है. जैसे, CCS कॉम्बो 2 (CCS2) या GB/T. यह वैल्यू, असल कनेक्टर के टाइप के बारे में कम जानकारी देती है. साथ ही, इससे Tesla ब्रैंड के वाहन को Tesla ब्रैंड के चार्जिंग स्टेशन पर चार्ज करने की क्षमता के बारे में भी पता चलता है.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T प्रकार चीन के GB/T मानक से मेल खाता है. इस टाइप में सभी GB_T टाइप शामिल हैं.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET दीवार पर लगा पावर सॉकेट की जानकारी नहीं है.

FuelOptions

पेट्रोल पंप में ईंधन के विकल्पों के बारे में सबसे हाल की जानकारी. यह जानकारी नियमित रूप से अपडेट की जाती है.

फ़ील्ड
fuel_prices[]

FuelPrice

इस स्टेशन में मौजूद हर तरह के ईंधन के लिए, ईंधन की आखिरी कीमत क्या है. इस स्टेशन में, हर ईंधन टाइप के लिए एक एंट्री है. ऑर्डर ज़रूरी नहीं है.

FuelPrice

किसी खास टाइप के लिए, ईंधन की कीमत की जानकारी.

फ़ील्ड
type

FuelType

ईंधन का टाइप.

price

Money

ईंधन की कीमत.

update_time

Timestamp

ईंधन की कीमत को पिछली बार अपडेट किए जाने का समय.

FuelType

ईंधन के टाइप.

Enums
FUEL_TYPE_UNSPECIFIED ईंधन के टाइप की जानकारी नहीं है.
DIESEL डीज़ल का ईंधन.
REGULAR_UNLEADED रेगूलर अनलीडेड.
MIDGRADE मिडग्रेड.
PREMIUM प्रीमियम.
SP91 एसपी 91.
SP91_E10 एसपी 91 E10.
SP92 एसपी 92.
SP95 एसपी 95.
SP95_E10 SP95 E10.
SP98 एसपी 98.
SP99 एसपी 99.
SP100 एसपी 100.
LPG एलपीजी.
E80 एपिसोड 80.
E85 एपिसोड 85.
METHANE मीथेन.
BIO_DIESEL बायो-डीज़ल.
TRUCK_DIESEL ट्रक का डीज़ल.

GetPhotoMediaRequest

फ़ोटो संसाधन के नाम का इस्तेमाल करके, किसी जगह की फ़ोटो फ़ेच करने का अनुरोध.

फ़ील्ड
name

string

ज़रूरी है. इस फ़ॉर्मैट में फ़ोटो मीडिया के संसाधन का नाम: places/{place_id}/photos/{photo_reference}/media.

स्थान ऑब्जेक्ट के photos.name फ़ील्ड में लौटाए गए फ़ोटो के संसाधन नाम का फ़ॉर्मैट places/{place_id}/photos/{photo_reference} होता है. फ़ोटो मीडिया संसाधन का नाम पाने के लिए, आपको फ़ोटो संसाधन के आखिर में /media जोड़ना होगा.

max_width_px

int32

ज़रूरी नहीं. इससे पता चलता है कि इमेज की ज़्यादा से ज़्यादा चौड़ाई, पिक्सल में कितनी होनी चाहिए. अगर इमेज तय वैल्यू से छोटी है, तो ओरिजनल इमेज दिखाई जाएगी. अगर इमेज किसी भी डाइमेंशन में बड़ी है, तो उसका साइज़ बदलकर, उसके दोनों डाइमेंशन में से छोटा किया जाएगा. ऐसा सिर्फ़ मूल आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) तक सीमित होगा. max_height_px और max_width_px, दोनों प्रॉपर्टी में 1 से 4,800 के बीच का कोई पूर्णांक स्वीकार किया जाता है. अगर मान अनुमत सीमा के अंदर नहीं है, तो INVALID_LABEL गड़बड़ी दिखाई जाएगी.

कम से कम एक max_height_px या max_width_px मौजूद होना चाहिए. अगर MAX_height_px या max_width_px में से कोई भी पैरामीटर नहीं दिया गया है, तो INVALID_LABEL गड़बड़ी दिखेगी.

max_height_px

int32

ज़रूरी नहीं. इससे इमेज की ज़्यादा से ज़्यादा ऊंचाई, पिक्सल में तय की जाती है. अगर इमेज तय वैल्यू से छोटी है, तो ओरिजनल इमेज दिखाई जाएगी. अगर इमेज किसी भी डाइमेंशन में बड़ी है, तो उसका साइज़ बदलकर, उसके दोनों डाइमेंशन में से छोटा किया जाएगा. ऐसा सिर्फ़ मूल आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) तक सीमित होगा. max_height_px और max_width_px, दोनों प्रॉपर्टी में 1 से 4,800 के बीच का कोई पूर्णांक स्वीकार किया जाता है. अगर मान अनुमत सीमा के अंदर नहीं है, तो INVALID_LABEL गड़बड़ी दिखाई जाएगी.

कम से कम एक max_height_px या max_width_px मौजूद होना चाहिए. अगर MAX_height_px या max_width_px में से कोई भी पैरामीटर नहीं दिया गया है, तो INVALID_LABEL गड़बड़ी दिखेगी.

skip_http_redirect

bool

ज़रूरी नहीं. अगर नीति को सेट किया जाता है, तो डिफ़ॉल्ट एचटीटीपी रीडायरेक्ट बिहेवियर को छोड़ दें और टेक्स्ट फ़ॉर्मैट (उदाहरण के लिए, एचटीटीपी इस्तेमाल के उदाहरण के लिए JSON फ़ॉर्मैट में) रिस्पॉन्स को रेंडर करें. अगर नीति को सेट नहीं किया जाता है, तो कॉल को इमेज मीडिया पर रीडायरेक्ट करने के लिए, एचटीटीपी रीडायरेक्ट जारी किया जाएगा. बिना एचटीटीपी वाले अनुरोधों के लिए, इस विकल्प को अनदेखा किया जाता है.

GetPlaceRequest

किसी जगह को उसके संसाधन नाम के आधार पर फ़ेच करने का अनुरोध, जो places/{place_id} फ़ॉर्मैट की एक स्ट्रिंग है.

फ़ील्ड
name

string

ज़रूरी है. places/{place_id} फ़ॉर्मैट में किसी जगह के संसाधन का नाम.

language_code

string

ज़रूरी नहीं. उपलब्ध होने पर, जगह की जानकारी पसंदीदा भाषा के साथ दिखाई जाएगी.

इस्तेमाल की जा सकने वाली भाषाओं की मौजूदा सूची: https://developers.google.com/maps/faq#languagesupport.

region_code

string

ज़रूरी नहीं. उस जगह का यूनिकोड देश/इलाके का कोड (CLDR) जहां से अनुरोध भेजा जा रहा है. इस पैरामीटर का इस्तेमाल, जगह की जानकारी दिखाने के लिए किया जाता है. जैसे, जगह के हिसाब से जगह का नाम (अगर उपलब्ध हो). पैरामीटर, लागू कानून के आधार पर नतीजों पर असर डाल सकता है. ज़्यादा जानकारी के लिए, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html पर जाएं.

ध्यान दें कि फ़िलहाल तीन अंकों वाले क्षेत्र कोड इस्तेमाल नहीं किए जा सकते.

session_token

string

ज़रूरी नहीं. वह स्ट्रिंग जो बिलिंग के मकसद से, ऑटोकंप्लीट सेशन की पहचान करती है. यह एक यूआरएल और फ़ाइल नाम वाली सेफ़ base64 स्ट्रिंग होनी चाहिए, जिसमें ज़्यादा से ज़्यादा 36 ASCII वर्ण हों. अगर ऐसा नहीं होता है, तो एक INVALID_LABEL गड़बड़ी मिलती है.

सेशन तब शुरू होता है, जब उपयोगकर्ता कोई क्वेरी टाइप करना शुरू करता है और जगह चुनने के बाद जगह की जानकारी या पते की पुष्टि करने के लिए कॉल पूरा करता है. हर सेशन में कई क्वेरी हो सकती हैं. इसके बाद, जगह की जानकारी या पते की पुष्टि करने का एक अनुरोध हो सकता है. किसी सेशन में हर अनुरोध के लिए इस्तेमाल किए जाने वाले क्रेडेंशियल, एक ही Google Cloud Console प्रोजेक्ट से जुड़े होने चाहिए. सेशन खत्म होने के बाद, टोकन मान्य नहीं रहता. आपके ऐप्लिकेशन को हर सेशन के लिए नया टोकन जनरेट करना होगा. अगर session_token पैरामीटर हटाया जाता है या किसी सेशन टोकन का फिर से इस्तेमाल किया जाता है, तो सेशन से इस तरह शुल्क लिया जाता है जैसे कोई सेशन टोकन नहीं दिया गया था. हर अनुरोध का बिल अलग से लिया जाता है.

हमारा सुझाव है कि आप नीचे दिए गए दिशा-निर्देशों का पालन करें:

  • ऑटोकंप्लीट की सुविधा वाले सभी कॉल के लिए, सेशन टोकन का इस्तेमाल करें.
  • हर सेशन के लिए नया टोकन जनरेट करें. हमारा सुझाव है कि आप वर्शन 4 के यूयूआईडी का इस्तेमाल करें.
  • पक्का करें कि किसी सेशन में, जगह की जानकारी अपने-आप पूरी होने, जगह की जानकारी, और पते की पुष्टि करने के सभी अनुरोधों के लिए इस्तेमाल किए गए क्रेडेंशियल, एक ही Cloud Console प्रोजेक्ट से जुड़े हों.
  • हर नए सेशन के लिए एक यूनीक सेशन टोकन पास करना न भूलें. एक से ज़्यादा सेशन के लिए एक ही टोकन का इस्तेमाल करने से, हर अनुरोध की बिलिंग अलग-अलग होगी.

फ़ोटो

किसी जगह की फ़ोटो के बारे में जानकारी.

फ़ील्ड
name

string

आइडेंटिफ़ायर. इस जगह की फ़ोटो को दिखाने वाला एक रेफ़रंस, जिसका इस्तेमाल इस जगह की फ़ोटो को दोबारा देखने के लिए किया जा सकता है. इसे एपीआई "संसाधन" नाम भी कहा जाता है: places/{place_id}/photos/{photo}.

width_px

int32

पिक्सल में उपलब्ध ज़्यादा से ज़्यादा चौड़ाई.

height_px

int32

पिक्सल में ज़्यादा से ज़्यादा उपलब्ध ऊंचाई.

author_attributions[]

AuthorAttribution

इस फ़ोटो के लेखक.

PhotoMedia

Places API का फ़ोटो मीडिया.

फ़ील्ड
name

string

इस फ़ॉर्मैट में फ़ोटो मीडिया के संसाधन का नाम: places/{place_id}/photos/{photo_reference}/media.

photo_uri

string

कुछ समय के लिए रहने वाला यूआरआई, जिसका इस्तेमाल फ़ोटो को रेंडर करने के लिए किया जा सकता है.

जगह

किसी स्थान का प्रतिनिधित्व करने वाली सभी जानकारी.

फ़ील्ड
name

string

इस जगह के संसाधन का नाम, places/{place_id} फ़ॉर्मैट में. स्थान को खोजने के लिए उपयोग किया जा सकता है.

id

string

किसी जगह का यूनीक आइडेंटिफ़ायर.

display_name

LocalizedText

जगह का स्थानीय नाम, जो किसी ऐसे ब्यौरे के तौर पर लिखा हो जिसे कोई भी व्यक्ति आसानी से पढ़ सके. उदाहरण के लिए, "Google Sydney", "Starbucks", "Pirमॉन्ट" वगैरह.

types[]

string

इस नतीजे के लिए टैग के टाइप का सेट. उदाहरण के लिए, "राजनैतिक" और "इलाका". संभावित वैल्यू की पूरी सूची देखने के लिए, https://developers.google.com/maps/documentation/places/web-service/place-types पर जाकर, टेबल A और टेबल B देखें

primary_type

string

दिए गए नतीजे का मुख्य टाइप. इस तरह के लिए, Places API के साथ काम करने वाले टाइप में से कोई एक होना ज़रूरी है. उदाहरण के लिए, "रेस्टोरेंट", "कैफ़े", "हवाई अड्डा" वगैरह. किसी जगह के लिए, सिर्फ़ एक मुख्य टाइप का इस्तेमाल किया जा सकता है. संभावित वैल्यू की पूरी सूची देखने के लिए, https://developers.google.com/maps/documentation/places/web-service/place-types पर जाकर, टेबल A और टेबल B देखें

primary_type_display_name

LocalizedText

मुख्य तरह का डिसप्ले नेम, अगर लागू हो, तो अनुरोध की भाषा के हिसाब से स्थानीय भाषा में लिखा जाता है. संभावित वैल्यू की पूरी सूची देखने के लिए, https://developers.google.com/maps/documentation/places/web-service/place-types पर जाकर, टेबल A और टेबल B देखें

national_phone_number

string

राष्ट्रीय फ़ॉर्मैट में किसी जगह का ऐसा फ़ोन नंबर जिसे कोई भी व्यक्ति आसानी से पढ़ सके.

international_phone_number

string

अंतरराष्ट्रीय फ़ॉर्मैट में किसी जगह का ऐसा फ़ोन नंबर जिसे कोई भी व्यक्ति आसानी से पढ़ सके.

formatted_address

string

इस जगह का पूरा पता, जिसे कोई भी व्यक्ति आसानी से पढ़ सके.

short_formatted_address

string

इस जगह का छोटा और पढ़ा जा सकने वाला पता.

address_components[]

AddressComponent

हर शहर के लेवल के लिए, दोहराए गए कॉम्पोनेंट. address_segments[] अरे के बारे में नीचे दिए गए तथ्यों पर ध्यान दें: - पते के कॉम्पोनेंट की कलेक्शन में, format_address से ज़्यादा कॉम्पोनेंट हो सकते हैं. - ज़रूरी नहीं है कि कलेक्शन में वे सभी राजनैतिक इकाइयां शामिल हों जिनमें कोई पता मौजूद है. हालांकि, format_address में दी गई राजनैतिक इकाइयों को शामिल नहीं किया जा सकता. किसी खास पते वाली सभी राजनैतिक इकाइयों को वापस पाने के लिए, आपको अनुरोध के पैरामीटर के तौर पर पते के अक्षांश/देशांतर को पास करते हुए, रिवर्स जियोकोडिंग का इस्तेमाल करना चाहिए. - इस बात की कोई गारंटी नहीं है कि अनुरोधों के बीच रिस्पॉन्स का फ़ॉर्मैट एक जैसा रहेगा. खास तौर पर, address_components की संख्या अनुरोध किए गए पते के आधार पर अलग-अलग होती है. साथ ही, इसमें एक ही पते के लिए समय के साथ बदलाव हो सकता है. कोई कॉम्पोनेंट, अरे में उसकी पोज़िशन बदल सकता है. कॉम्पोनेंट का टाइप बदल सकता है. ऐसा हो सकता है कि बाद के जवाब में कोई खास कॉम्पोनेंट मौजूद न हो.

plus_code

PlusCode

जगह की जानकारी के अक्षांश/देशांतर का प्लस कोड.

location

LatLng

इस जगह की स्थिति.

viewport

Viewport

औसत आकार के मैप पर किसी जगह को दिखाने के लिए सही व्यूपोर्ट.

rating

double

इस जगह की उपयोगकर्ताओं की समीक्षाओं के आधार पर, 1.0 और 5.0 के बीच की रेटिंग.

google_maps_uri

string

इस जगह के बारे में ज़्यादा जानकारी देने वाला यूआरएल.

website_uri

string

इस जगह के लिए आधिकारिक वेबसाइट, जैसे कि किसी कारोबार का होम पेज. ध्यान दें कि किसी चेन (जैसे, IKEA स्टोर) की जो जगहें हैं, उनके लिए आम तौर पर यह वेबसाइट, अलग-अलग स्टोर की होगी, न कि पूरी चेन.

reviews[]

Review

इस जगह की समीक्षाओं की सूची, जो ज़रूरत के मुताबिक क्रम में लगाई गई है. ज़्यादा से ज़्यादा पांच समीक्षाएं दिखाई जा सकती हैं.

regular_opening_hours

OpeningHours

कामकाज के नियमित घंटे.

photos[]

Photo

इस जगह की फ़ोटो की जानकारी (इसमें रेफ़रंस भी शामिल हैं). ज़्यादा से ज़्यादा 10 फ़ोटो वापस की जा सकती हैं.

adr_format_address

string

एडीआर माइक्रोफ़ॉर्मैट में जगह का पता: http://microformats.org/wiki/adr.

business_status

BusinessStatus

किसी जगह के लिए कारोबार की स्थिति.

price_level

PriceLevel

स्थान का मूल्य स्तर.

attributions[]

Attribution

डेटा उपलब्ध कराने वाली कंपनी का सेट, जिसे इस नतीजे के साथ दिखाया जाना चाहिए.

icon_mask_base_uri

string

आइकॉन मास्क के यूआरएल में काट-छांट की गई. उपयोगकर्ता, आखिर में ".svg" या ".png" टाइप का सफ़िक्स जोड़कर, अलग-अलग आइकॉन टाइप को ऐक्सेस कर सकता है.

icon_background_color

string

हेक्स फ़ॉर्मैट में icon_mask के बैकग्राउंड का रंग, जैसे कि #909CE1.

current_opening_hours

OpeningHours

अगले सात दिनों (आज के दिन को भी) में कारोबार के खुले रहने का समय. समयावधि, अनुरोध किए जाने वाले दिन को आधी रात को शुरू होती है और छह दिन बाद रात 11:59 बजे खत्म होती है. इस फ़ील्ड में सभी घंटों का विशेष_दिन सबफ़ील्ड शामिल होता है, जो विशेष घंटों वाली तारीखों के लिए सेट होता है.

current_secondary_opening_hours[]

OpeningHours

इसमें अगले सात दिनों की एंट्री शामिल होती है. इसमें किसी कारोबार के सेकंडरी घंटों की जानकारी भी शामिल होती है. दूसरे कारोबार के खुले होने का समय, कारोबार के मुख्य घंटों से अलग होता है. उदाहरण के लिए, कोई रेस्टोरेंट कारोबार के खुले होने का समय या डिलीवरी के खुले होने का समय, दूसरे समय के तौर पर बता सकता है. यह फ़ील्ड, टाइप सबफ़ील्ड को पॉप्युलेट करता है, जो जगह के टाइप के आधार पर, कारोबार के खुले होने के समय के पहले से तय किए गए टाइप (जैसे, DRIVE_ एलान, PICKUP या TakeOUT) से लिया जाता है. इस फ़ील्ड में सभी घंटों का विशेष_दिन सबफ़ील्ड शामिल होता है, जो विशेष घंटों वाली तारीखों के लिए सेट होता है.

regular_secondary_opening_hours[]

OpeningHours

इसमें किसी कारोबार के नियमित माध्यमिक घंटों के बारे में जानकारी के लिए एंट्री का कलेक्शन होता है. दूसरे कारोबार के खुले होने का समय, कारोबार के मुख्य घंटों से अलग होता है. उदाहरण के लिए, कोई रेस्टोरेंट कारोबार के खुले होने का समय या डिलीवरी के खुले होने का समय, दूसरे समय के तौर पर बता सकता है. यह फ़ील्ड, टाइप सबफ़ील्ड को पॉप्युलेट करता है, जो जगह के टाइप के आधार पर, कारोबार के खुले होने के समय के पहले से तय किए गए टाइप (जैसे, DRIVE_ एलान, PICKUP या TakeOUT) से लिया जाता है.

editorial_summary

LocalizedText

इसमें जगह की खास जानकारी होती है. खास जानकारी में टेक्स्ट के तौर पर खास जानकारी शामिल होती है. अगर लागू हो, तो उसका भाषा कोड भी शामिल होता है. खास जानकारी वाले टेक्स्ट को इसी रूप में दिखाया जाना चाहिए. इसमें न तो बदलाव किया जा सकता है और न ही इसे बदला जा सकता है.

payment_options

PaymentOptions

पेमेंट के ऐसे विकल्प जिन्हें रेस्टोरेंट स्वीकार करता है. अगर पेमेंट के विकल्प का डेटा उपलब्ध नहीं है, तो पेमेंट के विकल्प वाले फ़ील्ड को सेट नहीं किया जाएगा.

parking_options

ParkingOptions

पार्किंग के विकल्प, जगह के हिसाब से दिए गए हैं.

sub_destinations[]

SubDestination

किसी जगह से जुड़े सब-डेस्टिनेशन की सूची.

fuel_options

FuelOptions

पेट्रोल पंप में ईंधन के विकल्पों के बारे में सबसे हाल की जानकारी. यह जानकारी नियमित रूप से अपडेट की जाती है.

ev_charge_options

EVChargeOptions

ईवी चार्जिंग के विकल्पों की जानकारी.

generative_summary

GenerativeSummary

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

एआई से किसी जगह की खास जानकारी.

area_summary

AreaSummary

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

जिस इलाके में जगह मौजूद है उसके बारे में एआई से जनरेट की गई खास जानकारी.

utc_offset_minutes

int32

इस जगह के टाइमज़ोन के मिनट की संख्या, फ़िलहाल यूटीसी से ऑफ़सेट की गई है. यह उन टाइमज़ोन को दिखाने के लिए मिनट में दिखाया जाता है जो एक घंटे के हिस्सों से ऑफ़सेट होते हैं. उदाहरण के लिए, X घंटे और 15 मिनट.

user_rating_count

int32

इस जगह के लिए टेक्स्ट या बिना टेक्स्ट वाली समीक्षाओं की कुल संख्या.

takeout

bool

इससे पता चलता है कि कारोबार, टेकआउट की सुविधा देता है या नहीं.

delivery

bool

इससे पता चलता है कि कारोबार, डिलीवरी की सुविधा देता है या नहीं.

dine_in

bool

इससे पता चलता है कि कारोबार के लिए, अंदर या बाहर बैठने की सुविधा है या नहीं.

curbside_pickup

bool

इससे पता चलता है कि कारोबार, कर्बसाइड पिक अप की सुविधा देता है या नहीं.

reservable

bool

इससे पता चलता है कि जगह में बुकिंग की सुविधा है या नहीं.

serves_breakfast

bool

इससे पता चलता है कि इस जगह पर नाश्ता परोसा जाता है या नहीं.

serves_lunch

bool

बताएं कि इस जगह पर लंच परोसा जाता है या नहीं.

serves_dinner

bool

इससे पता चलता है कि इस जगह पर डिनर परोसा जाता है या नहीं.

serves_beer

bool

इससे पता चलता है कि यहां बीयर परोसी जाती है या नहीं.

serves_wine

bool

इससे पता चलता है कि उस जगह पर वाइन मिलती है या नहीं.

serves_brunch

bool

इससे पता चलता है कि इस जगह पर ब्रंच मिलता है या नहीं.

serves_vegetarian_food

bool

इससे पता चलता है कि यहां शाकाहारी खाना मिलता है या नहीं.

outdoor_seating

bool

जगह में बाहर बैठने की सुविधा है.

live_music

bool

यहां लाइव संगीत की सुविधा है.

menu_for_children

bool

जगह में बच्चों के लिए मेन्यू है.

serves_cocktails

bool

यहां कॉकटेल परोसे जाते हैं.

serves_dessert

bool

जगह पर मिठाइयां मिलती हैं.

serves_coffee

bool

यहां कॉफ़ी मिलती है.

good_for_children

bool

यह स्थान बच्चों के लिए अच्छा है.

allows_dogs

bool

यहां कुत्तों को अंदर ले जाने की अनुमति है.

restroom

bool

जगह में शौचालय है.

good_for_groups

bool

इस जगह पर, ग्रुप में रह सकते हैं.

good_for_watching_sports

bool

यह स्थान खेल देखने के लिए उपयुक्त है.

accessibility_options

AccessibilityOptions

किसी जगह की ओर से दिए जाने वाले सुलभता विकल्पों के बारे में जानकारी.

AccessibilityOptions

किसी जगह की ओर से दिए जाने वाले सुलभता विकल्पों के बारे में जानकारी.

फ़ील्ड
wheelchair_accessible_parking

bool

यहां व्हीलचेयर सुलभ पार्किंग है.

wheelchair_accessible_entrance

bool

इन जगहों पर व्हीलचेयर ले जाने की सुविधा है.

wheelchair_accessible_restroom

bool

यहां व्हीलचेयर से जा सकने लायक शौचालय है.

wheelchair_accessible_seating

bool

इस स्थान पर व्हीलचेयर सुलभ सीटिंग है.

AddressComponent

अगर यह जानकारी उपलब्ध है, तो स्ट्रक्चर्ड कॉम्पोनेंट, जो फ़ॉर्मैट किया गया पता बनाते हैं.

फ़ील्ड
long_text

string

पते के कॉम्पोनेंट का पूरा टेक्स्ट ब्यौरा या नाम. उदाहरण के लिए, ऑस्ट्रेलिया देश के पते के कॉम्पोनेंट में, "ऑस्ट्रेलिया" का long_name नाम हो सकता है.

short_text

string

अगर उपलब्ध हो, तो पता कॉम्पोनेंट का छोटा टेक्स्ट नाम. उदाहरण के लिए, ऑस्ट्रेलिया देश के पते के कॉम्पोनेंट में, "AU" का छोटा नाम हो सकता है.

types[]

string

पता कॉम्पोनेंट के टाइप दिखाने वाला कलेक्शन.

language_code

string

इस कॉम्पोनेंट को CLDR नोटेशन में फ़ॉर्मैट करने के लिए इस्तेमाल की गई भाषा.

AreaSummary

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

जिस इलाके में जगह मौजूद है उसके बारे में एआई से जनरेट की गई खास जानकारी.

फ़ील्ड
content_blocks[]

ContentBlock

कॉन्टेंट ब्लॉक, जो एरिया की खास जानकारी लिखते हैं. हर ब्लॉक में एरिया के बारे में अलग विषय होते हैं.

एट्रिब्यूशन

इस जगह के डेटा देने वालों के बारे में जानकारी.

फ़ील्ड
provider

string

जगह का डेटा मुहैया कराने वाली कंपनी का नाम.

provider_uri

string

जगह की जानकारी देने वाली कंपनी का यूआरआई.

BusinessStatus

किसी जगह के लिए कारोबार की स्थिति.

Enums
BUSINESS_STATUS_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
OPERATIONAL संस्थान चालू है, ज़रूरी नहीं है कि अभी खुला हो.
CLOSED_TEMPORARILY यह कारोबार कुछ समय के लिए बंद है.
CLOSED_PERMANENTLY होटल हमेशा के लिए बंद हो गया है.

GenerativeSummary

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

एआई से किसी जगह की खास जानकारी.

फ़ील्ड
overview

LocalizedText

जगह की खास जानकारी.

description

LocalizedText

जगह के बारे में पूरी जानकारी.

references

References

ऐसे रेफ़रंस जिनका इस्तेमाल खास जानकारी जनरेट करने के लिए किया जाता है.

OpeningHours

कारोबार के खुले होने के समय की जानकारी.

फ़ील्ड
periods[]

Period

हफ़्ते के दौरान, इस जगह के खुले रहने का समय. समयावधि, समय के हिसाब से क्रम में हैं. इसकी शुरुआत स्थानीय टाइमज़ोन के हिसाब से रविवार से होती है. अगर वैल्यू खाली है, लेकिन यह मौजूद नहीं है, तो इसका मतलब है कि वह जगह कभी खुली नहीं थी. उदाहरण के लिए, उस जगह को रेनोवेशन के लिए कुछ समय के लिए बंद कर दिया गया है.

weekday_descriptions[]

string

स्थानीय जगह के अनुसार स्ट्रिंग, जो इस जगह के खुले होने के समय की जानकारी देती है. हफ़्ते के हर दिन के लिए एक स्ट्रिंग. अगर समय की जानकारी नहीं है या स्थानीय जगह के अनुसार टेक्स्ट में नहीं बदला जा सका, तो फ़ील्ड खाली रहेगा. उदाहरण: "रवि: 18:00–06:00"

secondary_hours_type

SecondaryHoursType

यह किस तरह की स्ट्रिंग है, इसका इस्तेमाल सेकंडरी घंटों के बारे में बताने के लिए किया जाता है.

special_days[]

SpecialDay

कारोबार के खुले होने के समय की समयसीमा के अंदर आने वाले खास दिनों के लिए स्ट्रक्चर्ड जानकारी. खास दिनों को ऐसे दिन कहा जाता है जिनसे किसी जगह के कारोबार के खुले होने के समय पर असर पड़ सकता है, जैसे कि क्रिसमस. अगर खास घंटे हों, तो मौजूदा_opening_hours और मौजूदा_secondary_opening_hours के लिए सेट करें.

open_now

bool

क्या यह जगह अभी खुली है? अगर हमारे पास कारोबार के खुले होने के समय का डेटा या टाइमज़ोन नहीं है, तो यह जानकारी हमेशा मौजूद रहती है.

समयावधि

वह समय जब जगह Open_now स्थिति में बनी रहती है.

फ़ील्ड
open

Point

वह समय जब जगह चालू हो जाती है.

close

Point

वह समय जब जगह बंद होना शुरू होती है.

पॉइंट

स्टेटस बदलने के पॉइंट.

फ़ील्ड
date

Date

जगह के स्थानीय टाइमज़ोन में तारीख.

truncated

bool

इस एंडपॉइंट में काट-छांट की गई थी या नहीं. काट-छांट की जाती है जब वास्तविक घंटे उस समय से बाहर होते हैं जब हम बीच के समय में होने वाले घंटों को लौटाने के लिए तैयार होते हैं, इसलिए हम घंटों को इन सीमाओं में ही काट देते हैं. इससे यह पक्का होता है कि अनुरोध वाले दिन आधी रात से ज़्यादा से ज़्यादा 24 * 7 घंटे के अंदर जवाब वापस मिल जाए.

day

int32

हफ़्ते का कोई दिन, पूर्णांक के तौर पर 0 से 6 की रेंज में. 0 रविवार है, 1 सोमवार है वगैरह.

hour

int32

घंटा, 2 अंकों में. यह 00 से 23 तक होता है.

minute

int32

मिनट के तौर पर दो अंकों में. यह 00 से 59 तक होता है.

SecondaryHoursType

सेकंडरी घंटों के टाइप की पहचान करने के लिए इस्तेमाल किया जाने वाला टाइप.

Enums
SECONDARY_HOURS_TYPE_UNSPECIFIED दूसरे घंटे का टाइप न होने पर, डिफ़ॉल्ट वैल्यू तय की जाती है.
DRIVE_THROUGH बैंक, रेस्टोरेंट, और फ़ार्मेसी के लिए ड्राइव-थ्रू घंटा.
HAPPY_HOUR हैपी आवर.
DELIVERY डिलीवरी का समय.
TAKEOUT खाना पैक कराकर ले जाने का समय.
KITCHEN रसोई का समय.
BREAKFAST नाश्ते का समय.
LUNCH लंच का समय.
DINNER डिनर का समय.
BRUNCH ब्रंच का समय.
PICKUP पिकअप का समय.
ACCESS स्टोरेज की जगहों के लिए ऐक्सेस का समय.
SENIOR_HOURS वरिष्ठ लोगों के लिए विशेष घंटे.
ONLINE_SERVICE_HOURS ऑनलाइन सेवा के खुले होने का समय.

SpecialDay

कारोबार के खुले होने के समय की समयसीमा के अंदर आने वाले खास दिनों के लिए स्ट्रक्चर्ड जानकारी. खास दिनों को ऐसे दिन कहा जाता है जिनसे किसी जगह के कारोबार के खुले होने के समय पर असर पड़ सकता है, जैसे कि क्रिसमस.

फ़ील्ड
date

Date

इस खास दिन की तारीख.

ParkingOptions

स्थान के लिए पार्किंग विकल्पों के बारे में जानकारी. पार्किंग की जगह पर एक ही समय में एक से ज़्यादा विकल्प हो सकते हैं.

फ़ील्ड
free_parking_lot

bool

यहां मुफ़्त पार्किंग की सुविधा है.

paid_parking_lot

bool

यहां पार्किंग के लिए अलग से पैसे देने होंगे.

free_street_parking

bool

यहां सड़क के किनारे मुफ़्त पार्किंग की सुविधा है.

paid_street_parking

bool

यहां सड़क के किनारे पार्किंग की सुविधा है. इसके लिए, अलग से पैसे देने होंगे.

valet_parking

bool

यहां वैले पार्किंग की सुविधा है.

free_garage_parking

bool

यहां गराज में मुफ़्त पार्किंग की सुविधा है.

paid_garage_parking

bool

यहां गराज में पार्किंग की सुविधा है, जिसके लिए अलग से पैसे देने होंगे.

PaymentOptions

पेमेंट के ऐसे विकल्प जिन्हें रेस्टोरेंट स्वीकार करता है.

फ़ील्ड
accepts_credit_cards

bool

स्थान भुगतान के रूप में क्रेडिट कार्ड स्वीकार करता है.

accepts_debit_cards

bool

स्थान भुगतान के रूप में डेबिट कार्ड स्वीकार करता है.

accepts_cash_only

bool

स्थान भुगतान के रूप में केवल नकद ही स्वीकार करता है. जिन जगहों पर यह एट्रिब्यूट है वे अब भी पेमेंट के अन्य तरीके स्वीकार कर सकते हैं.

accepts_nfc

bool

स्थान एनएफ़सी पेमेंट स्वीकार करता है.

PlusCode

प्लस कोड (http://plus.codes) दो फ़ॉर्मैट वाली, जगह की जानकारी का रेफ़रंस होता है: एक ग्लोबल कोड जो 14mx14m (डिग्री का 1/8000वां) या छोटा रेक्टैंगल तय करता है. साथ ही, कंपाउंड कोड, प्रीफ़िक्स की जगह रेफ़रंस ले लेता है.

फ़ील्ड
global_code

string

जगह का ग्लोबल (फ़ुल) कोड, जैसे कि "9FWM33GV+HQ", 1/8000 गुणा 1/8000 डिग्री क्षेत्र (~14 गुणा 14 मीटर) को दर्शाता है.

compound_code

string

जगह का कंपाउंड कोड, जैसे कि "33GV+HQ, Ramberg, Norway" जिसमें ग्लोबल कोड का सफ़िक्स शामिल है और प्रीफ़िक्स को किसी रेफ़रंस इकाई के फ़ॉर्मैट किए गए नाम से बदला गया है.

SubDestination

जगह से जुड़े उप-डेस्टिनेशन के संसाधन का नाम और आईडी. उदाहरण के लिए, किसी हवाई अड्डे के अलग-अलग टर्मिनल अलग-अलग होते हैं.

फ़ील्ड
name

string

सब-डेस्टिनेशन के संसाधन का नाम.

id

string

सब-डेस्टिनेशन का जगह का आईडी.

PriceLevel

स्थान का मूल्य स्तर.

Enums
PRICE_LEVEL_UNSPECIFIED स्थान मूल्य स्तर अनिर्दिष्ट या अज्ञात है.
PRICE_LEVEL_FREE स्थान मुफ़्त सेवाएं देता है.
PRICE_LEVEL_INEXPENSIVE यहां सस्ती सेवाएं दी जाती हैं.
PRICE_LEVEL_MODERATE जगह से, थोड़े-बहुत पैसे देकर ली जाने वाली सेवाएं दी जाती हैं.
PRICE_LEVEL_EXPENSIVE यहां महंगी सेवाएं दी जाती हैं.
PRICE_LEVEL_VERY_EXPENSIVE यहां बहुत महंगी सेवाएं मिलती हैं.

रेफ़रंस

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

इस जानकारी से पता चलता है कि जनरेटिव कॉन्टेंट इससे जुड़ा है.

फ़ील्ड
reviews[]

Review

ऐसी समीक्षाएं जो रेफ़रंस के तौर पर काम करती हैं.

places[]

string

रेफ़र की गई जगहों के संसाधनों के नाम की सूची. इस नाम का इस्तेमाल ऐसे अन्य एपीआई में किया जा सकता है जो जगह से जुड़े संसाधन के नाम स्वीकार करते हैं.

देखें

किसी जगह की समीक्षा के बारे में जानकारी.

फ़ील्ड
name

string

इस जगह की समीक्षा के बारे में बताने वाला रेफ़रंस, जिसका इस्तेमाल इस जगह की समीक्षा को फिर से देखने के लिए किया जा सकता है. इसे एपीआई का "संसाधन" नाम भी कहा जाता है: places/{place_id}/reviews/{review}.

relative_publish_time_description

string

हाल ही के समय का फ़ॉर्मैट किया गया स्ट्रिंग. इसमें भाषा और देश के हिसाब से, मौजूदा समय से जुड़ी समीक्षा में लगने वाला समय दिखाया जाता है.

text

LocalizedText

समीक्षा का स्थानीय भाषा में लिखा हुआ टेक्स्ट.

original_text

LocalizedText

समीक्षा टेक्स्ट उसकी मूल भाषा में हो.

rating

double

1.0 और 5.0 के बीच की कोई संख्या, जिसे तारों की संख्या भी कहा जाता है.

author_attribution

AuthorAttribution

इस समीक्षा का लेखक.

publish_time

Timestamp

समीक्षा के लिए टाइमस्टैंप.

SearchNearbyRequest

Nearby Search के लिए प्रोटो का अनुरोध करें.

फ़ील्ड
language_code

string

उपलब्ध होने पर, जगह की जानकारी पसंदीदा भाषा के साथ दिखाई जाएगी. अगर भाषा का कोड नहीं दिया गया है या उसकी पहचान नहीं की गई है, तो किसी भी भाषा की जगह की जानकारी दी जा सकती है. हालांकि, ऐसा होने पर, अंग्रेज़ी को प्राथमिकता दी जा सकती है.

इस्तेमाल की जा सकने वाली भाषाओं की मौजूदा सूची: https://developers.google.com/maps/faq#languagesupport.

region_code

string

उस जगह का यूनिकोड देश/इलाके का कोड (CLDR) जहां से अनुरोध भेजा जा रहा है. इस पैरामीटर का इस्तेमाल, जगह की जानकारी दिखाने के लिए किया जाता है. जैसे, जगह के हिसाब से जगह का नाम (अगर उपलब्ध हो). पैरामीटर, लागू कानून के आधार पर नतीजों पर असर डाल सकता है.

ज़्यादा जानकारी के लिए, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html पर जाएं.

ध्यान दें कि फ़िलहाल तीन अंकों वाले क्षेत्र कोड इस्तेमाल नहीं किए जा सकते.

included_types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types से शामिल की गई जगह का टाइप (जैसे, "रेस्टोरेंट" या "gas_station").

टेबल A में ज़्यादा से ज़्यादा 50 टाइप के बारे में बताया जा सकता है.

अगर कोई कॉन्फ़्लिक्टिंग टाइप मौजूद है, यानी कि शामिल है_टाइप और शामिल नहीं किए गए टाइप, दोनों में कोई टाइप दिखता है, तो INVALID_LABEL गड़बड़ी दिखाई जाती है.

अगर किसी जगह के टाइप के लिए अलग-अलग तरह की पाबंदियां लगाई गई हैं, तो सिर्फ़ वही जगहें दिखाई जाती हैं जो सभी पाबंदियों की शर्तें पूरी करती हों. उदाहरण के लिए, अगर हमारे पास {included_types = ["restaurant"],excluded_primary_types = ["restaurant"]} हैं, तो दिखाई गई जगहें "रेस्टोरेंट" से जुड़ी सेवाएं उपलब्ध कराती हैं, लेकिन मुख्य रूप से "रेस्टोरेंट" के तौर पर काम नहीं करतीं.

excluded_types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types से बाहर रखी गई जगह (जैसे, "रेस्टोरेंट" या "gas_station").

टेबल A में ज़्यादा से ज़्यादा 50 टाइप के बारे में बताया जा सकता है.

अगर क्लाइंट शामिल_टाइप (जैसे कि रेस्टोरेंट) और शामिल नहीं किए गए टाइप (जैसे, कैफ़े) दोनों उपलब्ध कराता है, तो जवाब में उन जगहों की जानकारी शामिल होनी चाहिए जो रेस्टोरेंट हैं, न कि कैफ़े. इस जवाब में ऐसी जगहें शामिल होती हैं जो कम से कम किसी एक include_types से मेल खाती हैं और किसी भी क्वेरी से मेल नहीं खाती हैं.

अगर कोई कॉन्फ़्लिक्टिंग टाइप मौजूद है, यानी कि शामिल है_टाइप और शामिल नहीं किए गए टाइप, दोनों में कोई टाइप दिखता है, तो INVALID_LABEL गड़बड़ी दिखाई जाती है.

अगर किसी जगह के टाइप के लिए अलग-अलग तरह की पाबंदियां लगाई गई हैं, तो सिर्फ़ वही जगहें दिखाई जाती हैं जो सभी पाबंदियों की शर्तें पूरी करती हों. उदाहरण के लिए, अगर हमारे पास {included_types = ["restaurant"],excluded_primary_types = ["restaurant"]} हैं, तो दिखाई गई जगहें "रेस्टोरेंट" से जुड़ी सेवाएं उपलब्ध कराती हैं, लेकिन मुख्य रूप से "रेस्टोरेंट" के तौर पर काम नहीं करतीं.

included_primary_types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types से मुख्य जगह का टाइप (जैसे, "रेस्टोरेंट" या "gas_station") शामिल किया गया है. किसी जगह के साथ काम करने वाली टाइप की टेबल में से, सिर्फ़ एक प्राइमरी टाइप हो सकता है.

टेबल A में ज़्यादा से ज़्यादा 50 टाइप के बारे में बताया जा सकता है.

अगर कोई गड़बड़ी वाला प्राइमरी टाइप है, यानी कि शामिल किया गया कोई प्राइमरी टाइप है, तो include_primary_types और शामिल_primary_types दोनों में कोई टाइप है. इस टाइप की वैल्यू में, INVALID_LABEL गड़बड़ी दिखती है.

अगर किसी जगह के टाइप के लिए अलग-अलग तरह की पाबंदियां लगाई गई हैं, तो सिर्फ़ वही जगहें दिखाई जाती हैं जो सभी पाबंदियों की शर्तें पूरी करती हों. उदाहरण के लिए, अगर हमारे पास {included_types = ["restaurant"],excluded_primary_types = ["restaurant"]} हैं, तो दिखाई गई जगहें "रेस्टोरेंट" से जुड़ी सेवाएं उपलब्ध कराती हैं, लेकिन मुख्य रूप से "रेस्टोरेंट" के तौर पर काम नहीं करतीं.

excluded_primary_types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types से बाहर रखी गई जगह का मुख्य टाइप (जैसे, "रेस्टोरेंट" या "gas_station").

टेबल A में ज़्यादा से ज़्यादा 50 टाइप के बारे में बताया जा सकता है.

अगर कोई गड़बड़ी वाला प्राइमरी टाइप है, यानी कि शामिल किया गया कोई प्राइमरी टाइप है, तो include_primary_types और शामिल_primary_types दोनों में कोई टाइप है. इस टाइप की वैल्यू में, INVALID_LABEL गड़बड़ी दिखती है.

अगर किसी जगह के टाइप के लिए अलग-अलग तरह की पाबंदियां लगाई गई हैं, तो सिर्फ़ वही जगहें दिखाई जाती हैं जो सभी पाबंदियों की शर्तें पूरी करती हों. उदाहरण के लिए, अगर हमारे पास {included_types = ["restaurant"],excluded_primary_types = ["restaurant"]} हैं, तो दिखाई गई जगहें "रेस्टोरेंट" से जुड़ी सेवाएं उपलब्ध कराती हैं, लेकिन मुख्य रूप से "रेस्टोरेंट" के तौर पर काम नहीं करतीं.

max_result_count

int32

दिखाए जाने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. यह 1 से 20 (डिफ़ॉल्ट) के बीच होना चाहिए. अगर यह संख्या सेट नहीं है, तो यह ऊपरी सीमा पर वापस चली जाती है. अगर संख्या ऋणात्मक पर सेट है या ऊपरी सीमा से ज़्यादा है, तो एक INVALID_LABEL गड़बड़ी दिखाई जाती है.

location_restriction

LocationRestriction

ज़रूरी है. वह क्षेत्र जिसे खोजना है.

rank_preference

RankPreference

जवाब में नतीजों को रैंक कैसे किया जाएगा.

LocationRestriction

वह क्षेत्र जिसे खोजना है.

फ़ील्ड

यूनियन फ़ील्ड type.

type इनमें से सिर्फ़ एक हो सकती है:

circle

Circle

केंद्र बिंदु और त्रिज्या के आधार पर परिभाषित वृत्त.

RankPreference

जवाब में नतीजों को रैंक कैसे किया जाएगा.

Enums
RANK_PREFERENCE_UNSPECIFIED रैंकिंग की प्राथमिकता का मान सेट नहीं किया गया है. डिफ़ॉल्ट रूप से, POPULARITY के हिसाब से रैंक का इस्तेमाल किया जाएगा.
DISTANCE दूरी के आधार पर नतीजों की रैंकिंग करता है.
POPULARITY लोकप्रियता के हिसाब से नतीजों की रैंकिंग करता है.

SearchNearbyResponse

आस-पास खोजने की सुविधा के लिए रिस्पॉन्स प्रोटो.

फ़ील्ड
places[]

Place

ऐसी जगहों की सूची जो उपयोगकर्ता की ज़रूरी शर्तें पूरी करती हैं. जैसे, जगहों का टाइप, जगहों की संख्या, और जगह की खास पाबंदी.

SearchTextRequest

SearchText के लिए प्रोटो का अनुरोध करें.

फ़ील्ड
text_query

string

ज़रूरी है. टेक्स्ट वाली खोज के लिए टेक्स्ट क्वेरी.

language_code

string

उपलब्ध होने पर, जगह की जानकारी पसंदीदा भाषा के साथ दिखाई जाएगी. अगर भाषा का कोड नहीं दिया गया है या उसकी पहचान नहीं की गई है, तो किसी भी भाषा की जगह की जानकारी दी जा सकती है. हालांकि, ऐसा होने पर, अंग्रेज़ी को प्राथमिकता दी जा सकती है.

इस्तेमाल की जा सकने वाली भाषाओं की मौजूदा सूची: https://developers.google.com/maps/faq#languagesupport.

region_code

string

उस जगह का यूनिकोड देश/इलाके का कोड (CLDR) जहां से अनुरोध भेजा जा रहा है. इस पैरामीटर का इस्तेमाल, जगह की जानकारी दिखाने के लिए किया जाता है. जैसे, जगह के हिसाब से जगह का नाम (अगर उपलब्ध हो). पैरामीटर, लागू कानून के आधार पर नतीजों पर असर डाल सकता है.

ज़्यादा जानकारी के लिए, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html पर जाएं.

ध्यान दें कि फ़िलहाल तीन अंकों वाले क्षेत्र कोड इस्तेमाल नहीं किए जा सकते.

rank_preference

RankPreference

जवाब में नतीजों को रैंक कैसे किया जाएगा.

included_type

string

अनुरोध की गई जगह का टाइप. इस्तेमाल किए जा सकने वाले टाइप की पूरी सूची: https://developers.google.com/maps/documentation/places/web-service/place-types. सिर्फ़ एक शामिल टाइप का इस्तेमाल करें.

open_now

bool

खोज को वर्तमान में खुले स्थानों तक सीमित करने के लिए उपयोग किया जाता है. डिफ़ॉल्ट रूप से गलत पर सेट होती है.

min_rating

double

उन परिणामों को फ़िल्टर करें जिनकी औसत उपयोगकर्ता रेटिंग इस सीमा से पूरी तरह कम हो. कोई मान्य वैल्यू 0.5 के बीच 0.5 के बीच फ़्लोट होनी चाहिए (इसमें शामिल हैं). जैसे, [0, 0.5, 1.0, ... , 5.0]. इसमें ये सभी वैल्यू भी शामिल होनी चाहिए. इनपुट रेटिंग सबसे करीब 0.5(सीलिंग) तक हो जाएगी. उदाहरण के लिए, 0.6 की रेटिंग से 1.0 से कम रेटिंग वाले सभी नतीजे हट जाएंगे.

max_result_count
(deprecated)

int32

अब काम नहीं करता: इसके बजाय page_size का इस्तेमाल करें.

हर पेज पर दिखाए जा सकने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. अगर उपलब्ध नतीजों की संख्या max_result_count से ज़्यादा है, तो next_page_token दिखाया जाता है. इसे page_token को पास किया जा सकता है, ताकि बाद के अनुरोधों में नतीजों का अगला पेज दिखाया जा सके. अगर 0 दिया जाता है या कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट वैल्यू 20 का इस्तेमाल किया जाता है. वैल्यू ज़्यादा से ज़्यादा 20 हो सकती है. 20 से ज़्यादा वैल्यू को लागू करके 20 कर दिया जाएगा. ऋणात्मक मान एक INVALID_LABEL गड़बड़ी दिखाएगा.

अगर max_result_count और page_size, दोनों के बारे में बताया गया है, तो max_result_count को अनदेखा कर दिया जाएगा.

page_size

int32

ज़रूरी नहीं. हर पेज पर दिखाए जा सकने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. अगर उपलब्ध नतीजों की संख्या page_size से ज़्यादा है, तो next_page_token दिखाया जाता है. इसे page_token को पास किया जा सकता है, ताकि बाद के अनुरोधों में नतीजों का अगला पेज दिखाया जा सके. अगर 0 दिया जाता है या कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट वैल्यू 20 का इस्तेमाल किया जाता है. वैल्यू ज़्यादा से ज़्यादा 20 होनी चाहिए. वहीं, 20 से ज़्यादा वैल्यू को 20 पर सेट किया जाएगा. ऋणात्मक मान एक INVALID_LABEL गड़बड़ी दिखाएगा.

अगर max_result_count और page_size, दोनों के बारे में बताया गया है, तो max_result_count को अनदेखा कर दिया जाएगा.

page_token

string

ज़रूरी नहीं. पिछले TextSearch कॉल से मिला पेज टोकन. बाद वाला पेज फिर से पाने के लिए यह विकल्प दें.

पेज पर नंबर जोड़ते समय, TextSearch को दिए गए page_token, page_size, और max_result_count के अलावा अन्य सभी पैरामीटर, उस शुरुआती कॉल से मेल खाने चाहिए जो पेज टोकन दिया गया था. अगर ऐसा नहीं होता है, तो एक INVALID_LABEL गड़बड़ी मिलती है.

price_levels[]

PriceLevel

इसका इस्तेमाल, खोज को उन जगहों तक सीमित करने के लिए किया जाता है जिन्हें कीमत के कुछ लेवल के तौर पर मार्क किया गया है. उपयोगकर्ता, कीमत के लेवल का कोई भी कॉम्बिनेशन चुन सकते हैं. डिफ़ॉल्ट रूप से, कीमत के सभी लेवल चुने जा सकते हैं.

strict_type_filtering

bool

शामिल किए गए टाइप के लिए, सख्त टाइप फ़िल्टर करने की सुविधा को सेट करने के लिए इस्तेमाल किया जाता है. अगर इसे 'सही है' पर सेट किया जाता है, तो सिर्फ़ एक तरह के नतीजे दिखाए जाएंगे. डिफ़ॉल्ट रूप से, 'गलत' पर सेट होता है.

location_bias

LocationBias

वह क्षेत्र जिसे खोजना है. इस जगह की जानकारी से जुड़ा कोई भेदभाव नहीं होता है, जिसका मतलब है कि दी गई जगह के हिसाब से नतीजे दिखाए जा सकते हैं. इसे location_restriction के साथ सेट नहीं किया जा सकता.

location_restriction

LocationRestriction

वह क्षेत्र जिसे खोजना है. इस जगह पर पाबंदी है. इसका मतलब है कि दी गई जगह से बाहर के नतीजे नहीं दिखाए जाएंगे. इसे location_bis के साथ सेट नहीं किया जा सकता.

ev_options

EVOptions

ज़रूरी नहीं. जगह की खोज के अनुरोध के लिए खोजे जा सकने वाले ईवी विकल्प सेट करें.

EVOptions

जगह की खोज का अनुरोध करने वाले ईवी के विकल्प, जिन्हें खोजा जा सकता है.

फ़ील्ड
minimum_charging_rate_kw

double

ज़रूरी नहीं. किलोवाट में, चार्जिंग की ज़रूरी दर. तय की गई दर से कम चार्ज रेट वाली जगह को फ़िल्टर करके, अलग कर दिया जाता है.

connector_types[]

EVConnectorType

ज़रूरी नहीं. पसंदीदा ईवी कनेक्टर टाइप की सूची. जो जगह सूची में दिए गए किसी भी तरह के कनेक्टर के साथ काम नहीं करती उसे फ़िल्टर करके बाहर कर दिया गया है.

LocationBias

वह क्षेत्र जिसे खोजना है. इस जगह की जानकारी से जुड़ा कोई भेदभाव नहीं होता है, जिसका मतलब है कि दी गई जगह के हिसाब से नतीजे दिखाए जा सकते हैं.

फ़ील्ड

यूनियन फ़ील्ड type.

type इनमें से सिर्फ़ एक हो सकती है:

rectangle

Viewport

रेक्टैंगल बॉक्स, जिसके उत्तर-पूर्व और दक्षिण-पश्चिम कोने से पता चलता है. rectangle.high(), रेक्टैंगल व्यूपोर्ट के उत्तर-पूर्वी हिस्से के तौर पर होना चाहिए. rectangle.low(), रेक्टैंगल व्यूपोर्ट का दक्षिण-पश्चिम पॉइंट होना चाहिए. rectangle.low().latitude(), rectangle.high().latitude() से ज़्यादा नहीं हो सकता. इस वजह से, अक्षांश की सीमा खाली हो जाएगी. आयताकार व्यूपोर्ट 180 डिग्री से ज़्यादा चौड़ा नहीं हो सकता.

circle

Circle

केंद्र बिंदु और त्रिज्या के आधार पर परिभाषित वृत्त.

LocationRestriction

वह क्षेत्र जिसे खोजना है. इस जगह पर पाबंदी है. इसका मतलब है कि दी गई जगह से बाहर के नतीजे नहीं दिखाए जाएंगे.

फ़ील्ड

यूनियन फ़ील्ड type.

type इनमें से सिर्फ़ एक हो सकती है:

rectangle

Viewport

रेक्टैंगल बॉक्स, जिसके उत्तर-पूर्व और दक्षिण-पश्चिम कोने से पता चलता है. rectangle.high(), रेक्टैंगल व्यूपोर्ट के उत्तर-पूर्वी हिस्से के तौर पर होना चाहिए. rectangle.low(), रेक्टैंगल व्यूपोर्ट का दक्षिण-पश्चिम पॉइंट होना चाहिए. rectangle.low().latitude(), rectangle.high().latitude() से ज़्यादा नहीं हो सकता. इस वजह से, अक्षांश की सीमा खाली हो जाएगी. आयताकार व्यूपोर्ट 180 डिग्री से ज़्यादा चौड़ा नहीं हो सकता.

RankPreference

जवाब में नतीजों को रैंक कैसे किया जाएगा.

Enums
RANK_PREFERENCE_UNSPECIFIED "न्यूयॉर्क शहर के रेस्टोरेंट" जैसी कैटगरी से जुड़ी क्वेरी के लिए, RELEVANCE डिफ़ॉल्ट होता है. हमारा सुझाव है कि "माउंटेन व्यू, सीए" जैसी अन्य कैटगरी से जुड़ी क्वेरी के लिए, आप RankPreference को सेट न करें.
DISTANCE दूरी के आधार पर नतीजों की रैंकिंग करता है.
RELEVANCE प्रासंगिकता के मुताबिक नतीजों की रैंकिंग करता है. सामान्य रैंकिंग स्टैक के हिसाब से क्रम में लगाएं.

SearchTextResponse

SearchText के लिए रिस्पॉन्स प्रोटो.

फ़ील्ड
places[]

Place

टेक्स्ट की मदद से की गई खोज की शर्तों को पूरा करने वाली जगहों की सूची.

contextual_contents[]

ContextualContent

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

काम के कॉन्टेंट की ऐसी सूची जिसमें हर एंट्री, जगह वाले फ़ील्ड में उसी इंडेक्स में मौजूद सही जगह से जुड़ी होती है. अनुरोध में मौजूद text_query से जुड़े कॉन्टेंट को प्राथमिकता दी जाती है. अगर किसी जगह के हिसाब से कॉन्टेंट उपलब्ध नहीं है, तो उस जगह के हिसाब से कॉन्टेंट नहीं दिखेगा. यह सिर्फ़ तब खाली होगा, जब इस जगह के लिए कॉन्टेंट उपलब्ध नहीं होगा. अनुरोध किए जाने पर, इस सूची में जगहों की सूची में जितनी चाहे उतनी एंट्री होनी चाहिए.

next_page_token

string

अगला पेज वापस पाने के लिए, page_token के तौर पर भेजा जा सकने वाला टोकन. अगर यह फ़ील्ड खाली है या इसे छोड़ा जाता है, तो इसके बाद कोई पेज नहीं होगा.