Package google.maps.places.v1

इंडेक्स

जगहें

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

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

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

अनुमति के दायरे

नीचे दिए गए 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

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

string

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

string

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

string

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

LatLng

ज़रूरी नहीं. ऑरिजिन पॉइंट, जिससे डेस्टिनेशन तक की जियोडेसिक दूरी का हिसाब लगाया जाता है. यह वैल्यू distance_meters के तौर पर दिखती है. अगर इस वैल्यू को छोड़ा जाता है, तो जियोडेसिक दूरी नहीं दिखेगी.
input_offset

int32

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

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

bool

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

string

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

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

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

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

bool

ज़रूरी नहीं. अगर फ़ील्ड को 'सही है' पर सेट किया गया है, तो घर या दुकान पर सेवा देने वाले कारोबारों को शामिल करें. घर या दुकान पर सेवा देने वाला कारोबार वह कारोबार होता है जो ग्राहकों को उनके पते पर सेवा देता है या डिलीवरी करता है. हालांकि, कारोबार का कोई स्थायी पता नहीं होता. उदाहरण के लिए, प्लंबर या सफ़ाई की सेवाएं देने वाले कारोबार. उन कारोबारों का Google Maps पर कोई पता या जगह की जानकारी मौजूद नहीं है. इन कारोबारों के लिए, जगहों की जानकारी में 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 में या text को structured_format में बदलने की कोशिश नहीं करनी चाहिए.

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

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

StructuredFormat

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

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

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

StructuredFormat

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

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

StringRange

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

फ़ील्ड
start_offset

int32

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

int32

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

StructuredFormat

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

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

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

फ़ील्ड
main_text

FormattableText

जगह या क्वेरी का नाम दिखाता है.
secondary_text

FormattableText

जगह की पहचान करने या क्वेरी को बेहतर बनाने के लिए, शहर या इलाके जैसी अन्य सुविधाओं को दिखाता है.

सर्कल

LatLng को केंद्र और त्रिज्या के तौर पर इस्तेमाल करके बनाया गया सर्कल.

फ़ील्ड
center

LatLng

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

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

double

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

ContentBlock

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

फ़ील्ड
topic

string

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

LocalizedText

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

References

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

इस कॉन्टेंट के ब्लॉक से जुड़े रेफ़रंस.

ContextualContent

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

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

फ़ील्ड
reviews[]

Review

इस जगह के बारे में की गई समीक्षाओं की सूची, जो जगह की क्वेरी के हिसाब से हो.
photos[]

Photo

जगह की क्वेरी के हिसाब से, इस जगह की फ़ोटो के बारे में जानकारी (इसमें रेफ़रंस भी शामिल हैं).
justifications[]

Justification

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

जगह की जानकारी के लिए उचित वजहें.

वजह

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

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

फ़ील्ड

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

justification इनमें से कोई एक हो सकता है:
review_justification

ReviewJustification

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

BusinessAvailabilityAttributesJustification

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

BusinessAvailabilityAttributesJustification

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative देखें. 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 Mennekes कनेक्टर पर आधारित
EV_CONNECTOR_TYPE_TESLA सामान्य TESLA कनेक्टर. यह उत्तरी अमेरिका में एनएसीएस है, लेकिन दुनिया के अन्य हिस्सों में यह एनएसीएस नहीं हो सकता. जैसे, सीसीएस कॉम्बो 2 (सीसीएस2) या जीबी/टी. यह वैल्यू, कनेक्टर के असल टाइप के बारे में कम बताती है. यह 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 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 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 फ़ॉर्मैट) में रिस्पॉन्स रेंडर करें. अगर यह सेट नहीं किया जाता है, तो कॉल को इमेज मीडिया पर रीडायरेक्ट करने के लिए, एचटीटीपी रीडायरेक्ट जारी किया जाएगा. यह विकल्प, HTTP के अलावा किसी दूसरे तरीके से किए गए अनुरोधों के लिए अनदेखा कर दिया जाता है.

GetPlaceRequest

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

फ़ील्ड
name

string

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

string

ज़रूरी नहीं. अगर आपने अपनी पसंदीदा भाषा सेट की है, तो जगह की जानकारी उसी भाषा में दिखेगी.

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

string

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

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

string

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

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

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

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

LocalizedText

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

string

जगह का ऐसा फ़ोन नंबर जिसे आसानी से पढ़ा जा सके. यह नंबर, देश के हिसाब से फ़ॉर्मैट में होना चाहिए.
international_phone_number

string

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

string

इस जगह का पूरा पता, ताकि लोग उसे आसानी से पढ़ सकें.
short_formatted_address

string

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

AddressComponent

