Package google.maps.places.v1

इंडेक्स

जगहें

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

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

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

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

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

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

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

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

जगहों के आस-पास की जगहें खोजें.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

जगह की जानकारी खोजने के लिए टेक्स्ट क्वेरी का इस्तेमाल करना.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform

AddressDescriptor

किसी जगह के बारे में जानकारी देने वाला टेक्स्ट. इसमें आस-पास के लैंडमार्क का रैंक किया गया सेट और टारगेट की गई जगह के आस-पास की सटीक जगहों की जानकारी शामिल होती है. साथ ही, यह भी बताया जाता है कि टारगेट की गई जगह से इन जगहों का क्या संबंध है.

फ़ील्ड
landmarks[]

Landmark

आस-पास के लैंडमार्क की रैंक की गई सूची. सबसे ज़्यादा जानी-पहचानी और आस-पास की जगहों को सबसे पहले रैंक किया जाता है.
areas[]

Area

इसमें, किसी जगह के आस-पास की जगहों की रैंक के हिसाब से सूची होती है. सबसे ज़्यादा जानी-पहचानी और सटीक जगहों को पहले रैंक किया जाता है.

क्षेत्र

जगह की जानकारी और टारगेट की गई जगह से उसका संबंध.

जगह की जानकारी में, सटीक सबलोकेलिटी, आस-पास के इलाके, और बड़े कंपाउंड शामिल होते हैं. ये किसी जगह की जानकारी देने के लिए काम के होते हैं.

फ़ील्ड
name

string

जगह के संसाधन का नाम.
place_id

string

जगह का आईडी.
display_name

LocalizedText

जगह का डिसप्ले नेम.
containment

Containment

इससे टारगेट की गई जगह और इलाके के बीच के स्थानिक संबंध के बारे में पता चलता है.

कंटेनमेंट

इससे टारगेट की गई जगह और इलाके के बीच के स्थानिक संबंध के बारे में पता चलता है.

Enums
CONTAINMENT_UNSPECIFIED कंटेनमेंट के बारे में नहीं बताया गया है.
WITHIN टारगेट की गई जगह, क्षेत्र के बीच में है.
OUTSKIRTS टारगेट की गई जगह, क्षेत्र के अंदर है और किनारे के पास है.
NEAR टारगेट की गई जगह, क्षेत्र से बाहर है, लेकिन उसके आस-पास है.

लैंडमार्क

लैंडमार्क के बारे में बुनियादी जानकारी और टारगेट की गई जगह से लैंडमार्क का संबंध.

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

फ़ील्ड
name

string

लैंडमार्क के संसाधन का नाम.
place_id

string

लैंडमार्क का प्लेस आईडी.
display_name

LocalizedText

लैंडमार्क का डिसप्ले नेम.
types[]

string

इस लैंडमार्क के लिए टाइप टैग का सेट. संभावित वैल्यू की पूरी सूची देखने के लिए, https://developers.google.com/maps/documentation/places/web-service/place-types पर जाएं.
spatial_relationship

SpatialRelationship

इससे टारगेट की गई जगह और लैंडमार्क के बीच की दूरी के बारे में पता चलता है.
straight_line_distance_meters

float

टारगेट के सेंटर पॉइंट और लैंडमार्क के सेंटर पॉइंट के बीच की सीधी दूरी, मीटर में. कुछ मामलों में, यह वैल्यू travel_distance_meters से ज़्यादा हो सकती है.
travel_distance_meters

float

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

SpatialRelationship

इससे टारगेट की गई जगह और लैंडमार्क के बीच की दूरी के बारे में पता चलता है.

Enums
NEAR अगर नीचे दी गई जानकारी में से कोई भी जानकारी लागू नहीं होती है, तो यह डिफ़ॉल्ट रिलेशनशिप होता है.
WITHIN लैंडमार्क में स्पेशल ज्योमेट्री है और टारगेट उसकी सीमाओं के अंदर है.
BESIDE टारगेट, लैंडमार्क के ठीक बगल में है.
ACROSS_THE_ROAD टारगेट, सड़क के दूसरी ओर मौजूद लैंडमार्क के ठीक सामने है.
DOWN_THE_ROAD लैंडमार्क के रास्ते पर, लेकिन उसके बगल में या सामने नहीं.
AROUND_THE_CORNER लैंडमार्क के रास्ते पर नहीं है, लेकिन एक मोड़ दूर है.
BEHIND लैंडमार्क की बनावट के करीब, लेकिन सड़क के प्रवेश द्वारों से दूर.

AuthorAttribution

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

फ़ील्ड
display_name

string

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

string

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

string

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

AutocompletePlacesRequest

AutocompletePlaces के लिए अनुरोध प्रोटो.

फ़ील्ड
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) में शामिल प्राइमरी जगह का टाइप (उदाहरण के लिए, "restaurant" या "gas_station"), सिर्फ़ (regions) या सिर्फ़ (cities). किसी जगह की जानकारी सिर्फ़ तब दिखाई जाती है, जब उसका मुख्य टाइप इस सूची में शामिल हो. ज़्यादा से ज़्यादा पांच वैल्यू दी जा सकती हैं. अगर कोई टाइप नहीं दिया गया है, तो सभी Place टाइप दिखाए जाते हैं.
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

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

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

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

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

