Nearby Search पर माइग्रेट करना (नया)

Places API, मौजूदा आस-पास खोज. अगर आप मौजूदा Nearby Search के बारे में जानते हैं, तो आस-पास खोज की सुविधा का नया वर्शन ये बदलाव करता है:

• आस-पास की नई खोज के लिए, एचटीटीपी पोस्ट अनुरोधों का इस्तेमाल किया जाता है. एचटीटीपी पोस्ट के हिस्से के तौर पर, अनुरोध के मुख्य हिस्से या हेडर में पैरामीटर पास करें अनुरोध. इसके उलट, मौजूदा Nearby Search में, तो आप एचटीटीपी जीईटी अनुरोध का इस्तेमाल करके यूआरएल पैरामीटर पास करते हैं.
• फ़ील्ड मास्क करना ज़रूरी है. आपको यह बताना होगा कि कौनसे फ़ील्ड लौटाए जाने हैं डालें. लौटाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं है. अगर आप छोड़ देते हैं इस सूची में, इन तरीकों से गड़बड़ी दिखती है. ज़्यादा जानकारी के लिए, यह देखें FieldMask.
• नई आस-पास खोज सुविधा, दोनों का इस्तेमाल करती है एपीआई पासकोड और OAuth टोकन का इस्तेमाल किया जा सकता है.
• नए वर्शन में, रिस्पॉन्स फ़ॉर्मैट के तौर पर सिर्फ़ JSON काम करता है आस-पास खोजने की सुविधा.
• टेक्स्ट क्वेरी वाले सभी अनुरोधों को अब टेक्स्ट खोज (नई सुविधा) क्योंकि Nearby Search (नया) में टेक्स्ट इनपुट काम नहीं करता.
• Nearby Search के लिए JSON रिस्पॉन्स फ़ॉर्मैट (नया) एपीआई को मौजूदा एपीआई के फ़ॉर्मैट से बदल दिया गया है. ज़्यादा जानकारी के लिए, यह देखें जगहें एपीआई से मिले रिस्पॉन्स को माइग्रेट करें.

नीचे दी गई टेबल में पैरामीटर की मौजूदा सूची आस-पास की खोज, जिसका नाम बदला गया है या जिसके आस-पास की नई खोज या ऐसे पैरामीटर जो अब मौजूद नहीं हैं समर्थित हैं.

मौजूदा पैरामीटर	नया पैरामीटर	नोट
keyword		समर्थित नहीं. इस्तेमाल की जाने वाली चीज़ें टेक्स्ट खोज (नई सुविधा) आज़माएं.
language	languageCode
location	locationRestriction	ज़रूरी है.
maxprice/minprice		समर्थित नहीं.
	maxResultCount	नया पैरामीटर.
opennow		समर्थित नहीं.
pagetoken		समर्थित नहीं.
radius		locationRestriction का अभी इस्तेमाल करें.
rankby	rankPreference
	regionCode	नया पैरामीटर.
type	includedTypes excludedTypes includedPrimaryTypes excludedPrimaryTypes	नए पैरामीटर में कई टाइप की वैल्यू भी स्वीकार की जाती हैं. मौजूदा एपीआई सिर्फ़ एक वैल्यू स्वीकार करता है.

अनुरोध का उदाहरण

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

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'

आस-पास खोज (नया) की मदद से, आप एक पोस्ट अनुरोध करते है और सभी पैरामीटर को JSON अनुरोध के मुख्य हिस्से या हेडर में पीओएसटी के तौर पर पास करें अनुरोध. इस उदाहरण में फ़ील्ड मास्क का भी इस्तेमाल किया गया है, इसलिए जवाब में सिर्फ़ जगह का डिसप्ले नेम और फ़ॉर्मैट किया गया पता:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "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" \
https://places.googleapis.com/v1/places:searchNearby