पते की पुष्टि करने वाले एपीआई का इस्तेमाल करते समय, यह अनुरोध किया जा सकता है कि पुष्टि करने वाला रिस्पॉन्स, अंग्रेज़ी में बदला गया पता भी दिखाए. इस सुविधा का इस्तेमाल तब करें, जब आपके सिस्टम को अंग्रेज़ी-आधारित लैटिन वर्णों में पते की जानकारी देने की ज़रूरत हो. ऐसा तब करें, जब आपको ऐसा पता मिल रहा हो जो अंग्रेज़ी के अलावा किसी दूसरी भाषा में हो. उदाहरण के लिए:
- ऐसा हो सकता है कि आपकी कंपनी दुनिया भर से आने वाले शिपिंग के अनुरोधों को पूरा करे. साथ ही, सभी पतों का स्टैंडर्ड तय करने के लिए, अंग्रेज़ी और अंग्रेज़ी पर आधारित लैटिन वर्णों का इस्तेमाल करे.
- आपका कारोबार किसी ऐसे देश से आने-जाने के लिए, शिपमेंट हैंडल कर सकता है जिसकी भाषा, दिए गए पते की भाषा से अलग हो.
पते को अंग्रेज़ी में कैसे वापस करें
अंग्रेज़ी के बराबर कॉम्पोनेंट शामिल करके पते की पुष्टि का अनुरोध करने के लिए, पुष्टि के अनुरोध के मुख्य हिस्से में यह जानकारी जोड़ें:
languageOptions: { returnEnglishLatinAddress: "true" }.
नीचे दिए गए उदाहरण में, प्राडो म्यूज़ियम के पते की पुष्टि करते समय अंग्रेज़ी वाले कॉम्पोनेंट का अनुरोध किया गया है:
curl -X POST -d '{ "regionCode" : ["ES"], "addressLines": ["C. de Ruiz de Alarcón, 23, 28014 Madrid, Spain"], "languageOptions": {returnEnglishLatinAddress: true} }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: API_KEY' \ 'https://addressvalidation.googleapis.com/v1:validateAddress'
रिस्पॉन्स, englishLatinAddress
फ़ील्ड में अंग्रेज़ी पता दिखाता है. ज़्यादा जानकारी के लिए, यहां पते के कन्वर्ज़न का उदाहरण देखें. स्थानीय भाषा के दिए गए पते के हर कॉम्पोनेंट को बेहतर तरीके से अंग्रेज़ी में बदला जाता है. बदला गया पता, एपीआई के इनपुट के तौर पर फिर से इस्तेमाल नहीं किया जा सकता.
englishLatinAddress
फ़ील्ड में उसी पते प्रोटोकॉल का इस्तेमाल किया जाता है जिसका इस्तेमाल address
फ़ील्ड में किया जाता है. हालांकि, इसमें ये अपवाद शामिल हैं:
- कोई
ConfirmationLevel
फ़ील्ड नहीं है unconfirmedComponentTypes
फ़ील्ड मौजूद नहीं है
पता रूपांतरण कैसे काम करता है
पते की पुष्टि करने वाला एपीआई, पते के हर कॉम्पोनेंट पर अंग्रेज़ी कन्वर्ज़न लागू करता है. इसका मतलब है कि administrative_area
, locality
, और पते के अन्य कॉम्पोनेंट को अलग-अलग माना जाता है. पते के कॉम्पोनेंट की सूची के लिए, रेफ़रंस दस्तावेज़ में AddressComponent देखें.
नीचे दिया गया डायग्राम दिखाता है कि Calle Dueñas, 5, 41003 Sevilla, España पते के लिए अंग्रेज़ी कन्वर्ज़न कैसा दिखेगा.
अंग्रेज़ी कन्वर्ज़न के लिए आकलन किए गए हर कॉम्पोनेंट के लिए, यह सेवा इन सेक्शन में बताई गई प्रोसेस का इस्तेमाल करती है.
जहां मुमकिन हो वहां पूरी तरह से अनुवाद की गई अंग्रेज़ी का इस्तेमाल किया गया हो
ऐसा हो सकता है कि पते के कुछ कॉम्पोनेंट का पूरी तरह से अनुवाद किया गया वर्शन इस्तेमाल के लिए उपलब्ध हो.
उदाहरण के लिए, स्पैनिश देश España
का अनुवाद Spain
में होगा. ऐसे में, सेवा के अंग्रेज़ी वर्शन का इस्तेमाल किया जाता है. आम तौर पर, ऐसा country
और administrative_area_level_1
जैसे बड़े पते के कॉम्पोनेंट के लिए होता है.
अंग्रेज़ी उपलब्ध न होने पर स्थानीय भाषा के अनुवाद का इस्तेमाल किया जाता है
लैटिनाइज़ेशन का मतलब है कि ट्रांसक्रिप्शन का इस्तेमाल करके स्थानीय भाषा को लैटिन स्क्रिप्ट में बदल दिया जाता है.
- अगर पते की स्थानीय भाषा में लैटिन वर्ण सेट का इस्तेमाल होता है और पता कॉम्पोनेंट के लिए अंग्रेज़ी के बराबर मौजूद नहीं है, तो यह सेवा उन वर्णों को बदल देती है जो अंग्रेज़ी के नहीं हैं.
उदाहरण के लिए,
Calle Dueñas
का मानCalle Duenas
हो जाता है. यहां ñ की जगह n का इस्तेमाल किया जाता है. - अगर पते की स्थानीय भाषा में लैटिन-आधारित
वर्ण सेट का इस्तेमाल नहीं किया गया है और पता कॉम्पोनेंट के लिए अंग्रेज़ी का कोई मिलता-जुलता वर्शन मौजूद नहीं है,
तो स्थानीय भाषा के उपलब्ध होने पर, सेवा का लैटिन वर्शन इस्तेमाल करता है.
उदाहरण के लिए, एक जापानी रूपांतरण दिखाता है कि जापानी का रोमनीकरण किया गया है.
अंग्रेज़ी और लैटिन के अलावा दूसरे सभी वर्णों को अंग्रेज़ी वाले लैटिन वर्णों से बदल दिया जाता है. उदाहरण के लिए: 3丁目, 3-होम बन जाता है.
- ध्यान दें कि फ़िलहाल जैपनीज़ में वीडियो की झलक देखने की सुविधा चालू नहीं है
- अगर भाषा का लैटिन वर्शन उपलब्ध नहीं है, तो कॉम्पोनेंट स्थानीय भाषा में दिखाए जाते हैं.
अंग्रेज़ी में नहीं, बल्कि लैटिन वर्णों के विकल्प का इस्तेमाल करता है
जो लैटिन वर्ण अंग्रेज़ी में नहीं हैं उन्हें अंग्रेज़ी वाले वर्णों से बदल दिया जाता है. उदाहरण के लिए, नीचे दिए गए हर वर्ण की जगह "o" कैरेक्टर की जगह ले ली जाएगी: बनें, ò, ó, É, TOPIC, ö, ø, ö, ñ, ö, ò, ṍ, ṏ, ṑ, ṓ, किसी उदाहरण के लिए:
कैले दे रुइज़ दे आलार्कन को बदलकर कैले दे रुइज़ दे अलारकॉन कर दिया गया
पते में बदलाव का उदाहरण
यहां दिए गए उदाहरण में, स्पेन के Paacio de las Dueñas के अनुरोध की पुष्टि का जवाब दिखाया गया है. इस जवाब में, englishLatinAddress
को बोल्ड किया गया है. इस अनुरोध ने इनपुट के languageOptions
पैरामीटर में, returnEnglishLatinAddress
फ़ील्ड का इस्तेमाल किया है.
"result": { "verdict": { "inputGranularity": "PREMISE", "validationGranularity": "PREMISE", "geocodeGranularity": "PREMISE", "addressComplete": true, "hasInferredComponents": true }, "address": { "formattedAddress": "Calle Dueñas, 5, 41003 Sevilla, España", "postalAddress": { "regionCode": "ES", "languageCode": "es", "postalCode": "41003", "administrativeArea": "Sevilla", "locality": "Sevilla", "addressLines": [ "C. Dueñas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Dueñas", "languageCode": "es" }, "componentType": "route", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "41003" }, "componentType": "postal_code", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "locality", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "España", "languageCode": "es" }, "componentType": "country", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "administrative_area_level_2", "confirmationLevel": "CONFIRMED", "inferred": true } ] }, "geocode": { "location": { "latitude": 37.394849, "longitude": -5.9893604 }, "plusCode": { "globalCode": "8C9P92V6+W7" }, "bounds": { "low": { "latitude": 37.3948098, "longitude": -5.9894249 }, "high": { "latitude": 37.3948882, "longitude": -5.9893025 } }, "featureSizeMeters": 7.174035, "placeId": "ChIJzRDYbgRsEg0RDDgHlF80UoI", "placeTypes": [ "premise" ] }, "metadata": { "business": true, "residential": false }, "englishLatinAddress": { "formattedAddress": "Calle Duenas, 5, 41003 Seville, Spain", "postalAddress": { "regionCode": "ES", "languageCode": "en", "postalCode": "41003", "administrativeArea": "Seville", "locality": "Seville", "addressLines": [ "C. Duenas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Duenas", "languageCode": "es" }, "componentType": "route", }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", }, { "componentName": { "text": "41003" }, "componentType": "postal_code", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "locality", }, { "componentName": { "text": "Spain", "languageCode": "en" }, "componentType": "country", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "administrative_area_level_2", "inferred": true } ] } }, "responseId": "e874d263-7d0d-413f-9213-119a784765ed"
प्रीव्यू रिलीज़ से जुड़े सहायता विकल्प
Google, 'सेवाओं' के झलक वर्शन, सुविधाओं या उनके काम करने के तरीके के लिए सहायता नहीं देता. हालांकि, हम डेवलपमेंट के इन चरणों में अलग-अलग मामलों के हिसाब से अनुरोधों पर विचार करते हैं.
Pre-GA वर्शन के लिए इन सुझावों का इस्तेमाल करें:
Pre-GA सुविधाओं को Google Maps Platform एसएलए में शामिल नहीं किया जाता है.
फ़ॉलबैक प्रोसेस का इस्तेमाल करें. खास तौर पर, जब प्री-GA सुविधा को प्रोडक्शन एनवायरमेंट में इस्तेमाल किया जा रहा हो. फ़ॉलबैक की स्थितियों के कुछ उदाहरण ये हैं: कोटा पार होना, अनचाहे रिस्पॉन्स कोड, और इंतज़ार का समय या मौजूदा व्यवहार की तुलना में अनचाहे जवाब.
समस्या को ट्रैक करने वाले टूल का इस्तेमाल करके, नई सुविधाओं का अनुरोध किया जा सकता है या मौजूदा सुविधाओं में बदलाव के सुझाव दिए जा सकते हैं. अपने अनुरोध में यह जानकारी ज़रूर शामिल करें:
उस खास सुविधा या व्यवहार के बारे में बताएं जिसे आपको शामिल किया जाना है. साथ ही, उन वजहों के बारे में बताएं जिनकी वजह से आपको यह ज़रूरी लगता है.
अगर हो सके, तो अपने इस्तेमाल के उदाहरण और इस सुविधा से मिलने वाले नए अवसरों के बारे में खास जानकारी शामिल करें.
इस फ़ीडबैक या सुविधाओं के बारे में किसी दूसरे सवाल के लिए, पते की पुष्टि करने के लिए हॉटलाइन: address-validation-hotline@google.com पर ईमेल भेजें.