परिचय
जगह का आईडी मिलने के बाद, किसी खास जगह या दिलचस्पी की जगह के बारे में ज़्यादा जानकारी का अनुरोध किया जा सकता है. इसके लिए, जगह की जानकारी (नई) का अनुरोध करें. जगह की जानकारी (नई) के लिए किए गए अनुरोध से, बताई गई जगह के बारे में ज़्यादा जानकारी मिलती है. जैसे, उसका पूरा पता, फ़ोन नंबर, उपयोगकर्ता की रेटिंग, और समीक्षाएं.
जगह का आईडी पाने के कई तरीके हैं. आप इसका उपयोग कर सकते हैं:
- टेक्स्ट खोज (नई सुविधा) या आस-पास की जगहें खोजने की सुविधा (नई सुविधा)
- Geocoding API
- Routes API
- Address Validation API
- ऑटोकंप्लीट (नया)
एपीआई एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है:
जगह की जानकारी (नई) के अनुरोध
जगह की जानकारी (नई) का अनुरोध, इस फ़ॉर्म में एचटीटीपी 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
जगह की जानकारी (नई) के जवाब
जगह की जानकारी (नई) सेवा, रिस्पॉन्स के तौर पर 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: *
इनमें से एक या उससे ज़्यादा फ़ील्ड डालें:
इन फ़ील्ड से, सिर्फ़ जगह की जानकारी देने वाले आईडी के लिए उपलब्ध SKU ट्रिगर होता है:
attributions
id
moved_place
moved_place_id
name*
photos
*
nameफ़ील्ड में जगह का संसाधन का नाम होता है. यह इस फ़ॉर्म में होता है:places/PLACE_ID. जगह का नाम टेक्स्ट के तौर पर पाने के लिए, Pro SKU मेंdisplayNameफ़ील्ड का अनुरोध करें.इन फ़ील्ड से, Place Details Essentials SKU ट्रिगर होता है:
addressComponents
addressDescriptor*
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport
* पते के बारे में ज़्यादा जानकारी देने वाले शब्दों का इस्तेमाल करने की सुविधा, भारत में रहने वाले खरीदारों के लिए आम तौर पर उपलब्ध है. हालांकि, अन्य देशों में यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है.इन फ़ील्ड से, Place Details Pro एसकेयू ट्रिगर होता है:
accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
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 का इस्तेमाल किया जा सकता है. इसलिए, हो सकता है कि इस सूची में पूरी जानकारी शामिल न हो.
-
अगर
languageCodeनहीं दिया गया है, तो एपीआई डिफ़ॉल्ट रूप सेenपर सेट हो जाता है. अगर आपने अमान्य भाषा कोड डाला है, तो एपीआईINVALID_ARGUMENTगड़बड़ी का मैसेज दिखाता है. - एपीआई, मोहल्ले का ऐसा पता देने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग, दोनों पढ़ सकें. इस लक्ष्य को पूरा करने के लिए, यह स्थानीय भाषा में सड़क के पते दिखाता है. अगर ज़रूरी हो, तो यह पते को ऐसी स्क्रिप्ट में लिप्यंतरित करता है जिसे उपयोगकर्ता पढ़ सकता है. ऐसा करते समय, यह उपयोगकर्ता की पसंदीदा भाषा का ध्यान रखता है. अन्य सभी पते, चुनी गई भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट, एक ही भाषा में दिखाए जाते हैं. यह भाषा, पहले कॉम्पोनेंट से चुनी जाती है.
- अगर नाम आपकी पसंदीदा भाषा में उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
- पसंदीदा भाषा का असर, एपीआई से मिले नतीजों के सेट और उनके क्रम पर पड़ता है. जियोकोडर, भाषा के हिसाब से शॉर्ट फ़ॉर्म का अलग-अलग मतलब निकालता है. जैसे, सड़क के टाइप के लिए इस्तेमाल किए गए शॉर्ट फ़ॉर्म या ऐसे समानार्थी शब्द जो एक भाषा में मान्य हो सकते हैं, लेकिन दूसरी भाषा में नहीं.
regionCode
जवाब को फ़ॉर्मैट करने के लिए इस्तेमाल किया गया क्षेत्र कोड. इसे दो वर्णों वाले CLDR कोड वैल्यू के तौर पर तय किया जाता है. कोई डिफ़ॉल्ट वैल्यू नहीं है.
अगर जवाब में मौजूद
formattedAddressफ़ील्ड में दिए गए देश का नाम,regionCodeमें दिए गए देश के नाम से मेल खाता है, तोformattedAddressसे देश का कोड हटा दिया जाता है. इस पैरामीटर काadrFormatAddressपर कोई असर नहीं पड़ता. इसमें हमेशा देश का नाम शामिल होता है. साथ ही, इसकाshortFormattedAddressपर भी कोई असर नहीं पड़ता. इसमें देश का नाम कभी शामिल नहीं होता.ज़्यादातर CLDR कोड, ISO 3166-1 कोड के जैसे ही होते हैं. हालांकि, कुछ मामलों में ये अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह "ग्रेट ब्रिटेन और उत्तरी आयरलैंड का यूनाइटेड किंगडम" के लिए है. लागू कानून के आधार पर, इस पैरामीटर से नतीजों पर असर पड़ सकता है.
-
sessionToken
सेशन टोकन, उपयोगकर्ता की ओर से जनरेट की गई ऐसी स्ट्रिंग होती हैं जो ऑटोकंप्लीट (नया) कॉल को "सेशन" के तौर पर ट्रैक करती हैं. 'अपने-आप पूरा होने की सुविधा (नया वर्शन)' सेशन टोकन का इस्तेमाल करती है. इससे, बिलिंग के मकसद से, उपयोगकर्ता की खोज क्वेरी और जगह चुनने के चरणों को अलग-अलग सेशन में ग्रुप किया जाता है. सेशन टोकन, Place Details (New) कॉल में पास किए जाते हैं. ये कॉल, Autocomplete (New) कॉल के बाद किए जाते हैं. ज़्यादा जानकारी के लिए, सेशन टोकन देखें.
जगह की जानकारी (नई) का उदाहरण
यहां दिए गए उदाहरण में, 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 फ़ील्ड का इस्तेमाल करें.
हमेशा के लिए बंद जगहों के लिए, Place Details (New) API, businessStatus फ़ील्ड में CLOSED_PERMANENTLY दिखाता है. साथ ही, रिस्पॉन्स बॉडी में movedPlace और movedPlaceId फ़ील्ड शामिल नहीं करता है.
जिन जगहों के लिए पता बदल गया है, उनके लिए Place Details (New) API, 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" }
नई जगह के बारे में जानकारी का अनुरोध करने के लिए, Place Details (New) के नए अनुरोध में movedPlace फ़ील्ड में Place रिसॉर्स का नाम इस्तेमाल करें.
जिन जगहों को कई बार रिलोकेट किया गया है उनकी मौजूदा जगह की जानकारी पाने के लिए, आपको Place Details (New) के कई अनुरोध करने पड़ सकते हैं. किसी जगह के नतीजे में मौजूद movedPlace और movedPlaceId फ़ील्ड, सिर्फ़ अगली जगह की जानकारी देते हैं. ये आखिरी बार देखी गई जगह की जानकारी नहीं देते. अगर जगह की जानकारी (नई) के अनुरोध के जवाब के मुख्य हिस्से में movedPlace और movedPlaceId फ़ील्ड शामिल नहीं हैं, तो इसका मतलब है कि जगह मौजूदा जगह पर है.
इसे आज़माएं!
APIs Explorer की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.
पेज की दाईं ओर मौजूद, एपीआई आइकॉन api चुनें.
अनुरोध के पैरामीटर में बदलाव करें. यह ज़रूरी नहीं है.
लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें, ताकि APIs Explorer विंडो को बड़ा किया जा सके.