bool

ज़रूरी नहीं. अगर फ़ील्ड को 'सही है' पर सेट किया गया है, तो घर या दुकान पर सेवा देने वाले कारोबारों को शामिल करें. घर या दुकान पर सेवा देने वाला कारोबार, ग्राहकों के पते पर जाकर सेवा देता है या डिलीवरी करता है. वह अपने कारोबार के पते पर ग्राहकों को सेवा नहीं देता. उदाहरण के लिए, प्लंबर या सफ़ाई की सेवाएं देने वाले कारोबार. इन कारोबारों का कोई पता या जगह Google Maps पर मौजूद नहीं है. Places API, इन कारोबारों के लिए location, plus_code, और जगह से जुड़े अन्य फ़ील्ड नहीं दिखाएगा.

LocationBias

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

फ़ील्ड

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

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

Viewport

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

Circle

यह एक ऐसा सर्कल होता है जिसे केंद्र बिंदु और त्रिज्या के हिसाब से तय किया जाता है.

LocationRestriction

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

फ़ील्ड

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

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

Viewport

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

Circle

यह एक ऐसा सर्कल होता है जिसे केंद्र बिंदु और त्रिज्या के हिसाब से तय किया जाता है.

AutocompletePlacesResponse

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

फ़ील्ड
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

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

फ़ील्ड
content

LocalizedText

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

string

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

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

फ़ील्ड
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

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

फ़ील्ड
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

