परिचय
जगह का आईडी मिलने के बाद, किसी खास जगह या दिलचस्पी की जगह के बारे में ज़्यादा जानकारी का अनुरोध किया जा सकता है. इसके लिए, जगह के बारे में ज़्यादा जानकारी (नया) का अनुरोध करें. जगह की जानकारी (नई) के लिए किए गए अनुरोध से, बताई गई जगह के बारे में ज़्यादा जानकारी मिलती है. जैसे, उसका पूरा पता, फ़ोन नंबर, उपयोगकर्ता की रेटिंग, और समीक्षाएं.
किसी जगह का आईडी पाने के कई तरीके हैं. आप इसका उपयोग कर सकते हैं:
- टेक्स्ट खोज (नई सुविधा) या आस-पास की जगहें खोजने की सुविधा (नई सुविधा)
- Geocoding API
- Routes API
- Address Validation API
- ऑटोकंप्लीट (नया)
APIs Explorer की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है:
Place Details (New) के अनुरोध
जगह के बारे में ज़्यादा जानकारी (नया) का अनुरोध, इस तरह का एचटीटीपी GET अनुरोध होता है:
https://places.googleapis.com/v1/places/PLACE_ID
सभी पैरामीटर को यूआरएल पैरामीटर के तौर पर या हेडर में GET अनुरोध के हिस्से के तौर पर पास करें. उदाहरण के लिए:
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEYया कर्ल कमांड में:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Place Details (New) API के जवाब
जगह के बारे में ज़्यादा जानकारी (नया) सेवा, रिस्पॉन्स के तौर पर JSON ऑब्जेक्ट दिखाती है. जवाब में:
- रिस्पॉन्स को
Placeऑब्जेक्ट के तौर पर दिखाया जाता है.Placeऑब्जेक्ट में जगह के बारे में पूरी जानकारी होती है. - अनुरोध में पास किया गया FieldMask, उन फ़ील्ड की सूची तय करता है जिन्हें
Placeऑब्जेक्ट में दिखाया जाता है.
पूरा JSON ऑब्जेक्ट इस फ़ॉर्म में होता है:
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
ज़रूरी पैरामीटर
-
FieldMask
जवाब फ़ील्ड मास्क बनाकर, जवाब में दिखाए जाने वाले फ़ील्ड की सूची तय करें. यूआरएल पैरामीटर
$fieldsयाfieldsका इस्तेमाल करके, रिस्पॉन्स फ़ील्ड मास्क को तरीके से पास करें. इसके अलावा, एचटीटीपी हेडरX-Goog-FieldMaskका इस्तेमाल करके भी ऐसा किया जा सकता है. जवाब में, लौटाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. फ़ील्ड मास्क शामिल न करने पर, यह तरीका गड़बड़ी का मैसेज दिखाता है.फ़ील्ड मास्किंग, डिज़ाइन का एक अच्छा तरीका है. इससे यह पक्का किया जा सकता है कि आपने बिना वजह डेटा का अनुरोध न किया हो. इससे, बिना वजह प्रोसेसिंग में लगने वाले समय और बिलिंग के शुल्कों से बचा जा सकता है.
कॉमा लगाकर अलग किए गए, जगह के डेटा टाइप की सूची दें. उदाहरण के लिए, जगह का डिसप्ले नेम और पता वापस पाने के लिए.
X-Goog-FieldMask: displayName,formattedAddress
सभी फ़ील्ड वापस पाने के लिए,
*का इस्तेमाल करें.X-Goog-FieldMask: *
इनमें से एक या उससे ज़्यादा फ़ील्ड डालें:
इन फ़ील्ड से, सिर्फ़ जगह की जानकारी देने वाले आईडी के लिए एसकेयू ट्रिगर होता है:
attributions
id
moved_place
moved_place_id
name*
photos
*
nameफ़ील्ड में, जगह का संसाधन का नाम इस फ़ॉर्म में होता है:places/PLACE_ID. जगह का नाम टेक्स्ट के तौर पर पाने के लिए, Pro SKU मेंdisplayNameफ़ील्ड का अनुरोध करें.इन फ़ील्ड से, जगह की जानकारी देने वाले Essentials SKU ट्रिगर होते हैं:
addressComponents
addressDescriptor*
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport
* पता बताने वाले शब्दों की सुविधा, भारत में खरीदारों के लिए आम तौर पर उपलब्ध है. हालांकि, अन्य देशों में यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है.
इन फ़ील्ड से, जगह की जानकारी देने वाला Pro SKU ट्रिगर होता है:
accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
timeZone
utcOffsetMinutes
इन फ़ील्ड से, जगह की जानकारी देने वाले Enterprise SKU ट्रिगर होते हैं:
currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
userRatingCount
websiteUriइन फ़ील्ड से, Place Details Enterprise + Atmosphere SKU ट्रिगर होता है:
allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeAmenitySummary
evChargeOptions
fuelOptions
generativeSummary
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
neighborhoodSummary
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
reviewSummary
routingSummaries*
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
* सिर्फ़ टेक्स्ट खोज और आस-पास की जगहें खोजने की सुविधा के लिए
-
placeId
यह टेक्स्ट वाला आइडेंटिफ़ायर होता है. इसकी मदद से किसी जगह की खास तौर पर पहचान की जाती है. यह टेक्स्ट खोज (नई) या आस-पास खोज (नई) से मिलता है. जगह के आईडी के बारे में ज़्यादा जानने के लिए, जगह के आईडी की खास जानकारी देखें.
स्ट्रिंग
places/PLACE_IDको जगह का संसाधन नाम भी कहा जाता है. जगह की जानकारी (नया), आस-पास की जगहों की जानकारी (नया), और टेक्स्ट से खोजें (नया) के अनुरोध के जवाब में, यह स्ट्रिंगnameफ़ील्ड में शामिल होती है. स्टैंडअलोन जगह का आईडी, रिस्पॉन्स केidफ़ील्ड में मौजूद होता है.
ज़रूरी नहीं पैरामीटर
languageCode
वह भाषा जिसमें नतीजे दिखाने हैं.
- इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें. Google, अक्सर उन भाषाओं को अपडेट करता है जिनमें Gemini Apps काम करता है. इसलिए, हो सकता है कि इस सूची में पूरी जानकारी शामिल न हो.
-
अगर
languageCodeनहीं दिया जाता है, तो एपीआई डिफ़ॉल्ट रूप सेenको चुनता है. अगर आपने अमान्य भाषा कोड डाला है, तो एपीआईINVALID_ARGUMENTगड़बड़ी का मैसेज दिखाता है. - एपीआई, मोहल्ले का ऐसा पता देने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग, दोनों पढ़ सकें. इस लक्ष्य को पूरा करने के लिए, यह स्थानीय भाषा में सड़क के पते दिखाता है. अगर ज़रूरी हो, तो यह पते को ऐसी स्क्रिप्ट में लिप्यंतरित करता है जिसे उपयोगकर्ता पढ़ सकता है. ऐसा करते समय, यह उपयोगकर्ता की पसंदीदा भाषा का ध्यान रखता है. अन्य सभी पते, चुनी गई भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट, एक ही भाषा में दिखाए जाते हैं. यह भाषा, पहले कॉम्पोनेंट से चुनी जाती है.
- अगर नाम आपकी पसंदीदा भाषा में उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
- पसंदीदा भाषा का असर, एपीआई से मिले नतीजों के सेट और उनके क्रम पर पड़ता है. जियोकोडर, भाषा के हिसाब से शॉर्ट फ़ॉर्म का अलग-अलग मतलब निकालता है. जैसे, सड़क के टाइप के लिए इस्तेमाल किए गए शॉर्ट फ़ॉर्म या ऐसे समानार्थी शब्द जो एक भाषा में मान्य हो सकते हैं, लेकिन दूसरी भाषा में नहीं.
regionCode
जवाब को फ़ॉर्मैट करने के लिए इस्तेमाल किया गया क्षेत्र कोड. इसे दो वर्णों वाले CLDR कोड वैल्यू के तौर पर तय किया जाता है. कोई डिफ़ॉल्ट वैल्यू नहीं है.
अगर जवाब में मौजूद
formattedAddressफ़ील्ड में दिए गए देश का नाम,regionCodeसे मेल खाता है, तोformattedAddressसे देश का कोड हटा दिया जाता है. इस पैरामीटर काadrFormatAddressपर कोई असर नहीं पड़ता. इसमें हमेशा देश का नाम शामिल होता है. साथ ही, इसकाshortFormattedAddressपर भी कोई असर नहीं पड़ता. इसमें देश का नाम कभी शामिल नहीं होता.ज़्यादातर CLDR कोड, ISO 3166-1 कोड के जैसे ही होते हैं. हालांकि, कुछ मामलों में ये अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह "ग्रेट ब्रिटेन और उत्तरी आयरलैंड का यूनाइटेड किंगडम" के लिए है. लागू कानून के आधार पर, इस पैरामीटर से नतीजों पर असर पड़ सकता है.
-
sessionToken
सेशन टोकन, उपयोगकर्ता की ओर से जनरेट की गई ऐसी स्ट्रिंग होती हैं जो ऑटोकंप्लीट (नया) कॉल को "सेशन" के तौर पर ट्रैक करती हैं. Autocomplete (नया) सुविधा, सेशन टोकन का इस्तेमाल करती है. इससे, बिलिंग के मकसद से, उपयोगकर्ता की ऑटोकंप्लीट खोज की क्वेरी और प्लेस सिलेक्शन फ़ेज़ को अलग सेशन में ग्रुप किया जाता है. सेशन टोकन, Place Details (नया) के उन कॉल में पास किए जाते हैं जो Autocomplete (नया) के कॉल के बाद किए जाते हैं. ज़्यादा जानकारी के लिए, सेशन टोकन देखें.
Place Details (नई) का उदाहरण
यहां दिए गए उदाहरण में, placeId के ज़रिए किसी जगह की जानकारी का अनुरोध किया गया है:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
ध्यान दें कि X-Goog-FieldMask हेडर से पता चलता है कि response में ये डेटा फ़ील्ड शामिल हैं: id,displayName.
इसके बाद, जवाब इस फ़ॉर्म में होता है:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" } }
ज़्यादा जानकारी पाने के लिए, फ़ील्ड मास्क में ज़्यादा डेटा टाइप जोड़ें.
उदाहरण के लिए, जवाब में पता और प्लस कोड शामिल करने के लिए, formattedAddress,plusCode जोड़ें:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
अब जवाब इस फ़ॉर्म में है:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "plusCode": { "globalCode": "849VCWC7+RW", "compoundCode": "CWC7+RW Mountain View, CA, USA" }, "displayName": { "text": "Googleplex", "languageCode": "en" } }
Address descriptors पाना
पते के डिस्क्रिप्टर, किसी जगह की लोकेशन के बारे में जानकारी देते हैं. इसमें आस-पास के लैंडमार्क और इलाके शामिल हैं.
यहां सैन होज़े के किसी मॉल में मौजूद डिपार्टमेंट स्टोर के लिए, जगह के बारे में ज़्यादा जानकारी (नया) के अनुरोध का उदाहरण दिया गया है. इस उदाहरण में, फ़ील्ड मास्क में addressDescriptors
शामिल किया गया है:
curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: name,displayName,addressDescriptor"
जवाब में, अनुरोध में बताई गई जगह की जानकारी शामिल होती है. साथ ही, आस-पास के लैंडमार्क की सूची और जगह से उनकी दूरी की जानकारी भी शामिल होती है. इसके अलावा, जगहों की सूची और जगह से उनके जुड़ाव की जानकारी भी शामिल होती है:
{ "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4", "displayName": { "text": "Macy's", "languageCode": "en" }, "addressDescriptor": { "landmarks": [ { "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s", "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "food", "movie_theater", "point_of_interest", "restaurant", "shoe_store", "shopping_mall", "store" ], "spatialRelationship": "WITHIN", "straightLineDistanceMeters": 220.29175 }, { "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4", "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4", "displayName": { "text": "Nordstrom", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "point_of_interest", "shoe_store", "store" ], "straightLineDistanceMeters": 329.45178 }, { "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE", "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE", "displayName": { "text": "Monroe Parking Garage", "languageCode": "en" }, "types": [ "establishment", "parking", "point_of_interest" ], "straightLineDistanceMeters": 227.05153 }, { "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM", "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM", "displayName": { "text": "Studios Inn by Daiwa Living California Inc.", "languageCode": "en" }, "types": [ "establishment", "lodging", "point_of_interest", "real_estate_agency" ], "straightLineDistanceMeters": 299.9955 }, { "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "displayName": { "text": "Din Tai Fung", "languageCode": "en" }, "types": [ "establishment", "food", "point_of_interest", "restaurant" ], "straightLineDistanceMeters": 157.70943 } ], "areas": [ { "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "displayName": { "text": "Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM", "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM", "displayName": { "text": "Central San Jose", "languageCode": "en" }, "containment": "WITHIN" } ] } }
किसी जगह की जानकारी पाना
अगर आपके ऐप्लिकेशन में बताई गई किसी जगह को दूसरी जगह पर ले जाया गया है, तो नई जगह की जानकारी पाने के लिए, movedPlace और movedPlaceId फ़ील्ड का इस्तेमाल करें.
जो जगहें हमेशा के लिए बंद हो गई हैं उनके लिए, जगह के बारे में ज़्यादा जानकारी (नई) के अनुरोध पर, businessStatus फ़ील्ड में CLOSED_PERMANENTLY वैल्यू मिलती है. साथ ही, जवाब के मुख्य हिस्से में movedPlace और movedPlaceId फ़ील्ड शामिल नहीं होते हैं.
जिन जगहों का पता बदल गया है उनके लिए, जगह के बारे में ज़्यादा जानकारी (नई) सेवा, businessStatus फ़ील्ड में CLOSED_PERMANENTLY दिखाती है. साथ ही, जवाब के मुख्य हिस्से के movedPlace और movedPlaceId फ़ील्ड में नया पता दिखाती है.
जिन जगहों की जानकारी नहीं बदली है उनके लिए, जगह के बारे में ज़्यादा जानकारी (नई) के अनुरोध पर, जवाब के मुख्य हिस्से में movedPlace या movedPlaceId नहीं मिलता.
यहां दिए गए उदाहरण में, कनाडा के क्यूबेक में मौजूद Marche IGA St-Canut के बारे में जानकारी का अनुरोध किया गया है:
curl -X GET -H 'Content-Type: application/json' \ -H 'x-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \ https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ
अनुरोध करने पर, यह जवाब मिलता है:
{ "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ", "businessStatus": "CLOSED_PERMANENTLY", "displayName": { "text": "Marche IGA St-Canut", "languageCode": "en" }, "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ", "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ" }
नई जगह के बारे में जानकारी का अनुरोध करने के लिए, जगह के बारे में ज़्यादा जानकारी (नई) के नए अनुरोध में, movedPlace फ़ील्ड में जगह के संसाधन का नाम इस्तेमाल करें.
जिन जगहों को कई बार रिलोकेट किया गया है उनकी मौजूदा जगह की जानकारी पाने के लिए, आपको Place Details (New) के कई अनुरोध करने पड़ सकते हैं. किसी जगह के नतीजे में मौजूद movedPlace और movedPlaceId फ़ील्ड, सिर्फ़ अगली जगह की जानकारी देते हैं. ये आखिरी बार देखी गई जगह की जानकारी नहीं देते. अगर जगह के बारे में ज़्यादा जानकारी (नया) के अनुरोध के जवाब में, movedPlace और movedPlaceId फ़ील्ड शामिल नहीं हैं, तो इसका मतलब है कि जगह मौजूदा जगह पर है.
इसे आज़माएं!
APIs Explorer की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.
पेज की दाईं ओर मौजूद, एपीआई आइकॉन api चुनें.
अनुरोध के पैरामीटर में बदलाव करें. यह ज़रूरी नहीं है.
लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन फ़ुलस्क्रीन को चुनें. इससे APIs Explorer विंडो बड़ी हो जाएगी.