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/maps-platform.places.autocomplete
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

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

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

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

rpc GetPlace(GetPlaceRequest) returns (Place)

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

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

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

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

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

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

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

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

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/maps-platform.places.textsearch
  • https://www.googleapis.com/auth/maps-platform.places
  • 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

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

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 गड़बड़ी का मैसेज दिखता है.

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

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

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

bool

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

include_future_opening_businesses

bool

ज़रूरी नहीं. अगर यह सही है, तो उन कारोबारों को शामिल करें जो अभी तक खुले नहीं हैं, लेकिन आने वाले समय में खुलेंगे.

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

ऐसा कॉन्टेंट जो जगह की क्वेरी के हिसाब से हो.

फ़ील्ड
reviews[]

Review

इस जगह के बारे में समीक्षाओं की सूची. ये समीक्षाएं, जगह की क्वेरी के हिसाब से होती हैं.

photos[]

Photo

इस जगह की फ़ोटो के बारे में जानकारी (रेफ़रंस के साथ). यह जानकारी, जगह की क्वेरी के हिसाब से होती है.

justifications[]

Justification

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

वजह

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

फ़ील्ड

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

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

review_justification

ReviewJustification

business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

BusinessAvailabilityAttributesJustification

BusinessAvailabilityAttributes के लिए औचित्य. इससे किसी कारोबार की कुछ ऐसी विशेषताओं के बारे में पता चलता है जिनमें असली उपयोगकर्ता की दिलचस्पी हो सकती है.

फ़ील्ड
takeout

bool

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

delivery

bool

अगर किसी जगह पर डिलीवरी की सुविधा उपलब्ध है.

dine_in

bool

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

ReviewJustification

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

फ़ील्ड
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 कंबाइंड चार्जिंग सिस्टम (एसी और डीसी). एसएई के आधार पर. टाइप-1 J-1772 कनेक्टर
EV_CONNECTOR_TYPE_CCS_COMBO_2 कंबाइंड चार्जिंग सिस्टम (एसी और डीसी). टाइप-2 मेनेक्स कनेक्टर पर आधारित
EV_CONNECTOR_TYPE_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 दीवार पर लगे पावर सॉकेट के बारे में जानकारी नहीं है.
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 SP 91 E10.
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 गड़बड़ी का मैसेज दिखता है.

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

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

  • जगह के नाम अपने-आप भरने की सुविधा के लिए किए गए सभी कॉल के लिए, सेशन टोकन का इस्तेमाल करें.
  • हर सेशन के लिए नया टोकन जनरेट करें. हमारा सुझाव है कि आप वर्शन 4 के यूयूआईडी का इस्तेमाल करें.
  • पक्का करें कि किसी सेशन में, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा, जगह के बारे में ज़्यादा जानकारी, और Address Validation के सभी अनुरोधों के लिए इस्तेमाल किए गए क्रेडेंशियल, एक ही 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 देखें. अगर जगह का मुख्य टाइप, इस्तेमाल किया जा सकने वाला टाइप नहीं है, तो हो सकता है कि मुख्य टाइप मौजूद न हो.

google_maps_type_label

LocalizedText

Google Maps पर मौजूद जगह का टाइप लेबल. अगर लागू हो, तो इसे अनुरोध की भाषा में बदला जाता है. उदाहरण के लिए, "रेस्टोरेंट", "कैफ़े", "एयरपोर्ट" वगैरह. टाइप लेबल, डिसप्ले नेम के प्राइमरी टाइप से अलग हो सकता है. यह भी हो सकता है कि यह Places API के प्लेस टाइप टेबल में मौजूद टाइप न हो.

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

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

photos[]

Photo

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

adr_format_address

string

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

business_status

BusinessStatus

जगह के लिए कारोबार का स्टेटस.

opening_date

Date

वह तारीख जब यह जगह आने वाले समय में खुलेगी. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब कारोबार की स्थिति FUTURE_OPENING हो.

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 बजे खत्म होती है. अगर कारोबार के खुले होने का असल समय इस सीमा से बाहर है, तो कारोबार के खुले होने के समय को छोटा कर दिया जाएगा. उदाहरण के लिए, अगर कोई जगह कल रात 10 बजे से आज सुबह 6 बजे तक खुली थी, तो कारोबार के खुले होने का समय आज रात 12 बजे से आज सुबह 6 बजे तक दिखेगा. इस फ़ील्ड में, उन तारीखों के लिए सेट किए गए सभी घंटों का special_days सब-फ़ील्ड शामिल होता है जिनके लिए खास घंटे सेट किए गए हैं.

regular_opening_hours

OpeningHours

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

current_secondary_opening_hours[]

OpeningHours

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

regular_secondary_opening_hours[]

OpeningHours

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

time_zone

TimeZone

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

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

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

moved_place

string