ईवी चार्जिंग की जानकारी, जिसे [type, 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 मेनेक्स कनेक्टर पर आधारित
EV_CONNECTOR_TYPE_TESLA TESLA का सामान्य कनेक्टर. उत्तरी अमेरिका में यह NACS है, लेकिन दुनिया के अन्य हिस्सों में यह NACS नहीं हो सकता. उदाहरण के लिए, CCS Combo 2 (CCS2) या GB/T. यह वैल्यू, कनेक्टर के असल टाइप के बारे में कम जानकारी देती है. साथ ही, यह Tesla के मालिकाना हक वाले चार्जिंग स्टेशन पर, Tesla ब्रैंड के वाहन को चार्ज करने की सुविधा के बारे में ज़्यादा जानकारी देती है.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T टाइप, चीन में GB/T स्टैंडर्ड के मुताबिक होता है. इस टाइप में, सभी GB_T टाइप शामिल होते हैं.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET दीवार पर लगे सॉकेट की जानकारी नहीं दी गई है.
EV_CONNECTOR_TYPE_NACS नॉर्थ अमेरिकन चार्जिंग सिस्टम (एनएसीएस), जिसे SAE J3400 के तौर पर स्टैंडर्ड किया गया है.

FuelOptions

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

फ़ील्ड
fuel_prices[]

FuelPrice

इस स्टेशन पर उपलब्ध हर तरह के ईंधन की आखिरी बार पता चली कीमत. इस स्टेशन पर उपलब्ध हर तरह के ईंधन के लिए एक एंट्री होती है. क्रम मायने नहीं रखता.

FuelPrice

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

फ़ील्ड
type

FuelType

ईंधन का टाइप.
price

Money

ईंधन की कीमत.
update_time

Timestamp

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

FuelType

ईंधन के टाइप.

Enums
FUEL_TYPE_UNSPECIFIED ईंधन के टाइप की जानकारी नहीं दी गई है.
DIESEL डीज़ल ईंधन.
DIESEL_PLUS डीज़ल प्लस फ़्यूल.
REGULAR_UNLEADED सामान्य अनलेडेड.
MIDGRADE मिडग्रेड.
PREMIUM Premium.
SP91 एसपी 91.
SP91_E10 एसपी 91 ई10.
SP92 एसपी 92.
SP95 एसपी 95.
SP95_E10 SP95 E10.
SP98 एसपी 98.
SP99 एसपी 99.
SP100 SP 100.
LPG लिक्विफ़ाइड पेट्रोलियम गैस.
E80 E 80.
E85 E 85.
E100 E 100.
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 से 4800 के बीच की कोई पूर्णांक वैल्यू इस्तेमाल की जा सकती है. अगर वैल्यू, अनुमति वाली रेंज में नहीं है, तो INVALID_ARGUMENT गड़बड़ी दिखेगी.

max_height_px या max_width_px में से किसी एक की वैल्यू देना ज़रूरी है. अगर max_height_px और max_width_px, दोनों में से किसी को भी तय नहीं किया गया है, तो INVALID_ARGUMENT गड़बड़ी मिलेगी.
max_height_px

int32

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

max_height_px या max_width_px में से किसी एक की वैल्यू देना ज़रूरी है. अगर max_height_px और max_width_px, दोनों में से किसी को भी तय नहीं किया गया है, तो INVALID_ARGUMENT गड़बड़ी मिलेगी.
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

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

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

string

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

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

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

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

फ़ोटो

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

फ़ील्ड
name

string

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

int32

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

int32

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

AuthorAttribution

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

string

ऐसा लिंक जहां उपयोगकर्ता, फ़ोटो से जुड़ी समस्या की शिकायत कर सकते हैं.
google_maps_uri

string

Google Maps पर फ़ोटो दिखाने के लिए लिंक.

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", "Pyrmont" वगैरह.
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 देखें. अगर जगह का मुख्य टाइप, इस्तेमाल किया जा सकने वाला टाइप नहीं है, तो हो सकता है कि मुख्य टाइप मौजूद न हो. अगर कोई प्राइमरी टाइप मौजूद है, तो वह हमेशा types फ़ील्ड में मौजूद टाइप में से एक होता है.
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

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

PostalAddress

डाक पते के फ़ॉर्मैट में पता.
address_components[]

AddressComponent

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

PlusCode

जगह की जगह की जानकारी के अक्षांश/देशांतर का Plus Code.
location

LatLng

इस जगह की पोज़िशन.
viewport

Viewport

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

double

इस जगह के लिए, लोगों की समीक्षाओं के आधार पर 1.0 से 5.0 के बीच की रेटिंग.
google_maps_uri

string

ऐसा यूआरएल जो इस जगह के बारे में ज़्यादा जानकारी देता है.
website_uri

string

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

Review

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

OpeningHours

कारोबार के सामान्य कामकाज के घंटे. ध्यान दें कि अगर कोई जगह हमेशा (24 घंटे) खुली रहती है, तो close फ़ील्ड सेट नहीं किया जाएगा. क्लाइंट, हमेशा खुले रहने वाले कारोबार (24 घंटे) के लिए, open अवधि पर भरोसा कर सकते हैं. इसमें day की वैल्यू 0, hour की वैल्यू 0, और minute की वैल्यू 0 होती है.
time_zone

TimeZone

IANA टाइम ज़ोन डेटाबेस का टाइम ज़ोन. उदाहरण के लिए, "America/New_York".
photos[]

Photo

इस जगह की फ़ोटो के बारे में जानकारी (रेफ़रंस के साथ). ज़्यादा से ज़्यादा 10 फ़ोटो दिखाई जा सकती हैं.
adr_format_address

string

जगह का पता, adr माइक्रोफ़ॉर्मैट में: 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 बजे खत्म होती है. इस फ़ील्ड में, उन तारीखों के लिए सेट किए गए सभी घंटों का special_days सब-फ़ील्ड शामिल होता है जिनके लिए खास घंटे सेट किए गए हैं.
current_secondary_opening_hours[]

OpeningHours

इसमें अगले सात दिनों के लिए एंट्री की एक सीरीज़ होती है. इसमें कारोबार के खुले होने के दूसरे समय की जानकारी भी शामिल होती है. कारोबार के खुले होने का दूसरा समय, मुख्य समय से अलग होता है. उदाहरण के लिए, कोई रेस्टोरेंट ड्राइव-थ्रू (कार से उतरे बिना ऑर्डर देना) या डिलीवरी के लिए उपलब्ध होने के समय को, कारोबार के खुले रहने के दूसरे समय के तौर पर सेट कर सकता है. इस फ़ील्ड से, टाइप सब-फ़ील्ड भरता है. यह सब-फ़ील्ड, जगह के टाइप के आधार पर, खुले रहने के समय के टाइप की पहले से तय की गई सूची से जानकारी लेता है. जैसे, ड्राइव-थ्रू, पिकअप या टेकआउट. इस फ़ील्ड में, उन तारीखों के लिए सेट किए गए सभी घंटों का special_days सब-फ़ील्ड शामिल होता है जिनके लिए खास घंटे सेट किए गए हैं.
regular_secondary_opening_hours[]

OpeningHours

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

LocalizedText

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

PaymentOptions

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

ParkingOptions

जगह के हिसाब से पार्किंग के विकल्प.
sub_destinations[]

SubDestination

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

FuelOptions

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

EVChargeOptions

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

GenerativeSummary

जगह के बारे में एआई से जनरेट की गई खास जानकारी.
containing_places[]

ContainingPlace

उन जगहों की सूची जिनमें मौजूदा जगह मौजूद है.
address_descriptor

AddressDescriptor

जगह के पते का डेस्क्रिप्टर. पते के ब्यौरे में ऐसी अतिरिक्त जानकारी शामिल होती है जिससे लैंडमार्क और इलाकों का इस्तेमाल करके, किसी जगह के बारे में बताया जा सकता है. https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage पर जाकर, पते के ब्यौरे की क्षेत्रीय कवरेज देखें.
price_range

PriceRange

किसी जगह से जुड़ी कीमत सीमा.
review_summary

ReviewSummary

लोगों की समीक्षाओं का इस्तेमाल करके, एआई से जनरेट की गई जगह की खास जानकारी.
ev_charge_amenity_summary

EvChargeAmenitySummary

ईवी चार्जिंग स्टेशन के आस-पास मौजूद सुविधाओं के बारे में खास जानकारी.
neighborhood_summary

NeighborhoodSummary

जगह के आस-पास की लोकप्रिय जगहों के बारे में खास जानकारी.
consumer_alert

ConsumerAlert

जब हमें किसी कारोबार की समीक्षा से जुड़ी संदिग्ध गतिविधि का पता चलता है या कोई कारोबार हमारी नीतियों का उल्लंघन करता है, तो हम उस जगह के लिए उपभोक्ता को चेतावनी वाला मैसेज दिखाते हैं.
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

किसी जगह पर उपलब्ध सुलभता विकल्पों के बारे में जानकारी.
pure_service_area_business

bool

इससे पता चलता है कि कारोबार, सिर्फ़ सेवा देने के इलाके में आता है या नहीं. घर या दुकान पर सेवा देने वाला कारोबार, ग्राहकों के पते पर जाकर सेवा देता है या डिलीवरी करता है. वह अपने कारोबार के पते पर ग्राहकों को सेवा नहीं देता. उदाहरण के लिए, प्लंबर या सफ़ाई की सेवाएं देने वाले कारोबार. ऐसा हो सकता है कि उन कारोबारों का कोई पता या जगह Google Maps पर मौजूद न हो.

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

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

string

यह एक ऐसा कलेक्शन होता है जो पते के कॉम्पोनेंट के टाइप के बारे में बताता है.
language_code

string

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

एट्रिब्यूशन

इस जगह की जानकारी देने वाली कंपनियों के बारे में जानकारी.

फ़ील्ड
provider

string

जगह की जानकारी देने वाली कंपनी का नाम.
provider_uri

string

जगह का डेटा उपलब्ध कराने वाली कंपनी का यूआरआई.

BusinessStatus

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

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

ConsumerAlert

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

फ़ील्ड
overview

string

उपभोक्ता के लिए चेतावनी वाले मैसेज की खास जानकारी.
details

Details

उपभोक्ता को भेजी जाने वाली सूचना के मैसेज की जानकारी.ƒ
language_code

string

उपभोक्ता को चेतावनी देने वाले मैसेज का भाषा कोड. यह BCP 47 भाषा कोड है.

विवरण

उपभोक्ता के लिए सूचना वाले मैसेज की जानकारी.

फ़ील्ड
title

string

टाइटल, जिसे ब्यौरे के साथ दिखाना है.
description

string

उपभोक्ता के लिए चेतावनी वाले मैसेज का ब्यौरा.

ContainingPlace

उस जगह के बारे में जानकारी जहां यह जगह मौजूद है.

फ़ील्ड
name

string

उस जगह का संसाधन नाम जिसमें यह जगह मौजूद है.
id

string

उस जगह का आईडी जिसमें यह जगह मौजूद है.

EvChargeAmenitySummary

ईवी चार्जिंग स्टेशन के आस-पास मौजूद सुविधाओं के बारे में खास जानकारी. यह सिर्फ़ electric_vehicle_charging_station टाइप की जगहों पर लागू होता है. overview फ़ील्ड की वैल्यू देना ज़रूरी है. हालांकि, अन्य फ़ील्ड की वैल्यू देना ज़रूरी नहीं है.

फ़ील्ड
overview

ContentBlock

उपलब्ध सुविधाओं के बारे में खास जानकारी. यह सुविधा ज़रूर मिलेगी.
coffee

ContentBlock

आस-पास मौजूद कॉफ़ी शॉप की खास जानकारी.
restaurant

ContentBlock

आस-पास के रेस्टोरेंट के बारे में खास जानकारी.
store

ContentBlock

आस-पास के स्टोर की खास जानकारी.
flag_content_uri

string

एक लिंक, जहां उपयोगकर्ता जवाब में मौजूद किसी समस्या के बारे में शिकायत कर सकते हैं.
disclosure_text

LocalizedText

एआई के बारे में जानकारी देने वाला मैसेज "Gemini की मदद से जवाब तैयार किया गया" (और इसके स्थानीय भाषा में उपलब्ध वर्शन). अगर अनुरोध में बताई गई भाषा में जवाब उपलब्ध होगा, तो जवाब उसी भाषा में दिया जाएगा.

GenerativeSummary

जगह के बारे में एआई से जनरेट की गई खास जानकारी.

फ़ील्ड
overview

LocalizedText

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

string

एक लिंक, जहां उपयोगकर्ता खास जानकारी में मौजूद समस्या को फ़्लैग कर सकते हैं.
disclosure_text

LocalizedText

एआई के बारे में जानकारी देने वाला मैसेज "Gemini की मदद से जवाब तैयार किया गया" (और इसके स्थानीय भाषा में उपलब्ध वर्शन). अगर अनुरोध में बताई गई भाषा में जवाब उपलब्ध होगा, तो जवाब उसी भाषा में दिया जाएगा.

NeighborhoodSummary

जगह के आस-पास की लोकप्रिय जगहों के बारे में खास जानकारी.

फ़ील्ड
overview

ContentBlock

आस-पड़ोस के बारे में खास जानकारी.
description

ContentBlock

आस-पास के इलाके के बारे में पूरी जानकारी.
flag_content_uri

string

एक लिंक, जहां उपयोगकर्ता जवाब में मौजूद किसी समस्या के बारे में शिकायत कर सकते हैं.
disclosure_text

LocalizedText

एआई के बारे में जानकारी देने वाला मैसेज "Gemini की मदद से जवाब तैयार किया गया" (और इसके स्थानीय भाषा में उपलब्ध वर्शन). अगर अनुरोध में बताई गई भाषा में जवाब उपलब्ध होगा, तो जवाब उसी भाषा में दिया जाएगा.

OpeningHours

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

फ़ील्ड
periods[]

Period

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

periods का पहला दिन तय नहीं होता. इसे रविवार नहीं माना जाना चाहिए. एपीआई, कई फ़ैक्टर के आधार पर शुरुआत का दिन तय करता है. उदाहरण के लिए, 24 घंटे और सातों दिन काम करने वाले कारोबार के लिए, पहला पीरियड अनुरोध वाले दिन से शुरू हो सकता है. वहीं, अन्य कारोबारों के लिए यह हफ़्ते का पहला दिन हो सकता है.

ध्यान दें: periods ऐरे का क्रम, weekday_descriptions ऐरे के क्रम से अलग होता है. यह न मान लें कि ये बदलाव उसी दिन लागू हो जाएंगे.
weekday_descriptions[]

string

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

ध्यान दें: दिनों का क्रम और हफ़्ते की शुरुआत, स्थान-भाषा (भाषा और देश/इलाका) के हिसाब से तय होती है. periods अरे का क्रम, weekday_descriptions अरे के क्रम से अलग होता है. यह न मान लें कि ये बदलाव उसी दिन लागू हो जाएंगे.

अगर समय की जानकारी नहीं है या उसे स्थानीय भाषा में नहीं बदला जा सका, तो यह फ़ील्ड खाली रहेगा. उदाहरण: "Sun: 18:00–06:00"
secondary_hours_type

SecondaryHoursType

यह एक टाइप स्ट्रिंग है. इसका इस्तेमाल, कारोबार के दूसरे समय की जानकारी के टाइप की पहचान करने के लिए किया जाता है.
special_days[]

SpecialDay

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

Timestamp

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

Timestamp

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

bool

कारोबार के खुले होने का समय फ़िलहाल चालू है या नहीं. कारोबार के खुले रहने के सामान्य समय और मौजूदा समय के लिए, इस फ़ील्ड का मतलब है कि कारोबार खुला है या नहीं. कारोबार के खुले होने के दूसरे समय और कारोबार के खुले होने के मौजूदा दूसरे समय के लिए, इस फ़ील्ड का मतलब है कि कारोबार के खुले होने का दूसरा समय चालू है या नहीं.

पीरियड का बटन

वह अवधि जिसके दौरान जगह की स्थिति open_now के तौर पर दिखती है.

फ़ील्ड
open

Point

वह समय जब जगह खुलती है.
close

Point

वह समय जब जगह बंद हो जाती है.

पॉइंट

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

फ़ील्ड
date

Date

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

bool

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

int32

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

int32

24 घंटे के फ़ॉर्मैट में घंटा. इसकी वैल्यू 0 से 23 तक होती है.
minute

int32

एक मिनट. इसकी वैल्यू 0 से 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) एक लोकेशन रेफ़रंस होता है. यह दो फ़ॉर्मैट में होता है: ग्लोबल कोड, जो 14 मीटर x 14 मीटर (डिग्री का 1/8000वां हिस्सा) या इससे छोटे रेक्टैंगल को तय करता है. दूसरा, कंपाउंड कोड, जो प्रीफ़िक्स को रेफ़रंस लोकेशन से बदलता है.