हर इलाके के लेवल के लिए दोहराए गए कॉम्पोनेंट. address_components[] कलेक्शन के बारे में ये बातें ध्यान रखें: - पते के कॉम्पोनेंट के कलेक्शन में, formatted_address से ज़्यादा कॉम्पोनेंट हो सकते हैं. - इस कैटगरी में, formatted_address में शामिल राजनैतिक इकाइयों के अलावा, ऐसी सभी राजनैतिक इकाइयां शामिल नहीं होतीं जिनमें कोई पता हो. किसी खास पते वाली सभी राजनैतिक इकाइयों को वापस पाने के लिए, आपको रिवर्स जियोकोडिंग का इस्तेमाल करना चाहिए. इसके लिए, अनुरोध में पते के अक्षांश/देशांतर को पैरामीटर के तौर पर पास करें. - यह ज़रूरी नहीं है कि अनुरोधों के बीच जवाब का फ़ॉर्मैट एक जैसा ही रहे. खास तौर पर, 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][google.maps.places.v1.Place.OpeningHours.Period.open] अवधि के तौर पर दिखाए जाने पर भरोसा कर सकते हैं. इसमें [day][Point.day] की वैल्यू 0, [hour][Point.hour] की वैल्यू 0, और [minute][Point.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

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

OpeningHours

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

LocalizedText

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

PaymentOptions

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

ParkingOptions

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

SubDestination

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

FuelOptions

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

EVChargeOptions

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

GenerativeSummary

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

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

AreaSummary

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

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

ContainingPlace

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

AddressDescriptor

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

PriceRange

किसी जगह की कीमत की सीमा.
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 नोटेशन में, इस कॉम्पोनेंट को फ़ॉर्मैट करने के लिए इस्तेमाल की गई भाषा.

AreaSummary

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

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

फ़ील्ड
content_blocks[]

ContentBlock

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

string

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

एट्रिब्यूशन

इस जगह के डेटा उपलब्ध कराने वाली कंपनियों के बारे में जानकारी.

फ़ील्ड
provider

string

जगह का डेटा उपलब्ध कराने वाली कंपनी का नाम.
provider_uri

string

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

BusinessStatus

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

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

ContainingPlace

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

फ़ील्ड
name

string

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

string

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

GenerativeSummary

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

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

फ़ील्ड
overview

LocalizedText

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

string

एक लिंक, जहां उपयोगकर्ता खास जानकारी की खास जानकारी के साथ किसी समस्या की शिकायत कर सकते हैं.
description

LocalizedText

जगह की पूरी जानकारी.
description_flag_content_uri

string

ऐसा लिंक जहां उपयोगकर्ता, समस्या की खास जानकारी के साथ उसे फ़्लैग कर सकते हैं.
references

References

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

OpeningHours

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

फ़ील्ड
periods[]

Period

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

string

स्थानीय भाषा में लिखी गई ऐसी स्ट्रिंग जिनमें इस जगह के खुले होने के समय के बारे में बताया गया हो. हफ़्ते के हर दिन के लिए एक स्ट्रिंग. अगर काम के घंटों की जानकारी नहीं है या उन्हें स्थानीय भाषा के हिसाब से बदला नहीं जा सका, तो यह फ़ील्ड खाली रहेगा. उदाहरण: "रविवार: 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, Ramberg, Norway". इसमें ग्लोबल कोड का सफ़िक्स होता है और प्रीफ़िक्स को रेफ़रंस इकाई के फ़ॉर्मैट किए गए नाम से बदल दिया जाता है.

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

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

रेफ़रंस

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

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

फ़ील्ड
reviews[]

Review

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

string

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

समीक्षा करें

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

फ़ील्ड
name

string

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

string

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

LocalizedText

समीक्षा का स्थानीय भाषा में अनुवाद किया गया टेक्स्ट.
original_text

LocalizedText

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

double

यह संख्या 1.0 से 5.0 के बीच की होती है. इसे स्टार की संख्या भी कहा जाता है.
author_attribution

AuthorAttribution

इस समीक्षा को लिखने वाले का नाम.
publish_time

Timestamp

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

string

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

string

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

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

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

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

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

string

https://developers.google.com/maps/documentation/places/web-service/place-types पर मौजूद जगह का टाइप (उदाहरण के लिए, "restaurant" या "gas_station").

टेबल 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 टाइप तक दिए जा सकते हैं.

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

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

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

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

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

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

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

RankPreference

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

string

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

bool

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

double

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

int32

बंद कर दिया गया है: इसके बजाय, page_size का इस्तेमाल करें.

हर पेज पर दिखाए जा सकने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. अगर उपलब्ध नतीजों की संख्या max_result_count से ज़्यादा है, तो next_page_token दिखाया जाता है. इसे page_token को पास किया जा सकता है, ताकि अगले अनुरोधों में नतीजों का अगला पेज मिल सके. अगर 0 या कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से 20 का इस्तेमाल किया जाता है. ज़्यादा से ज़्यादा वैल्यू 20 है. 20 से ज़्यादा वैल्यू को 20 पर सेट कर दिया जाएगा. नेगेटिव वैल्यू देने पर, INVALID_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

included_type के लिए, सख्त टाइप फ़िल्टरिंग सेट करने के लिए इस्तेमाल किया जाता है. अगर इसे 'सही है' पर सेट किया जाता है, तो सिर्फ़ एक ही तरह के नतीजे दिखाए जाएंगे. डिफ़ॉल्ट रूप से गलत पर सेट होती है.
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 पर कोई पता या जगह की जानकारी मौजूद नहीं है. इन कारोबारों के लिए, जगहों की जानकारी में 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 "न्यूयॉर्क सिटी में रेस्टोरेंट" जैसी कैटगरी वाली क्वेरी के लिए, काम की जानकारी दिखाने की सुविधा डिफ़ॉल्ट रूप से चालू होती है. हमारा सुझाव है कि "माउंटेन व्यू, कैलिफ़ोर्निया" जैसी कैटगरी वाली क्वेरी के लिए, 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 पर अनुरोध में दी गई थी.

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