परिचय
आस-पास की जगहों की जानकारी (नई) के लिए किए गए अनुरोध में, एक या उससे ज़्यादा तरह की जगहों की जानकारी शामिल होती है. इसके जवाब में, तय किए गए इलाके में मौजूद मिलती-जुलती जगहों की सूची मिलती है. एक फ़ील्ड मास्क की ज़रूरत होती है, जिसमें एक या उससे ज़्यादा डेटा टाइप दिए गए हों. आस-पास की जगहों की जानकारी खोजने की नई सुविधा सिर्फ़ POST अनुरोधों के साथ काम करती है.
एपीआई एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है:
मैप पर आस-पास की जगहों की जानकारी (नया) के नतीजे देखने के लिए, इंटरैक्टिव डेमो आज़माएं.
आस-पास की जगहों की जानकारी (नई) के लिए किए गए अनुरोध
Nearby Search (नया) का अनुरोध, इस तरह के यूआरएल पर एचटीटीपी पोस्ट करने का अनुरोध होता है:
https://places.googleapis.com/v1/places:searchNearby
सभी पैरामीटर को JSON अनुरोध के मुख्य हिस्से में या हेडर में, POST अनुरोध के हिस्से के तौर पर पास करें. उदाहरण के लिए:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby
आस-पास की जगहों की जानकारी (नई) के जवाब
आस-पास की जगहों की जानकारी (नई) रिस्पॉन्स के तौर पर JSON ऑब्जेक्ट दिखाती है. जवाब में:
placesकलेक्शन में, मिलती-जुलती सभी जगहें शामिल होती हैं.- ऐरे में मौजूद हर जगह को
Placeऑब्जेक्ट से दिखाया जाता है.Placeऑब्जेक्ट में किसी एक जगह के बारे में ज़्यादा जानकारी होती है. - अनुरोध में पास किया गया FieldMask,
Placeऑब्जेक्ट में दिखाए गए फ़ील्ड की सूची तय करता है.
पूरा JSON ऑब्जेक्ट इस फ़ॉर्म में होता है:
{
"places": [
{
object (Place)
}
]
}ज़रूरी पैरामीटर
-
FieldMask
जवाब फ़ील्ड मास्क बनाकर, जवाब में दिखाए जाने वाले फ़ील्ड की सूची तय करें. यूआरएल पैरामीटर
$fieldsयाfieldsका इस्तेमाल करके, रिस्पॉन्स फ़ील्ड मास्क को तरीके से पास करें. इसके अलावा, एचटीटीपी हेडरX-Goog-FieldMaskका इस्तेमाल करके भी ऐसा किया जा सकता है. जवाब में, लौटाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. फ़ील्ड मास्क शामिल न करने पर, यह तरीका गड़बड़ी का मैसेज दिखाता है.फ़ील्ड मास्किंग, डिज़ाइन का एक अच्छा तरीका है. इससे यह पक्का किया जा सकता है कि आपने बिना ज़रूरत के डेटा का अनुरोध न किया हो. इससे, प्रोसेसिंग में लगने वाले समय और बिलिंग के शुल्कों को कम करने में मदद मिलती है.
जगह के डेटा टाइप की कॉमा लगाकर अलग की गई लिस्ट दें, ताकि उन्हें दिखाया जा सके. उदाहरण के लिए, जगह का डिसप्ले नेम और पता वापस पाने के लिए.
X-Goog-FieldMask: places.displayName,places.formattedAddress
सभी फ़ील्ड वापस पाने के लिए,
*का इस्तेमाल करें.X-Goog-FieldMask: *
इनमें से एक या उससे ज़्यादा फ़ील्ड डालें:
इन फ़ील्ड से आस-पास की जगहों की जानकारी Search Pro SKU ट्रिगर होता है:
places.accessibilityOptions
places.addressComponents
places.addressDescriptor*
places.adrFormatAddress
places.attributions
places.businessStatus
places.consumerAlert
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks
places.googleMapsTypeLabel
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.id
places.location
places.name**
places.movedPlace
places.movedPlaceId
places.openingDate
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.timeZone
places.types
places.utcOffsetMinutes
places.viewport
* पता बताने वाले शब्दों की सुविधा, भारत में रहने वाले खरीदारों के लिए आम तौर पर उपलब्ध है. हालांकि, अन्य देशों में यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है.
**places.nameफ़ील्ड में, जगह का संसाधन का नाम इस फ़ॉर्म में होता है:places/PLACE_ID. जगह के नाम को टेक्स्ट के तौर पर ऐक्सेस करने के लिए,places.displayNameका इस्तेमाल करें.फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.
इन फ़ील्ड से आस-पास की जगहों की जानकारी Enterprise एसकेयू ट्रिगर होता है:
places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.transitStation
places.userRatingCount
places.websiteUriफ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.
इन फ़ील्ड से आस-पास की जगहों की जानकारी Enterprise + Atmosphere एसकेयू ट्रिगर होता है:
places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
routingSummaries*
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
* टेक्स्ट से खोजें और आस-पास की जगहों की जानकारी के लिएफ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.
-
locationRestriction
खोज के लिए तय किया गया क्षेत्र, जिसे एक सर्कल के तौर पर दिखाया गया है. इसे केंद्र बिंदु और मीटर में रेडियस के हिसाब से तय किया जाता है. रेडियस, 0.0 और 50000.0 के बीच होना चाहिए. हालांकि, इन दोनों में से भी कोई संख्या हो सकती है. डिफ़ॉल्ट रेडियस 0.0 होता है. आपको अपने अनुरोध में, इसे 0.0 से ज़्यादा पर सेट करना होगा.
उदाहरण के लिए:
"locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
ज़रूरी नहीं पैरामीटर
-
includeFutureOpeningBusinesses
अगर
trueहै, तो इससे ऐसे कारोबारों के नतीजे दिखते हैं जो आने वाले समय में खुलने वाले हैं. डिफ़ॉल्ट रूप से, यहfalseपर सेट होता है.
कारोबार की स्थिति वापस पाने के लिए, अपने अनुरोध फ़ील्ड मास्क मेंplaces.businessStatusशामिल करें. कारोबार शुरू होने की अनुमानित तारीख पाने के लिए, अपने अनुरोध फ़ील्ड मास्क मेंplaces.openingDateशामिल करें. -
includedTypes/excludedTypes, includedPrimaryTypes/excludedPrimaryTypes
इस विकल्प की मदद से, टेबल A में मौजूद टाइप की सूची तय की जा सकती है. इसका इस्तेमाल खोज के नतीजों को फ़िल्टर करने के लिए किया जाता है. पाबंदी के हर टाइप की कैटगरी में, ज़्यादा से ज़्यादा 50 टाइप दिए जा सकते हैं.
किसी जगह के लिए, टेबल A में दिए गए टाइप में से सिर्फ़ एक प्राइमरी टाइप चुना जा सकता है. उदाहरण के लिए, प्राइमरी टाइप
"mexican_restaurant"या"steak_house"हो सकता है. किसी जगह के मुख्य टाइप के हिसाब से नतीजों को फ़िल्टर करने के लिए,includedPrimaryTypesऔरexcludedPrimaryTypesका इस्तेमाल करें.किसी जगह के लिए, उससे जुड़ी टेबल A में मौजूद एक से ज़्यादा टाइप वैल्यू भी हो सकती हैं. उदाहरण के लिए, किसी रेस्टोरेंट के ये टाइप हो सकते हैं:
"seafood_restaurant","restaurant","food","point_of_interest","establishment". किसी जगह से जुड़े टाइप की सूची में मौजूद नतीजों को फ़िल्टर करने के लिए,includedTypesऔरexcludedTypesका इस्तेमाल करें.जब
"restaurant"या"hotel"जैसे सामान्य प्राइमरी टाइप के बारे में बताया जाता है, तो जवाब में ऐसे स्थान शामिल हो सकते हैं जिनका प्राइमरी टाइप, बताए गए प्राइमरी टाइप से ज़्यादा सटीक हो. उदाहरण के लिए, आपने"restaurant"को शामिल करने के लिए कहा है. इसके बाद, जवाब में"restaurant"प्राइमरी टाइप वाली जगहें शामिल हो सकती हैं. हालांकि, जवाब में"chinese_restaurant"या"seafood_restaurant"जैसे ज़्यादा खास प्राइमरी टाइप वाली जगहें भी शामिल हो सकती हैं.अगर किसी खोज में कई तरह की पाबंदियां लगाई गई हैं, तो सिर्फ़ वे जगहें दिखाई जाती हैं जो सभी पाबंदियों को पूरा करती हैं. उदाहरण के लिए, अगर आपने
{"includedTypes": ["restaurant"], "excludedPrimaryTypes": ["steak_house"]}के तौर पर जानकारी दी है, तो खोज के नतीजों में दिखने वाली जगहों पर"restaurant"से जुड़ी सेवाएं मिलती हैं. हालांकि, ये मुख्य रूप से"steak_house"के तौर पर काम नहीं करती हैं.includedTypes
टेबल A में मौजूद जगहों के टाइप की कॉमा लगाकर अलग की गई लिस्ट, जिसे खोजना है. अगर इस पैरामीटर को शामिल नहीं किया जाता है, तो सभी तरह की जगहों की जानकारी मिलती है.
excludedTypes
टेबल A में मौजूद जगहों के टाइप की ऐसी कॉमा लगाकर अलग की गई लिस्ट जिन्हें खोज के नतीजों में शामिल नहीं किया जाता.
अगर अनुरोध में
includedTypes( जैसे कि"school") औरexcludedTypes(जैसे कि"primary_school") दोनों को शामिल किया जाता है, तो जवाब में वे जगहें शामिल होती हैं जिन्हें"school"के तौर पर कैटगरी में रखा गया है, लेकिन"primary_school"के तौर पर नहीं. जवाब में ऐसी जगहें शामिल हैं जोincludedTypesमें से कम से कम एक से मैच करती हैं औरexcludedTypesमें से किसी से भी मैच नहीं करती हैं.अगर कोई टाइप दोनों में दिखता है, जैसे कि
includedTypesऔरexcludedTypes, तोINVALID_REQUESTगड़बड़ी दिखती है.includedPrimaryTypes
यह टेबल A में दिए गए मुख्य जगहों के टाइप की कॉमा लगाकर अलग की गई लिस्ट होती है. इसे खोज में शामिल किया जाता है.
excludedPrimaryTypes
टेबल A में मौजूद मुख्य जगहों के टाइप की कॉमा लगाकर अलग की गई सूची. इसका इस्तेमाल, खोज के नतीजों से किसी जगह को हटाने के लिए किया जाता है.
अगर प्राइमरी टाइप में कोई टकराव होता है, जैसे कि कोई टाइप
includedPrimaryTypesऔरexcludedPrimaryTypes, दोनों में दिखता है, तोINVALID_ARGUMENTगड़बड़ी दिखती है. -
languageCode
वह भाषा जिसमें नतीजे दिखाने हैं.
- इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें. Google, इस सुविधा के लिए उपलब्ध भाषाओं को अक्सर अपडेट करता रहता है. इसलिए, हो सकता है कि इस सूची में पूरी जानकारी शामिल न हो.
- अगर
languageCodeनहीं दिया गया है, तो एपीआई डिफ़ॉल्ट रूप सेenको चुनता है. अगर आपने अमान्य भाषा कोड डाला है, तो एपीआईINVALID_ARGUMENTगड़बड़ी का मैसेज दिखाता है. - एपीआई, मोहल्ले का ऐसा पता देने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग, दोनों पढ़ सकें. इस लक्ष्य को पूरा करने के लिए, यह स्थानीय भाषा में सड़क के पते दिखाता है. अगर ज़रूरी हो, तो उपयोगकर्ता की पसंदीदा भाषा में लिखे गए पते को लिप्यंतरित भी करता है. अन्य सभी पते, चुनी गई भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट, एक ही भाषा में दिखाए जाते हैं. यह भाषा, पहले कॉम्पोनेंट से चुनी जाती है.
- अगर नाम आपकी पसंदीदा भाषा में उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
- पसंदीदा भाषा का असर, एपीआई के चुने गए नतीजों के सेट और उनके क्रम पर पड़ता है. जियोकोडर, भाषा के हिसाब से शब्दों के संक्षिप्त रूप का अलग-अलग मतलब निकालता है. जैसे, सड़क के टाइप के लिए इस्तेमाल किए गए संक्षिप्त रूप या ऐसे समानार्थी शब्द जो एक भाषा में मान्य हो सकते हैं, लेकिन दूसरी भाषा में नहीं.
-
maxResultCount
जगह के नतीजों की ज़्यादा से ज़्यादा संख्या तय करता है. यह 1 और 20 (डिफ़ॉल्ट) के बीच होना चाहिए.
-
rankPreference
इस्तेमाल की जाने वाली रैंकिंग का टाइप. अगर इस पैरामीटर को शामिल नहीं किया जाता है, तो नतीजों को लोकप्रियता के हिसाब से रैंक किया जाता है. यह इनमें से कोई एक हो सकता है:
POPULARITY(डिफ़ॉल्ट) नतीजों को उनकी लोकप्रियता के आधार पर क्रम से लगाता है.DISTANCEनतीजों को, बताई गई जगह से उनकी दूरी के हिसाब से बढ़ते क्रम में क्रमबद्ध करता है.
-
regionCode
जवाब को फ़ॉर्मैट करने के लिए इस्तेमाल किया गया क्षेत्र कोड. इसे दो वर्णों वाले CLDR कोड वैल्यू के तौर पर तय किया जाता है. इसकी कोई डिफ़ॉल्ट वैल्यू नहीं होती.
अगर जवाब में मौजूद
formattedAddressफ़ील्ड में दिए गए देश का नाम,regionCodeमें दिए गए देश के नाम से मेल खाता है, तोformattedAddressसे देश का कोड हटा दिया जाता है. इस पैरामीटर काadrFormatAddressपर कोई असर नहीं पड़ता. इसमें हमेशा देश का नाम शामिल होता है. साथ ही, इसकाshortFormattedAddressपर भी कोई असर नहीं पड़ता. इसमें देश का नाम कभी शामिल नहीं होता.ज़्यादातर CLDR कोड, ISO 3166-1 कोड के जैसे ही होते हैं. हालांकि, कुछ मामलों में ये अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह "ग्रेट ब्रिटेन और उत्तरी आयरलैंड का यूनाइटेड किंगडम" के लिए है. लागू कानून के आधार पर, इस पैरामीटर से नतीजों पर असर पड़ सकता है.
आस-पास की जगहों की जानकारी (नई सुविधा) के उदाहरण
एक तरह की जगहें ढूंढना
यहां 500 मीटर के दायरे में मौजूद सभी रेस्टोरेंट के डिसप्ले नेम के लिए, आस-पास की जगहों की जानकारी (नया वर्शन) के अनुरोध का उदाहरण दिया गया है. यह दायरा circle से तय किया गया है:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby
ध्यान दें कि X-Goog-FieldMask हेडर से पता चलता है कि रिस्पॉन्स में ये डेटा फ़ील्ड शामिल हैं: places.displayName.
इसके बाद, जवाब इस फ़ॉर्म में होता है:
{ "places": [ { "displayName": { "text": "La Mar Cocina Peruana", "languageCode": "en" } }, { "displayName": { "text": "Kokkari Estiatorio", "languageCode": "en" } }, { "displayName": { "text": "Harborview Restaurant & Bar", "languageCode": "en" } }, ... }
अतिरिक्त जानकारी पाने के लिए, फ़ील्ड मास्क में ज़्यादा डेटा टाइप जोड़ें.
उदाहरण के लिए, जवाब में रेस्टोरेंट का पता, टाइप, और वेब पता शामिल करने के लिए, places.formattedAddress,places.types,places.websiteUri जोड़ें:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri" \
https://places.googleapis.com/v1/places:searchNearby
जवाब अब इस फ़ॉर्म में है:
{ "places": [ { "types": [ "seafood_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "PIER 1 1/2 The Embarcadero N, San Francisco, CA 94105, USA", "websiteUri": "http://lamarsf.com/", "displayName": { "text": "La Mar Cocina Peruana", "languageCode": "en" } }, { "types": [ "greek_restaurant", "meal_takeaway", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "200 Jackson St, San Francisco, CA 94111, USA", "websiteUri": "https://kokkari.com/", "displayName": { "text": "Kokkari Estiatorio", "languageCode": "en" } }, ... }
कई तरह की जगहें खोजना
यहां दिए गए उदाहरण में, आस-पास की जगहों की जानकारी (नया) के लिए अनुरोध दिखाया गया है. इसमें, तय की गई जगह circle के 1,000 मीटर के दायरे में मौजूद सभी सुविधा स्टोर और शराब की दुकानों के डिसप्ले नेम दिखाने का अनुरोध किया गया है:
curl -X POST -d '{
"includedTypes": ["liquor_store", "convenience_store"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965
},
"radius": 1000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.primaryType,places.types" \
https://places.googleapis.com/v1/places:searchNearby
places.primaryType और places.types जोड़े गए हैं, ताकि जवाब में हर जगह के टाइप की जानकारी शामिल हो. इससे नतीजों में से सही जगह चुनना आसान हो जाता है.
खोज के नतीजों में किसी जगह का टाइप शामिल न करना
यहां सभी "school" टाइप की जगहों के लिए, आस-पास की जगहों की जानकारी (नया) के अनुरोध का उदाहरण दिया गया है. इसमें "primary_school" टाइप की सभी जगहों को शामिल नहीं किया गया है. साथ ही, नतीजों को दूरी के हिसाब से रैंक किया गया है:
curl -X POST -d '{
"includedTypes": ["school"],
"excludedTypes": ["primary_school"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965
},
"radius": 1000.0
}
},
"rankPreference": "DISTANCE"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby
किसी इलाके के आस-पास की सभी जगहों को दूरी के हिसाब से क्रम में लगाना
यहां सैन फ़्रांसिस्को के बाज़ार के पास की जगहों के लिए, आस-पास की खोज (नई) के अनुरोध का उदाहरण दिया गया है. इस उदाहरण में, दूरी के हिसाब से नतीजों को रैंक करने के लिए, rankPreference
पैरामीटर शामिल किया गया है:
curl -X POST -d '{
"maxResultCount": 10,
"rankPreference": "DISTANCE",
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965
},
"radius": 1000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby
Address descriptors पाना
पते के बारे में बताने वाले शब्दों से, किसी जगह की लोकेशन के बारे में जानकारी मिलती है. इसमें आस-पास के लैंडमार्क और इलाके शामिल हैं.
यहां सैन होज़े में मौजूद किसी मॉल के आस-पास की जगहों के लिए, आस-पास की जगहों की जानकारी (नई) के अनुरोध का उदाहरण दिया गया है. इस उदाहरण में, फ़ील्ड मास्क में addressDescriptors
शामिल किया गया है:
curl -X POST -d '{
"maxResultCount": 5,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.321328,
"longitude": -121.946275
},"radius": 1000
}
},
"includedTypes": ["restaurant", "cafe"],
"excludedTypes": [],
"rankPreference":"POPULARITY"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.addressDescriptor" \
https://places.googleapis.com/v1/places:searchNearby
जवाब में, अनुरोध में बताई गई जगह की जानकारी शामिल होती है. साथ ही, आस-पास के लैंडमार्क की सूची और जगह से उनकी दूरी की जानकारी भी शामिल होती है. इसके अलावा, जगहों की सूची और जगह से उनके जुड़ाव की जानकारी भी शामिल होती है:
{ "places": [ { "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "addressDescriptor": { "landmarks": [ { "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": 114.76984, "travelDistanceMeters": 114.261856 }, { "name": "places/ChIJgexMlR_Lj4ARiKCKuhNnjn0", "placeId": "ChIJgexMlR_Lj4ARiKCKuhNnjn0", "displayName": { "text": "Valley Fair Mall Eyexam of CA", "languageCode": "en" }, "types": [ "establishment", "health", "point_of_interest" ], "straightLineDistanceMeters": 131.62566, "travelDistanceMeters": 237.33253 }, { "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "displayName": { "text": "Din Tai Fung", "languageCode": "en" }, "types": [ "establishment", "food", "point_of_interest", "restaurant" ], "straightLineDistanceMeters": 110.0775, "travelDistanceMeters": 171.41951 }, { "name": "places/ChIJwyfPQx7Lj4AR7bYI2A2Yc54", "placeId": "ChIJwyfPQx7Lj4AR7bYI2A2Yc54", "displayName": { "text": "Abercrombie & Fitch", "languageCode": "en" }, "types": [ "clothing_store", "establishment", "point_of_interest", "shoe_store", "store" ], "spatialRelationship": "DOWN_THE_ROAD", "straightLineDistanceMeters": 53.620117, "travelDistanceMeters": 2.4578214 }, { "name": "places/ChIJpycNQx7Lj4ARjhXw3PrM_kU", "placeId": "ChIJpycNQx7Lj4ARjhXw3PrM_kU", "displayName": { "text": "Hollister Co.", "languageCode": "en" }, "types": [ "clothing_store", "establishment", "point_of_interest", "shoe_store", "store" ], "spatialRelationship": "DOWN_THE_ROAD", "straightLineDistanceMeters": 56.53726, "travelDistanceMeters": 15.418246 } ], "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": "OUTSKIRTS" } ] } }, /.../ }
आने वाले समय में खुलने वाले कारोबारों को ढूंढना
यहां न्यू मीडोज़, इडाहो में आने वाले समय में खुलने वाले कारोबारों के लिए, आस-पास की जगहों की जानकारी (नई) के अनुरोध का उदाहरण दिया गया है:
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.businessStatus,places.openingDate" \
-d '{
"includeFutureOpeningBusinesses": true,
"maxResultCount": 20,
"locationRestriction": {
"circle": {
"center": {"latitude": 44.9755100, "longitude": -116.2842180},
"radius": 20
}
},
"rankPreference": "DISTANCE"
}' \
"https://places.googleapis.com/v1/places:searchNearby"
जवाब में, ऐसे कारोबारों की जानकारी शामिल होती है जो आने वाले समय में खुलेंगे. साथ ही, इसमें कारोबार की स्थिति और खुलने की अनुमानित तारीख भी शामिल होती है:
{ "places": [ { "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do", "businessStatus": "FUTURE_OPENING", "displayName": { "text": "Roberts Greenhouse and Tree Farm", "languageCode": "en" }, "openingDate": { "year": 2026, "month": 4, "day": 15 } } ] }
बस, मेट्रो वगैरह के स्टेशन की जानकारी पाना
किसी जगह के आस-पास मौजूद बस, मेट्रो वगैरह के स्टेशनों के बारे में जानकारी पाने के लिए, आस-पास की जगहों की जानकारी (नया) सुविधा का इस्तेमाल किया जा सकता है. जवाब के मुख्य हिस्से में स्टेशन के बारे में जानकारी शामिल होती है. जैसे, स्टेशन का नाम, उससे जुड़ी सार्वजनिक परिवहन एजेंसियां, और स्टेशन पर चलने वाली बस, मेट्रो वगैरह की लाइनें. इसके अलावा, जवाब में वाहन का आइकॉन और रंग शामिल होते हैं. इनका इस्तेमाल करके, बस, मेट्रो वगैरह के स्टेशन की जानकारी दिखाई जा सकती है.
यहां मिडटाउन मैनहैटन से 50 मीटर के दायरे में मौजूद ट्रांज़िट स्टेशन के लिए किए गए अनुरोध का उदाहरण दिया गया है:
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.transitStation" \
-d '{
"includedTypes": ["transit_station"],
"locationRestriction": {
"circle": {
"center": {"latitude": 40.754851, "longitude": -73.984164},
"radius": 50.0
}
}
}' \
"https://places.googleapis.com/v1/places:searchNearby"
जवाब के मुख्य हिस्से में, दायरे में मौजूद हर स्टेशन के बारे में जानकारी शामिल होती है. जैसे, स्टेशन से चलने वाली लाइनें, उस स्टॉप पर परिवहन एजेंसियों की ओर से जारी की गई सूचनाएं, और रवाना होने की जानकारी:
{ "places": [ { "id": "ChIJH2EstKpZwokRCwZtYyMd5Fg", "displayName": { "text": "6 Av/W 41 St", "languageCode": "en" }, "transitStation": { "displayName": { "text": "6 Av/W 41 St", "languageCode": "en" }, "agencies": [ { "displayName": { "text": "ShortLine Hudson", "languageCode": "en" }, "url": "https://www.coachusa.com/", "lines": [ { "id": "ChIJSQlbzvPwwokRolrIA-Kuh6o", "vehicleType": "BUS", "displayName": { "text": "200 - Northern District – Nanuet", "languageCode": "en" }, "shortDisplayName": { "text": "ShortLine Hudson", "languageCode": "en" }, "textColor": "#000000", "backgroundColor": "#ED60A3", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg" } } ] }, { "displayName": { "text": "MTA New York City Transit", "languageCode": "en" }, "url": "http://www.mta.info/", "lines": [ { "id": "ChIJjUrj7PBewokR3O3S2JVpBrI", "vehicleType": "SUBWAY", "displayName": { "text": "E Train (8 Av Local)", "languageCode": "en" }, "shortDisplayName": { "text": "E Line", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#0039A6", "url": "https://www.mta.info/schedules/subway/e-train", "icon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/E.svg", "nameIncluded": true }, "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg" } }, ... ] }, "stops": [ { "id": "ChIJvRnquapZwokRdUOyVwNGbe8", "displayName": { "text": "6 Av/W 41 St", "languageCode": "en" }, "location": { "latitude": 40.754509, "longitude": -73.984216500000016 }, "wheelchairAccessibleEntrance": true } ], "departureBoards": [ { "displayType": "DIRECTION_CENTRIC", "rows": [ { "departures": [ { "timedDeparture": { "scheduledTime": "2026-05-15T22:29:51Z", "timingType": "SCHEDULED" }, "originallyScheduledStopId": "ChIJvRnquapZwokRdUOyVwNGbe8", "lineId": "ChIJA1aFyaZfwokRkO5869M6UXk" } ] }, { "departures": [ { "timedDeparture": { "scheduledTime": "2026-05-15T22:33:55Z", "timingType": "SCHEDULED" }, "originallyScheduledStopId": "ChIJvRnquapZwokRdUOyVwNGbe8", "lineId": "ChIJj3iCEwJfwokRZE2Qtnm4pPI" } ] }, ... ] } ] } }, ... { { "id": "ChIJPyq6TZBZwokRdGoiJ5Iq_hE", "vehicleType": "BUS", "displayName": { "text": "W 44 St - South Ferry", "languageCode": "en" }, "shortDisplayName": { "text": "M55", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#1D59B3", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg" }, "alerts": [ { "effect": "OTHER", "texts": [ { "headline": { "text": "Information", "languageCode": "en" }, "summary": { "text": "Northbound M20 and M55 stop on State St at Bridge St is closed; use the temporary stop on State St before the intersection instead", "languageCode": "en" }, "fullDescription": { "text": "See a map of the new stop location. What's happening? Construction", "languageCode": "en" } } ], "detailsUrls": [ { "url": "https://www.mta.info/" } ], "cause": "OTHER_CAUSE", "startTime": "2025-04-02T04:00:00Z", "endTime": "2026-06-15T00:00:00Z", "attribution": { "link": { "text": "www.mta.info", "url": "https://www.mta.info/" } }, "createTime": "2026-05-15T22:32:00Z", "severityLevel": "INFO" } ] }, ... } ... }
रास्ते और नेविगेशन पॉइंट पाना
किसी जगह के लिए, प्रवेश द्वार और नेविगेशन पॉइंट का अनुरोध किया जा सकता है. दरवाज़े, किसी जगह में आने और जाने के पॉइंट तय करते हैं. उदाहरण के लिए, किसी हवाई अड्डे या मॉल के अलग-अलग गेट. नेविगेशन पॉइंट, सड़क के किनारे मौजूद ऐसी जगहों के बारे में बताते हैं जहां नेविगेशन खत्म होना चाहिए. इससे लोगों को सड़क की सही साइड या किसी खास ड्रॉप-ऑफ़ पॉइंट पर ले जाने में मदद मिलती है.
नेविगेशन पॉइंट, navigationPointToken दिखाता है. इस टोकन को Navigation SDK (Android या iOS के लिए उपलब्ध है) या Routes API को पास किया जा सकता है, ताकि ड्राइवर को उस खास जगह पर पहुंचने का रास्ता दिखाया जा सके. ज़्यादा जानकारी के लिए, नेविगेशन पॉइंट टोकन देखें.
यहां आस-पास की जगहों की जानकारी (नया) के अनुरोध का उदाहरण दिया गया है. इसमें फ़ील्ड मास्क में entrances और navigationPoints शामिल हैं:
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.entrances,places.navigationPoints" \
-d '{
"includedTypes": ["airport"],
"maxResultCount": 1,
"locationRestriction": {
"circle": {
"center": {"latitude": 37.6193, "longitude": -122.3816},
"radius": 1000.0
}
}
}' \
"https://places.googleapis.com/v1/places:searchNearby"
जवाब में, जगह के एंट्री पॉइंट और नेविगेशन पॉइंट शामिल हैं:
{ "places": [ { "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ", "displayName": { "text": "San Francisco International Airport", "languageCode": "en" }, "entrances": [ { "location": { "latitude": 37.6172154, "longitude": -122.3839724 } }, { "location": { "latitude": 37.6174073, "longitude": -122.384196 } }, ... ], "navigationPoints": [ { "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...", "displayName": { "text": "International Terminal Departures Level", "languageCode": "en" }, "location": { "latitude": 37.6153121, "longitude": -122.3900833 }, "travelModes": ["WALK"] }, { "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...", "displayName": { "text": "Domestic Garage - SFO Short Term Parking", "languageCode": "en" }, "location": { "latitude": 37.6157153, "longitude": -122.3885012 }, "travelModes": ["DRIVE", "WALK"], "usages": ["PARKING"] }, ... ] } ] }
इसे आज़माएं!
APIs Explorer की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.
पेज की दाईं ओर मौजूद, एपीआई आइकॉन api को चुनें.
अनुरोध के पैरामीटर में बदलाव करें. यह ज़रूरी नहीं है.
लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिससे आपको अनुरोध करना है.
APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें. इससे APIs Explorer विंडो बड़ी हो जाएगी.