फ़ील्ड
global_code

string

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

string

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

ReviewSummary

लोगों की समीक्षाओं का इस्तेमाल करके, एआई से जनरेट की गई जगह की खास जानकारी.

फ़ील्ड
text

LocalizedText

लोगों की समीक्षाओं की खास जानकारी.
flag_content_uri

string

एक लिंक, जहां उपयोगकर्ता जवाब में मौजूद किसी समस्या के बारे में शिकायत कर सकते हैं.
disclosure_text

LocalizedText

एआई के बारे में जानकारी देने वाला मैसेज "Gemini की मदद से जवाब तैयार किया गया" (और इसके स्थानीय भाषा में उपलब्ध वर्शन). अगर अनुरोध में बताई गई भाषा में जवाब उपलब्ध होगा, तो जवाब उसी भाषा में दिया जाएगा.
reviews_uri

string

Google Maps पर इस जगह की समीक्षाएं दिखाने वाला लिंक.

SubDestination

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

फ़ील्ड
name

string

उप-मंज़िल का संसाधन नाम.
id

string

उप-मंज़िल का प्लेस आईडी.

पॉलीलाइन

रास्ते की पॉलीलाइन. यह सिर्फ़ कोड में बदली गई पॉलीलाइन के साथ काम करता है. इसे स्ट्रिंग के तौर पर पास किया जा सकता है. इसमें कम से कम डेटा लॉस के साथ कंप्रेशन शामिल होता है. यह Routes API का डिफ़ॉल्ट आउटपुट है.