अगर यह जगह हमेशा के लिए बंद हो गई है और किसी नई जगह पर चली गई है, तो इस फ़ील्ड में नई जगह का संसाधन नाम होता है. यह places/{place_id} फ़ॉर्मैट में होता है. अगर इस जगह की जानकारी को कई बार बदला गया है, तो इस फ़ील्ड में पहली बार बदली गई जगह की जानकारी दिखेगी. अगर यह जगह नहीं बदली है, तो इस फ़ील्ड में कोई वैल्यू नहीं डाली जाएगी.

moved_place_id

string

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

transit_station

TransitStation

जगह के लिए बस, मेट्रो वगैरह के स्टेशन की जानकारी.

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

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

utc_offset_minutes

int32

इस जगह का टाइमज़ोन, फ़िलहाल यूटीसी से कितने मिनट आगे या पीछे है. इसे मिनटों में दिखाया जाता है, ताकि उन टाइमज़ोन के लिए भी काम कर सके जिनमें समय का अंतर घंटे के कुछ हिस्से में होता है. जैसे, X घंटे और 15 मिनट.

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 यह कारोबार हमेशा के लिए बंद हो गया है.
FUTURE_OPENING यह कारोबार आने वाले समय में खुलेगा.

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

यह कोड में बदला गया पॉलीलाइन है, जिसे 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 टाइप दिए जा सकते हैं.

अगर प्राइमरी टाइप में कोई टकराव होता है, जैसे कि कोई टाइप शामिल किए गए प्राइमरी टाइप और बाहर रखे गए प्राइमरी टाइप, दोनों में दिखता है, तो 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 टाइप दिए जा सकते हैं.

अगर प्राइमरी टाइप में कोई टकराव होता है, जैसे कि कोई टाइप शामिल किए गए प्राइमरी टाइप और बाहर रखे गए प्राइमरी टाइप, दोनों में दिखता है, तो 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

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

include_future_opening_businesses

bool

ज़रूरी नहीं. अगर यह सही है, तो उन कारोबारों को शामिल करें जो अभी तक खुले नहीं हैं, लेकिन आने वाले समय में खुलेंगे.

LocationRestriction

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

फ़ील्ड

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

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

circle

Circle

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

RankPreference

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

Enums
RANK_PREFERENCE_UNSPECIFIED RankPreference की वैल्यू सेट नहीं है. डिफ़ॉल्ट रूप से, लोकप्रियता के हिसाब से रैंक का इस्तेमाल करेगा.
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, और जगह से जुड़े अन्य फ़ील्ड की जानकारी नहीं मिलेगी.

include_future_opening_businesses

bool

ज़रूरी नहीं. अगर यह सही है, तो उन कारोबारों को शामिल करें जो अभी तक खुले नहीं हैं, लेकिन आने वाले समय में खुलेंगे.

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 के लिए रिस्पॉन्स प्रोटो.

फ़ील्ड
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 पर उसी टेक्स्ट क्वेरी से खोज कर सकता है जो अनुरोध में दी गई है.

TransitAgency

यह किसी सार्वजनिक परिवहन एजेंसी को दिखाता है.

फ़ील्ड
display_name

LocalizedText

अनुरोध की गई भाषा में एजेंसी का नाम (जैसे, "वीटीए").

url

string

एजेंसी के होम पेज का यूआरएल.

fare_url

string

एजेंसी के किराये की जानकारी वाले पेज का यूआरएल.

icon

TransitIcon

यह ट्रांज़िट सिस्टम (जैसे, लंदन अंडरग्राउंड) के स्थानीय भाषा में ब्रैंड किए गए आइकॉन का आइडेंटिफ़ायर है. इसका इस्तेमाल यूज़र इंटरफ़ेस (यूआई) में TransitLine.vehicle_icon के बजाय किया जाना चाहिए.

lines[]

TransitLine

इस एजेंसी की ओर से दी जाने वाली ट्रांज़िट लाइनें.

TransitIcon

सार्वजनिक परिवहन लाइन, वाहन या एजेंसी का आइकॉन.

फ़ील्ड
url

string

आइकॉन का यूआरएल.

name_included

bool

इससे यह पता चलता है कि नाम आइकॉन में शामिल है या नहीं. अगर नाम आइकॉन में शामिल है, तो उसे आइकॉन के बगल में दिखाने की ज़रूरत नहीं है.

TransitLine

यह एक बस, मेट्रो वगैरह के रूट को दिखाता है.

फ़ील्ड
id

string

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

vehicle_type

VehicleType

इस लाइन का इस्तेमाल करने वाले वाहन का टाइप.

display_name

LocalizedText

इस बस, मेट्रो वगैरह का रूट मैप का पूरा नाम (जैसे, "सनीडेल लोकल").

short_display_name

LocalizedText

इस बस, मेट्रो वगैरह का रूट मैप का छोटा नाम (जैसे, "S2").

