Places API (लेगसी) के जवाब को माइग्रेट करना

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

परिचय

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

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

रिस्पॉन्स प्लेस ऑब्जेक्ट में बदलाव

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

आस-पास की जगहों की जानकारी देने वाली सेवा के रिस्पॉन्स में बदलाव

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

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

Place Details (New) के जवाब में हुए बदलाव

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

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