फ़ील्ड
यूनियन फ़ील्ड polyline_type. इसमें पॉलीलाइन का टाइप शामिल होता है. Routes API का आउटपुट डिफ़ॉल्ट रूप से encoded_polyline पर सेट होता है. polyline_type इनमें से सिर्फ़ एक हो सकता है:
encoded_polyline

string

यह encoded polyline है, जिसे Routes API डिफ़ॉल्ट रूप से दिखाता है. एन्कोडर और डिकोडर टूल देखें.

PriceLevel

जगह के लिए कीमत का लेवल.

Enums
PRICE_LEVEL_UNSPECIFIED जगह के लिए कीमत का लेवल तय नहीं किया गया है या इसके बारे में जानकारी नहीं है.
PRICE_LEVEL_FREE जगह पर बिना किसी शुल्क के सेवाएं दी जाती हैं.
PRICE_LEVEL_INEXPENSIVE जगह पर किफ़ायती सेवाएं उपलब्ध हैं.
PRICE_LEVEL_MODERATE जगह पर सामान्य कीमत पर सेवाएं उपलब्ध हैं.
PRICE_LEVEL_EXPENSIVE जगह पर महंगी सेवाएं दी जाती हैं.
PRICE_LEVEL_VERY_EXPENSIVE जगह पर बहुत महंगी सेवाएं दी जाती हैं.