text_color

string

#RRGGBB हेक्स फ़ॉर्मैट में, बस, मेट्रो वगैरह के इस रूट मैप के लेबल का टेक्स्ट कलर. उदाहरण के लिए, #909CE1.

background_color

string

#RRGGBB हेक्स फ़ॉर्मैट में, बस, मेट्रो वगैरह के इस रूट मैप के लेबल के बैकग्राउंड का रंग. उदाहरण के लिए, #909CE1. इस रंग का इस्तेमाल, बस, मेट्रो वगैरह की लाइन के लिए शेप बनाने के लिए भी किया जा सकता है.

url

string

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

icon

TransitIcon

इस लाइन के लिए आइकॉन आइडेंटिफ़ायर (उदाहरण के लिए, न्यूयॉर्क में मेट्रो लाइनें).

vehicle_icon

TransitIcon

इस खास तरह के वाहन के लिए आइकॉन आइडेंटिफ़ायर.

VehicleType

बस, मेट्रो वगैरह के रूट मैप के लिए वाहन का टाइप.

Enums
VEHICLE_TYPE_UNSPECIFIED वाहन का टाइप न चुने जाने पर डिफ़ॉल्ट वैल्यू.
RAIL रेल.
METRO_RAIL मेट्रो रेल.
SUBWAY सबवे.
TRAM ट्राम.
MONORAIL Monorail.
HEAVY_RAIL हैवी रेल.
COMMUTER_TRAIN यात्री ट्रेन.
HIGH_SPEED_TRAIN हाई स्पीड ट्रेन.
LONG_DISTANCE_TRAIN लंबी दूरी की ट्रेन.
BUS बस.
INTERCITY_BUS एक शहर से दूसरे शहर जाने वाली बस.
TROLLEYBUS ट्रॉलीबस.
SHARE_TAXI शेयर टैक्सी.
COACH कोच.
FERRY फ़ेरी.
CABLE_CAR केबल कार.
GONDOLA_LIFT गोंडोला लिफ़्ट.
FUNICULAR फ़्यूनिक्यूलर.
SPECIAL खास.
HORSE_CARRIAGE घोड़ा गाड़ी.
AIRPLANE हवाई जहाज़.

TransitStation

यह किसी जगह के लिए, ट्रांज़िट से जुड़ी जानकारी दिखाता है.

फ़ील्ड
display_name

LocalizedText

स्टेशन का नाम स्थानीय भाषा में.

agencies[]

TransitAgency

इस स्टेशन पर सेवा देने वाली सार्वजनिक परिवहन एजेंसियां.

stops[]

TransitStop

इस स्टेशन पर बस, मेट्रो वगैरह के स्टॉप.

TransitStop

यह स्टेशन के अंदर मौजूद बस स्टॉप को दिखाता है. यह एक ऐसी जगह होती है जहां से यात्री सार्वजनिक परिवहन में बैठते और उतरते हैं. जैसे, प्लैटफ़ॉर्म या बस स्टॉप. यह Departure से अलग है. Departure, किसी वाहन के किसी स्टॉप से किसी खास समय पर निकलने का इवेंट होता है.

फ़ील्ड
id

string

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

display_name

LocalizedText

स्टॉप का नाम.

platform_code

LocalizedText

यह स्टॉप जिस प्लैटफ़ॉर्म का कोड दिखाता है. इसे किसी भी फ़ॉर्मैट में लिखा जा सकता है. (उदाहरण के लिए: "2", "प्लैटफ़ॉर्म 2", "2-4" या "1x").

signage_text

LocalizedText

इस प्लैटफ़ॉर्म के लिए साइनबोर्ड पर लिखा गया टेक्स्ट, जैसे कि "सेंट्रल की ओर" या "ईस्ट साइड और ब्रुकलिन". platform_code मौजूद न होने पर, यह फ़ील्ड प्लैटफ़ॉर्म के लिए सिर्फ़ आइडेंटिफ़ायर हो सकता है. हालांकि, platform_code और signage_text, दोनों को एक साथ सेट किया जा सकता है.

stop_code

LocalizedText

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

location

LatLng

स्टॉप की जगह की जानकारी.

wheelchair_accessible_entrance

bool

इस स्टॉप पर व्हीलचेयर ले जाने की सुविधा है या नहीं. इस फ़ील्ड से पता चलता है कि स्टेशन के बाहर से स्टॉप तक व्हीलचेयर से पहुंचने के लिए कोई रास्ता है या नहीं. इससे यह नहीं पता चलता कि स्टॉप से वाहन पर चढ़ा जा सकता है या नहीं.

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 के साथ काम नहीं करता. यह सुविधा सिर्फ़ उन देशों में उपलब्ध है जिनके नाम दो पहिया वाहनों के लिए उपलब्ध देशों और इलाकों की सूची में दिए गए हैं.