Places API के रिस्पॉन्स को माइग्रेट करें

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

जगह की जानकारी (नया), आस-पास खोजें (नया), और टेक्स्ट से खोजें (नया) एपीआई के लिए, रिस्पॉन्स का फ़ॉर्मैट लेगसी एपीआई के फ़ॉर्मैट से बदल गया है. मुख्य अंतर, हर तरीके से मिले Place ऑब्जेक्ट के फ़ॉर्मैट में होता है. इसके बारे में जवाब के प्लेस ऑब्जेक्ट में हुए बदलाव में बताया गया है.

इसके अलावा, हर एपीआई के लिए रिस्पॉन्स ऑब्जेक्ट के टॉप लेवल फ़ील्ड भी बदल गए हैं. देखें:

जवाब के Place ऑब्जेक्ट में बदलाव

इस टेबल में, Place Details (नया), Nearby Search (नया), और Text Search (नया) के जवाब में मौजूद नए Place ऑब्जेक्ट में हुए बदलावों को दिखाया गया है. इनकी तुलना लेगसी Place ऑब्जेक्ट से की गई है.

नए रिस्पॉन्स ऑब्जेक्ट में, फ़ील्ड के नामों के लिए कैमल-केसिंग का इस्तेमाल किया जाता है. इसमें नए फ़ील्ड शामिल होते हैं और कुछ लेगसी फ़ील्ड के नाम बदले जाते हैं.

फ़ील्ड Places API (लेगसी) ऑब्जेक्ट Places API (नया प्रॉडक्ट) ऑब्जेक्ट नोट
पते का कॉम्पोनेंट address_components addressComponents
जगह का पता बताने वाला माइक्रोफ़ॉर्मैट adr_address adrFormatAddress
कारोबार की स्थिति business_status businessStatus
अगले हफ़्ते के लिए खुलने का समय current_opening_hours currentOpeningHours
एडिटोरियल की खास जानकारी editorial_summary editorialSummary
फ़ॉर्मैट किया गया पता formatted_address formattedAddress
नैशनल फ़ोन नंबर formatted_phone_number nationalPhoneNumber
जगह geometry.location location
व्यूपोर्ट geometry.viewport viewport
जगह के एट्रिब्यूशन html_attributions attributions लेगसी एपीआई में जवाब का टॉप-लेवल फ़ील्ड
आइकन URL icon हटाया गया. इसके लिए iconMaskBaseUri और iconBackgroundColor इस्तेमाल करें. ज़्यादा जानकारी के लिए, जगह के आइकॉन देखें.
आइकन पृष्ठभूमि का रंग icon_background_color iconBackgroundColor
आइकॉन मास्क का यूआरएल icon_mask_base_uri iconMaskBaseUri
अंतरराष्ट्रीय फ़ोन नंबर international_phone_number internationalPhoneNumber
जगह का नाम name displayName जगह के नाम को अब displayName.text के तौर पर ऐक्सेस किया जा सकता है. साथ ही, language को displayName.languageCode के तौर पर ऐक्सेस किया जा सकता है
खुलने का समय opening_hours regularOpeningHours
फ़ोटो photos photos नए Place ऑब्जेक्ट में, photos का फ़ॉर्मैट बदल गया है. ज़्यादा जानकारी के लिए, फ़ोटो के रेफ़रंस में बदलाव करना लेख पढ़ें.
जगह का आईडी place_id id
प्लस कोड plus_code plusCode
कीमत स्तर price_level priceLevel
रेटिंग rating rating
समीक्षाएं reviews reviews
आज से अगले हफ़्ते के लिए, दूसरी बार खुलने का समय. इसमें अपवाद और अन्य सभी डेटा शामिल है secondary_opening_hours currentSecondaryOpeningHours
जगह के टाइप types types
जगह का Google Maps यूआरएल url googleMapsUri
उपयोगकर्ता रेटिंग की संख्या user_ratings_total userRatingCount
यूटीसी ऑफ़सेट utc_offset utcOffsetMinutes
पते का छोटा रूप, जिसमें सड़क का नाम और शहर शामिल हो vicinity shortFormattedAddress
चुनी गई जगह की वेबसाइट website websiteUri
व्हीलचेयर ले जाने की सुविधा के बारे में जानकारी wheelchair_accessible_entrance accessibilityOptions wheelchair_accessible_entrance अब accessibilityOptions.wheelchairAccessibleEntrance पर है
जगहों की विशेषताएं takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood
संसाधन का नाम name फ़ील्ड में places/PLACE_ID लेगसी एपीआई में, name फ़ील्ड में जगह का नाम टेक्स्ट स्ट्रिंग के तौर पर मौजूद होता था. नए एपीआई में, यह जानकारी displayName में मौजूद होती है.
जगह का मुख्य टाइप primaryTypeName नई सुविधा
प्राइमरी टाइप को टेक्स्ट स्ट्रिंग के तौर पर रखें primaryTypeDisplayName नई सुविधा
हर हफ़्ते के लिए, कारोबार के खुलने का दूसरा समय. इसमें अपवाद और अन्य सभी डेटा शामिल होता है regularSecondaryOpeningHours नई सुविधा
जगह पर पेमेंट के लिए उपलब्ध विकल्प paymentOptions नई सुविधा
पार्किंग की जगह के विकल्प parkingOptions नई सुविधा
जगह से जुड़े सब-डेस्टिनेशन की सूची subDestinations नई सुविधा
किसी पेट्रोल पंप पर उपलब्ध ईंधन के विकल्पों के बारे में सबसे नई जानकारी fuelOptions नई सुविधा
किसी जगह के लिए ईवी चार्जिंग की जानकारी evChargeOptions नई सुविधा
जगहों की विशेषताएं outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports नई सुविधा