PriceRange

किसी जगह से जुड़ी कीमत सीमा. end_price को अनसेट किया जा सकता है.इससे पता चलता है कि रेंज की ऊपरी सीमा तय नहीं की गई है. उदाहरण के लिए, "100 डॉलर से ज़्यादा".

फ़ील्ड
start_price

Money

किराये की रेंज की सबसे कम कीमत (इसमें यह कीमत शामिल है). कीमत, इस रकम के बराबर या इससे ज़्यादा होनी चाहिए.
end_price

Money

कीमत सीमा की ऊपरी सीमा (अलग से उपलब्ध). कीमत, इस रकम से कम होनी चाहिए.

समीक्षा करें

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

फ़ील्ड
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

समीक्षा का टाइमस्टैंप.
flag_content_uri

string

ऐसा लिंक जहां उपयोगकर्ता, समीक्षा से जुड़ी किसी समस्या के बारे में शिकायत कर सकते हैं.
google_maps_uri

string

Google Maps पर समीक्षा दिखाने वाला लिंक.
visit_date

Date

वह तारीख जब लेखक ने जगह का दौरा किया था. इसे महीने के हिसाब से काटा जाता है.

RouteModifiers

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

फ़ील्ड
avoid_tolls

bool

ज़रूरी नहीं. 'सही है' के तौर पर सेट होने पर, यह टोल रोड से बचने के लिए सबसे सही रास्ता दिखाता है. साथ ही, उन रास्तों को प्राथमिकता देता है जिनमें टोल रोड शामिल नहीं हैं. यह सिर्फ़ DRIVE और TWO_WHEELER TravelMode पर लागू होता है.
avoid_highways

bool

ज़रूरी नहीं. इसे 'सही है' के तौर पर सेट करने पर, हाइवे से बचने की कोशिश की जाती है. साथ ही, ऐसे रास्तों को प्राथमिकता दी जाती है जिनमें हाइवे शामिल नहीं होते. यह सिर्फ़ DRIVE और TWO_WHEELER TravelMode पर लागू होता है.
avoid_ferries

bool

ज़रूरी नहीं. इसे 'सही है' पर सेट करने पर, फ़ेरी वाले रास्तों को प्राथमिकता नहीं दी जाती है. हालांकि, अगर फ़ेरी वाले रास्ते के अलावा कोई और रास्ता उपलब्ध नहीं है, तो फ़ेरी वाले रास्ते को चुना जा सकता है. यह सिर्फ़ DRIVE और TWO_WHEELER TravelMode पर लागू होता है.
avoid_indoor

bool

ज़रूरी नहीं. इसे 'सही है' पर सेट करने से, जहां तक हो सके वहां इंडोर नेविगेशन से बचा जा सकता है. साथ ही, उन रास्तों को प्राथमिकता दी जाती है जिनमें इंडोर नेविगेशन शामिल नहीं होता है. यह सिर्फ़ WALK TravelMode पर लागू होता है.

RoutingParameters

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

फ़ील्ड
origin

LatLng

ज़रूरी नहीं. रूटिंग का ऐसा ओरिजन जो पॉलीलाइन में तय किए गए ओरिजन को बदल देता है. डिफ़ॉल्ट रूप से, पॉलीलाइन के ऑरिजिन का इस्तेमाल किया जाता है.
travel_mode

TravelMode

ज़रूरी नहीं. यात्रा का मोड.
route_modifiers

RouteModifiers

ज़रूरी नहीं. रास्ते में बदलाव करने वाले टूल.
routing_preference

RoutingPreference

ज़रूरी नहीं. इससे पता चलता है कि रूटिंग की खास जानकारी कैसे कैलकुलेट की जाती है. सर्वर, चुने गए राउटिंग के तरीके का इस्तेमाल करके, रास्ते का हिसाब लगाता है. ट्रैफ़िक के हिसाब से रूट चुनने की सुविधा, सिर्फ़ DRIVE या TWO_WHEELER travelMode के लिए उपलब्ध है.

RoutingPreference

वैल्यू का एक ऐसा सेट जो रास्ते का हिसाब लगाते समय ध्यान में रखने वाली बातों के बारे में बताता है.