टेक्स्ट से खोज करने की सुविधा के जवाबों में हुए बदलाव

नीचे दी गई टेबल में, टेक्स्ट सर्च (लेगसी) के लिए जवाब ऑब्जेक्ट और टेक्स्ट सर्च (नया) के लिए जवाब ऑब्जेक्ट के टॉप-लेवल फ़ील्ड में हुए बदलावों को दिखाया गया है. नए एपीआई के लिए, रिस्पॉन्स में सिर्फ़ टॉप-लेवल फ़ील्ड places ऐरे होता है.

फ़ील्ड टेक्स्ट सर्च (लेगसी) टेक्स्ट सर्च (नई सुविधा) नोट
जगह के एट्रिब्यूशन html_attributions हर जगह के लिए, जगह ऑब्जेक्ट में place.attributions के तौर पर ले जाया गया
जगहों का कलेक्शन लेगसी Place ऑब्जेक्ट का results कलेक्शन places नए Place ऑब्जेक्ट का कलेक्शन
अनुरोध की स्थिति status स्टैंडर्ड एचटीटीपी रिस्पॉन्स (एचटीटीपी रिस्पॉन्स कोड और मैसेज) पर ले जाया गया
गड़बड़ी के मैसेज error_message स्टैंडर्ड एचटीटीपी रिस्पॉन्स (एचटीटीपी रिस्पॉन्स कोड और मैसेज) पर ले जाया गया
कोई भी जानकारी देने वाला मैसेज info_messages हटाया गया
पेज टोकन next_page_token हटाया गया

आस-पास की जगहों की जानकारी खोजने के लिए किए गए अनुरोध के जवाब में बदलाव

नीचे दी गई टेबल में, आस-पास की जगहों के लिए खोज (लेगसी) के response object और आस-पास की जगहों के लिए खोज (नया) के response object के टॉप-लेवल फ़ील्ड में हुए बदलावों को दिखाया गया है. नए एपीआई के लिए, रिस्पॉन्स में सिर्फ़ टॉप-लेवल फ़ील्ड places ऐरे होता है.

फ़ील्ड आस-पास की जगहों की जानकारी (लेगसी) आस-पास की जगहों की जानकारी (नई) नोट
जगह के एट्रिब्यूशन html_attributions हर जगह के लिए, Place ऑब्जेक्ट में ले जाया गया है. इसे place.attributions के तौर पर दिखाया गया है
जगहों का कलेक्शन लेगसी Place ऑब्जेक्ट का results कलेक्शन places नए Place ऑब्जेक्ट का कलेक्शन
अनुरोध की स्थिति status स्टैंडर्ड एचटीटीपी रिस्पॉन्स (एचटीटीपी रिस्पॉन्स कोड और मैसेज) पर ले जाया गया
गड़बड़ी के मैसेज error_message स्टैंडर्ड एचटीटीपी रिस्पॉन्स (एचटीटीपी रिस्पॉन्स कोड और मैसेज) पर ले जाया गया
कोई भी जानकारी देने वाला मैसेज info_messages हटाया गया
पेज टोकन next_page_token हटाया गया

जगह की जानकारी (नई) के जवाब में हुए बदलाव

नीचे दी गई टेबल में, जगह की जानकारी (लेगसी) के लिए response object और जगह की जानकारी (नया) के लिए response object के टॉप-लेवल फ़ील्ड में हुए बदलावों को दिखाया गया है. नए एपीआई के लिए, रिस्पॉन्स में सिर्फ़ टॉप-लेवल फ़ील्ड places ऐरे होता है.

फ़ील्ड जगह के बारे में ज़्यादा जानकारी (लेगसी) जगह के बारे में ज़्यादा जानकारी (नया) नोट
जगह के एट्रिब्यूशन html_attributions attributions के तौर पर, नए Place ऑब्जेक्ट में ले जाया गया
जगह के बारे में ज़्यादा जानकारी (नया) result में लेगसी Place ऑब्जेक्ट शामिल है नया Place ऑब्जेक्ट
अनुरोध की स्थिति status स्टैंडर्ड एचटीटीपी रिस्पॉन्स (एचटीटीपी रिस्पॉन्स कोड और मैसेज) पर ले जाया गया
कोई भी जानकारी देने वाला मैसेज info_messages स्टैंडर्ड एचटीटीपी रिस्पॉन्स (एचटीटीपी रिस्पॉन्स कोड और मैसेज) पर ले जाया गया