Enums
ROUTING_PREFERENCE_UNSPECIFIED रास्ते से जुड़ी कोई प्राथमिकता नहीं दी गई है. डिफ़ॉल्ट रूप से TRAFFIC_UNAWARE पर सेट होता है.
TRAFFIC_UNAWARE यह लाइव ट्रैफ़िक की स्थितियों को ध्यान में रखे बिना रास्ते का पता लगाता है. यह तब सही होता है, जब ट्रैफ़िक की स्थिति से कोई फ़र्क़ नहीं पड़ता या यह लागू नहीं होती. इस वैल्यू का इस्तेमाल करने पर, सबसे कम लेटेन्सी मिलती है. ध्यान दें: TravelMode DRIVE और TWO_WHEELER के लिए, चुने गए रास्ते और अवधि का हिसाब सड़क नेटवर्क और समय के हिसाब से ट्रैफ़िक की औसत स्थितियों के आधार पर लगाया जाता है. इसमें सड़क की मौजूदा स्थितियों को ध्यान में नहीं रखा जाता. इसलिए, रास्तों में ऐसी सड़कें भी शामिल हो सकती हैं जो कुछ समय के लिए बंद हैं. सड़क नेटवर्क में हुए बदलावों, ट्रैफ़िक की मौजूदा स्थितियों के अपडेट होने, और सेवा के डिस्ट्रिब्यूटेड नेचर की वजह से, किसी अनुरोध के नतीजे समय के साथ अलग-अलग हो सकते हैं. इसके अलावा, एक जैसे रास्तों के लिए भी, किसी भी समय या फ़्रीक्वेंसी पर नतीजे अलग-अलग हो सकते हैं.
TRAFFIC_AWARE यह कुकी, लाइव ट्रैफ़िक की स्थितियों को ध्यान में रखकर रूट का हिसाब लगाती है. TRAFFIC_AWARE_OPTIMAL के उलट, इंतज़ार के समय को काफ़ी कम करने के लिए कुछ ऑप्टिमाइज़ेशन लागू किए जाते हैं.
TRAFFIC_AWARE_OPTIMAL यह लाइव ट्रैफ़िक की स्थितियों को ध्यान में रखते हुए रास्तों का हिसाब लगाता है. हालांकि, इसमें परफ़ॉर्मेंस को बेहतर बनाने वाले ज़्यादातर ऑप्टिमाइज़ेशन लागू नहीं किए जाते. इस वैल्यू का इस्तेमाल करने पर, सबसे ज़्यादा लेटेन्सी होती है.

RoutingSummary

जवाब में, यात्रा शुरू करने की जगह से किसी जगह तक पहुंचने में लगने वाला समय और दूरी. साथ ही, अगर अनुरोध किया गया है, तो उस जगह से मंज़िल तक पहुंचने में लगने वाला समय और दूरी. ध्यान दें: अनुरोध में routingParameters.origin या searchAlongRouteParameters.polyline.encodedPolyline पैरामीटर को शामिल किए बिना, फ़ील्ड मास्क में routingSummaries जोड़ने पर गड़बड़ी होती है.

फ़ील्ड
legs[]

Leg

यात्रा के चरण.

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

string

इस लिंक का इस्तेमाल करके, Google Maps पर दिशा-निर्देश दिखाए जा सकते हैं. इसके लिए, रूट की खास जानकारी में दिए गए वेपॉइंट का इस्तेमाल किया जाता है. इस लिंक से जनरेट किया गया रास्ता, उस रास्ते से अलग हो सकता है जिसका इस्तेमाल रास्तों की जानकारी जनरेट करने के लिए किया गया था. यह लिंक, अनुरोध में दी गई जानकारी का इस्तेमाल करता है. इसमें routingParameters और searchAlongRouteParameters जैसे फ़ील्ड शामिल होते हैं. हालांकि, यह जानकारी सिर्फ़ तब इस्तेमाल की जाती है, जब लागू हो. इस जानकारी का इस्तेमाल, दिशा-निर्देशों का लिंक जनरेट करने के लिए किया जाता है.

लेग

लेग, एक जगह से दूसरी जगह की यात्रा का एक हिस्सा होता है.

फ़ील्ड
duration

Duration

यात्रा के इस हिस्से को पूरा करने में लगने वाला समय.
distance_meters

int32

यात्रा के इस हिस्से की दूरी.

SearchNearbyRequest

'आस-पास खोजें' सुविधा के लिए, प्रोटो का अनुरोध करें.

फ़ील्ड
language_code

string

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

फ़िलहाल, यह सुविधा इन भाषाओं में उपलब्ध है: https://developers.google.com/maps/faq#languagesupport.
region_code

string

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

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

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

string

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

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

अगर कोई टाइप शामिल किए गए टाइप और बाहर रखे गए टाइप, दोनों में दिखता है, तो INVALID_ARGUMENT गड़बड़ी दिखती है.

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

string

जगह के टाइप को बाहर रखा गया है. जैसे, https://developers.google.com/maps/documentation/places/web-service/place-types से "restaurant" या "gas_station".

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

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

अगर कोई टाइप शामिल किए गए टाइप और बाहर रखे गए टाइप, दोनों में दिखता है, तो INVALID_ARGUMENT गड़बड़ी दिखती है.

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

string

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

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

अगर प्राइमरी टाइप में कोई टकराव होता है, जैसे कि कोई टाइप included_primary_types और excluded_primary_types, दोनों में दिखता है, तो INVALID_ARGUMENT गड़बड़ी दिखती है.

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

string

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

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

अगर प्राइमरी टाइप में कोई टकराव होता है, जैसे कि कोई टाइप included_primary_types और excluded_primary_types, दोनों में दिखता है, तो INVALID_ARGUMENT गड़बड़ी दिखती है.

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

int32

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

LocationRestriction

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

RankPreference

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

RoutingParameters

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

LocationRestriction

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

फ़ील्ड

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

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

Circle

केंद्र बिंदु और त्रिज्या से तय किया गया वृत्त.

RankPreference

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

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

SearchNearbyResponse

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

फ़ील्ड
places[]

Place

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

RoutingSummary

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

SearchTextRequest

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

फ़ील्ड
text_query

string

ज़रूरी है. टेक्स्ट की मदद से खोज करने के लिए टेक्स्ट क्वेरी.
language_code

string

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

फ़िलहाल, यह सुविधा इन भाषाओं में उपलब्ध है: https://developers.google.com/maps/faq#languagesupport.
region_code

string

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

ज़्यादा जानकारी के लिए, 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_ARGUMENT गड़बड़ी दिखेगी.

अगर max_result_count और page_size, दोनों की वैल्यू दी गई हैं, तो max_result_count की वैल्यू को अनदेखा कर दिया जाएगा.
page_size

int32

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

अगर max_result_count और page_size, दोनों की वैल्यू दी गई हैं, तो max_result_count की वैल्यू को अनदेखा कर दिया जाएगा.
page_token

string

ज़रूरी नहीं. यह एक पेज टोकन है, जो TextSearch के पिछले कॉल से मिला था. अगला पेज पाने के लिए, यह जानकारी दें.

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

PriceLevel

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

bool

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

LocationBias

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

LocationRestriction

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

EVOptions

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

RoutingParameters

ज़रूरी नहीं. नतीजों पर रीडायरेक्ट करने के लिए अतिरिक्त पैरामीटर.
search_along_route_parameters

SearchAlongRouteParameters

ज़रूरी नहीं. रास्ते के आस-पास मौजूद चीज़ों को खोजने के लिए, अतिरिक्त पैरामीटर वाला प्रोटो.
include_pure_service_area_businesses

bool

ज़रूरी नहीं. अगर फ़ील्ड को 'सही है' पर सेट किया गया है, तो घर या दुकान पर सेवा देने वाले कारोबारों को शामिल करें. घर या दुकान पर सेवा देने वाला कारोबार, ग्राहकों के पते पर जाकर सेवा देता है या डिलीवरी करता है. वह अपने कारोबार के पते पर ग्राहकों को सेवा नहीं देता. उदाहरण के लिए, प्लंबर या सफ़ाई की सेवाएं देने वाले कारोबार. इन कारोबारों का कोई पता या जगह Google Maps पर मौजूद नहीं है. Places API, इन कारोबारों के लिए location, plus_code, और जगह से जुड़े अन्य फ़ील्ड नहीं दिखाएगा.

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 यह कुकी, खोज के नतीजों को इस आधार पर रैंक करती है कि वे कितने काम के हैं. सॉर्ट करने का क्रम, सामान्य रैंकिंग स्टैक के हिसाब से तय होता है.

SearchAlongRouteParameters

यह Routes API से पहले से कैलकुलेट की गई पॉलीलाइन के बारे में बताता है. यह पॉलीलाइन, खोजे जाने वाले रास्ते के बारे में जानकारी देती है. रास्ते के साथ-साथ खोज करने की सुविधा, खोज के नतीजों को बेहतर बनाने के लिए locationBias या locationRestriction अनुरोध विकल्प का इस्तेमाल करने जैसी है. हालांकि, locationBias और locationRestriction विकल्पों की मदद से, खोज के नतीजों में किसी इलाके को प्राथमिकता दी जा सकती है. वहीं, इस विकल्प की मदद से, यात्रा के रास्ते के हिसाब से नतीजों को प्राथमिकता दी जा सकती है.

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

फ़ील्ड
polyline

Polyline

ज़रूरी है. रास्ते की पॉलीलाइन.

SearchTextResponse

SearchText के लिए Response proto.

फ़ील्ड
places[]

Place

उन जगहों की सूची जो उपयोगकर्ता की टेक्स्ट सर्च की ज़रूरी शर्तों को पूरा करती हैं.
routing_summaries[]

RoutingSummary

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

ContextualContent

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

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

string

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

string

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

TravelMode

यात्रा के मोड के विकल्प. ये विकल्प, Routes API के ऑफ़र के हिसाब से मैप किए जाते हैं.

Enums
TRAVEL_MODE_UNSPECIFIED यात्रा का कोई साधन नहीं चुना गया है. यह डिफ़ॉल्ट रूप से DRIVE पर सेट होता है.
DRIVE कार से यात्रा करना.
BICYCLE साइकल से यात्रा करना. search_along_route_parameters के साथ काम नहीं करता.
WALK पैदल यात्रा करें. search_along_route_parameters के साथ काम नहीं करता.
TWO_WHEELER मोटर से चलने वाले दो पहियों वाले सभी तरह के वाहन, जैसे कि स्कूटर और मोटरसाइकल. ध्यान दें कि यह BICYCLE यात्रा के मोड से अलग है. इसमें इंसानों के चलने-फिरने के लिए इस्तेमाल किए जाने वाले परिवहन के साधन शामिल हैं. search_along_route_parameters के साथ काम नहीं करता. यह सुविधा सिर्फ़ उन देशों में उपलब्ध है जिनके नाम दो पहिया वाहनों के लिए उपलब्ध देशों और इलाकों की सूची में दिए गए हैं.