- HTTP অনুরোধ
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- ডাক ঠিকানা
- ভাষার বিকল্প
- যাচাইকরণের ফলাফল
- রায়
- গ্রানুলারিটি
- ঠিকানা
- ঠিকানা উপাদান
- উপাদানের নাম
- নিশ্চিতকরণ স্তর
- জিওকোড
- LatLng
- প্লাসকোড
- ভিউপোর্ট
- ঠিকানা মেটাডেটা
- ইউএসপিএস ডেটা
- ইউএসপিএস ঠিকানা
একটি ঠিকানা যাচাই করে।
HTTP অনুরোধ
POST https://addressvalidation.googleapis.com/v1:validateAddress
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{ "address": { object ( |
ক্ষেত্র | |
---|---|
address | প্রয়োজন। ঠিকানা যাচাই করা হচ্ছে। বিন্যাসহীন ঠিকানা এই ইনপুটে ক্ষেত্রগুলির মোট দৈর্ঘ্য 280 অক্ষরের বেশি হওয়া উচিত নয়৷ সমর্থিত অঞ্চলগুলি এখানে পাওয়া যাবে। ইনপুট ঠিকানায় ঠিকানা যাচাইকরণ API |
previousResponseId | প্রথম ঠিকানা যাচাইকরণের অনুরোধের জন্য এই ক্ষেত্রটি অবশ্যই খালি থাকতে হবে। যদি একটি একক ঠিকানাকে সম্পূর্ণরূপে বৈধ করার জন্য আরও অনুরোধের প্রয়োজন হয় (উদাহরণস্বরূপ যদি ব্যবহারকারীর প্রাথমিক যাচাইকরণের পরে যে পরিবর্তনগুলি করা হয় তা পুনরায় যাচাই করা প্রয়োজন), তাহলে প্রতিটি ফলোআপ অনুরোধকে অবশ্যই প্রথম প্রতিক্রিয়া থেকে |
enableUspsCass | USPS CASS সামঞ্জস্যপূর্ণ মোড সক্ষম করে৷ এটি শুধুমাত্র এটি একটি কম্পোনেন্টাইজড |
languageOptions | ঐচ্ছিক। পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন। প্রতিক্রিয়াতে অতিরিক্ত তথ্য অন্তর্ভুক্ত করতে ঠিকানা যাচাইকরণ API সক্ষম করে৷ |
sessionToken | ঐচ্ছিক। একটি স্ট্রিং যা বিলিং উদ্দেশ্যে একটি স্বয়ংসম্পূর্ণ সেশন সনাক্ত করে৷ সর্বাধিক 36টি ASCII অক্ষর সহ একটি URL এবং ফাইলের নাম নিরাপদ base64 স্ট্রিং হতে হবে৷ অন্যথায় একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হবে৷ সেশন শুরু হয় যখন ব্যবহারকারী একটি স্বয়ংসম্পূর্ণ ক্যোয়ারী করে, এবং শেষ হয় যখন তারা একটি স্থান নির্বাচন করে এবং স্থানের বিবরণ বা ঠিকানা যাচাইকরণে কল করা হয়। প্রতিটি সেশনে একাধিক স্বয়ংসম্পূর্ণ প্রশ্ন থাকতে পারে, তার পরে একটি স্থানের বিবরণ বা ঠিকানা যাচাইকরণের অনুরোধ থাকতে পারে। একটি সেশনের মধ্যে প্রতিটি অনুরোধের জন্য ব্যবহৃত শংসাপত্রগুলি অবশ্যই একই Google Cloud Console প্রকল্পের অন্তর্গত। একবার একটি অধিবেশন শেষ হয়ে গেলে, টোকেনটি আর বৈধ থাকে না; আপনার অ্যাপকে অবশ্যই প্রতিটি সেশনের জন্য একটি নতুন টোকেন তৈরি করতে হবে। যদি দ্রষ্টব্য: ঠিকানা যাচাইকরণ শুধুমাত্র স্বয়ংসম্পূর্ণ (নতুন) API সহ সেশনগুলিতে ব্যবহার করা যেতে পারে, স্বয়ংসম্পূর্ণ API নয়। আরও বিশদ বিবরণের জন্য https://developers.google.com/maps/documentation/places/web-service/session-pricing দেখুন৷ |
প্রতিক্রিয়া শরীর
একটি ঠিকানা বৈধতা অনুরোধের প্রতিক্রিয়া.
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{
"result": {
object ( |
ক্ষেত্র | |
---|---|
result | ঠিকানা যাচাইকরণের ফলাফল। |
responseId | UUID যা এই প্রতিক্রিয়া সনাক্ত করে। ঠিকানাটি পুনরায় যাচাই করার প্রয়োজন হলে, এই UUID অবশ্যই নতুন অনুরোধের সাথে থাকবে। |
ডাক ঠিকানা
একটি ডাক ঠিকানা প্রতিনিধিত্ব করে, যেমন ডাক বিতরণ বা অর্থপ্রদানের ঠিকানার জন্য। একটি ডাক ঠিকানা দেওয়া হলে, একটি ডাক পরিষেবা একটি প্রিমাইজ, PO বক্স বা অনুরূপ আইটেমগুলি সরবরাহ করতে পারে। এটি ভৌগলিক অবস্থান (রাস্তা, শহর, পাহাড়) মডেল করার উদ্দেশ্যে নয়।
সাধারণ ব্যবহারে একটি ঠিকানা ব্যবহারকারীর ইনপুট বা বিদ্যমান ডেটা আমদানির মাধ্যমে তৈরি করা হবে, প্রক্রিয়ার ধরনের উপর নির্ভর করে।
ঠিকানা ইনপুট / সম্পাদনা সংক্রান্ত পরামর্শ: - একটি আন্তর্জাতিকীকরণ-প্রস্তুত ঠিকানা উইজেট ব্যবহার করুন যেমন https://github.com/google/libaddressinput ) - ব্যবহারকারীদের UI উপাদানগুলি ইনপুট বা ক্ষেত্রগুলির সম্পাদনার জন্য উপস্থাপন করা উচিত নয় যেখানে সেই ক্ষেত্রটি রয়েছে ব্যবহৃত
এই স্কিমাটি কীভাবে ব্যবহার করবেন সে সম্পর্কে আরও নির্দেশনার জন্য, অনুগ্রহ করে দেখুন: https://support.google.com/business/answer/6397478
JSON প্রতিনিধিত্ব |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
ক্ষেত্র | |
---|---|
revision | |
regionCode | ঐচ্ছিক। ঠিকানার দেশ/অঞ্চলের CLDR অঞ্চল কোড। বিস্তারিত জানার জন্য https://cldr.unicode.org/ এবং https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html দেখুন। উদাহরণ: সুইজারল্যান্ডের জন্য "CH"। অঞ্চল কোড প্রদান করা না হলে, এটি ঠিকানা থেকে অনুমান করা হবে. সেরা পারফরম্যান্সের জন্য, যদি আপনি এটি জানেন তবে অঞ্চল কোড অন্তর্ভুক্ত করার পরামর্শ দেওয়া হয়। অসামঞ্জস্যপূর্ণ বা পুনরাবৃত্তি অঞ্চলগুলি খারাপ কার্যক্ষমতার দিকে নিয়ে যেতে পারে, উদাহরণস্বরূপ, যদি |
languageCode | ইনপুট ঠিকানার ভাষা কোড ভবিষ্যতে ব্যবহারের জন্য সংরক্ষিত এবং আজ উপেক্ষা করা হয়। API ঠিকানাটি যেখানে অবস্থিত তার জন্য উপযুক্ত ভাষায় ঠিকানা প্রদান করে। |
postalCode | ঐচ্ছিক। ঠিকানার পোস্টাল কোড। সমস্ত দেশে পোস্টাল কোড ব্যবহার করা হয় না বা উপস্থিত থাকার প্রয়োজন হয় না, তবে যেখানে সেগুলি ব্যবহার করা হয়, তারা ঠিকানার অন্যান্য অংশগুলির সাথে অতিরিক্ত বৈধতা ট্রিগার করতে পারে (যেমন মার্কিন যুক্তরাষ্ট্রে রাজ্য/জিপ বৈধতা)। |
sortingCode | ঐচ্ছিক। অতিরিক্ত, দেশ-নির্দিষ্ট, সাজানোর কোড। এটি বেশিরভাগ অঞ্চলে ব্যবহৃত হয় না। যেখানে এটি ব্যবহার করা হয়, মানটি হয় "CEDEX" এর মতো একটি স্ট্রিং, ঐচ্ছিকভাবে একটি সংখ্যা (যেমন "CEDEX 7") অনুসরণ করে, অথবা শুধুমাত্র একটি সংখ্যা, যা "সেক্টর কোড" (জ্যামাইকা), "ডেলিভারি এলাকা সূচক" প্রতিনিধিত্ব করে। (মালাউই) বা "ডাকঘর সূচক" (যেমন কোট ডি আইভরি)। |
administrativeArea | ঐচ্ছিক। সর্বোচ্চ প্রশাসনিক উপবিভাগ যা একটি দেশ বা অঞ্চলের ডাক ঠিকানার জন্য ব্যবহৃত হয়। উদাহরণস্বরূপ, এটি একটি রাজ্য, একটি প্রদেশ, একটি ওব্লাস্ট বা একটি প্রিফেকচার হতে পারে। বিশেষ করে, স্পেনের জন্য এটি প্রদেশ এবং স্বায়ত্তশাসিত সম্প্রদায় নয় (যেমন "বার্সেলোনা" এবং "কাতালোনিয়া" নয়)। অনেক দেশ ডাক ঠিকানায় প্রশাসনিক এলাকা ব্যবহার করে না। যেমন সুইজারল্যান্ডে এটি জনবসতিহীন ছেড়ে দেওয়া উচিত। |
locality | ঐচ্ছিক। সাধারণত ঠিকানার শহর/শহরের অংশকে বোঝায়। উদাহরণ: ইউএস সিটি, আইটি কমিউন, ইউকে পোস্ট টাউন। বিশ্বের এমন অঞ্চলে যেখানে লোকালয়টি ভালভাবে সংজ্ঞায়িত করা হয় না বা এই কাঠামোর সাথে ভালভাবে ফিট করে না, লোকালয়টি খালি রাখুন এবং অ্যাড্রেসলাইনগুলি ব্যবহার করুন। |
sublocality | ঐচ্ছিক। ঠিকানার উপ-অবস্থান। উদাহরণস্বরূপ, এটি পাড়া, বরো, জেলা হতে পারে। |
addressLines[] | প্রয়োজন। একটি ঠিকানার নিম্ন স্তরের বর্ণনা করে অসংগঠিত ঠিকানা লাইন। |
recipients[] | এই ক্ষেত্র সেট করা এড়িয়ে চলুন দয়া করে. ঠিকানা যাচাইকরণ API বর্তমানে এটি ব্যবহার করে না। যদিও এই সময়ে API এই ফিল্ড সেটের সাথে অনুরোধগুলি প্রত্যাখ্যান করবে না, তথ্যটি বাতিল করা হবে এবং প্রতিক্রিয়াতে ফেরত দেওয়া হবে না। |
organization | এই ক্ষেত্র সেট করা এড়িয়ে চলুন দয়া করে. ঠিকানা যাচাইকরণ API বর্তমানে এটি ব্যবহার করে না। যদিও এই সময়ে API এই ফিল্ড সেটের সাথে অনুরোধগুলি প্রত্যাখ্যান করবে না, তথ্যটি বাতিল করা হবে এবং প্রতিক্রিয়াতে ফেরত দেওয়া হবে না। |
ভাষার বিকল্প
পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।
প্রতিক্রিয়াতে অতিরিক্ত তথ্য অন্তর্ভুক্ত করতে ঠিকানা যাচাইকরণ API সক্ষম করে৷
JSON প্রতিনিধিত্ব |
---|
{ "returnEnglishLatinAddress": boolean } |
ক্ষেত্র | |
---|---|
returnEnglishLatinAddress | পূর্বরূপ: ইংরেজিতে একটি |
যাচাইকরণের ফলাফল
ঠিকানা যাচাই করার ফলাফল।
JSON প্রতিনিধিত্ব |
---|
{ "verdict": { object ( |
ক্ষেত্র | |
---|---|
verdict | সামগ্রিক রায়ের পতাকা |
address | জিওকোডের বিপরীতে ঠিকানা সম্পর্কে তথ্য। |
geocode | ঠিকানা জিওকোড করা অবস্থান এবং স্থান সম্পর্কে তথ্য। |
metadata | বিতরণযোগ্যতার সাথে সম্পর্কিত অন্যান্য তথ্য। ঠিকানা যাচাইকরণ API এ পাঠানো প্রতিটি ঠিকানার জন্য |
uspsData | USPS দ্বারা প্রদত্ত অতিরিক্ত বিতরণযোগ্য পতাকা। শুধুমাত্র অঞ্চল |
englishLatinAddress | পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন। ঠিকানাটি ইংরেজিতে অনুবাদ করা হয়েছে। অনুবাদিত ঠিকানাগুলি API ইনপুট হিসাবে পুনরায় ব্যবহারযোগ্য নয়৷ পরিষেবাটি তাদের প্রদান করে যাতে ব্যবহারকারী তাদের স্থানীয় ভাষা ব্যবহার করে আসল-প্রদত্ত ঠিকানার বৈধতা নিশ্চিত বা অস্বীকার করতে পারে। ঠিকানার অংশের ইংরেজি অনুবাদ না থাকলে, পরিষেবাটি সেই অংশটিকে একটি বিকল্প ভাষায় ফেরত দেয় যা একটি ল্যাটিন স্ক্রিপ্ট ব্যবহার করে। কিভাবে বিকল্প ভাষা নির্বাচন করা হয় তার ব্যাখ্যার জন্য এখানে দেখুন। যদি ঠিকানার অংশে ল্যাটিন স্ক্রিপ্ট ব্যবহার করে এমন কোনো ভাষায় কোনো অনুবাদ বা প্রতিবর্ণীকরণ না থাকে, তাহলে পরিষেবাটি ঠিকানার সাথে যুক্ত স্থানীয় ভাষায় সেই অংশটি ফিরিয়ে দেয়। দ্রষ্টব্য: |
রায়
ঠিকানা যাচাইকরণ ফলাফল এবং জিওকোডের উচ্চ স্তরের ওভারভিউ।
JSON প্রতিনিধিত্ব |
---|
{ "inputGranularity": enum ( |
ক্ষেত্র | |
---|---|
inputGranularity | ইনপুট ঠিকানার গ্রানুলারিটি। এটি ইনপুট ঠিকানা পার্স করার ফলাফল এবং কোন বৈধতা সংকেত দেয় না। বৈধতা সংকেতের জন্য, নীচের উদাহরণস্বরূপ, যদি ইনপুট ঠিকানায় একটি নির্দিষ্ট অ্যাপার্টমেন্ট নম্বর থাকে, তাহলে এখানে |
validationGranularity | কণিকা স্তর যা API ঠিকানাটিকে সম্পূর্ণরূপে যাচাই করতে পারে৷ উদাহরণস্বরূপ, প্রতি ঠিকানা উপাদান যাচাইকরণের ফলাফল |
geocodeGranularity | এটি মাঝে মাঝে উপরের |
addressComplete | কোনো অমীমাংসিত টোকেন না থাকলে, কোনো অপ্রত্যাশিত বা অনুপস্থিত ঠিকানা উপাদান না থাকলে ঠিকানাটি সম্পূর্ণ বলে বিবেচিত হয়। যদি সেট না থাকে, তাহলে নির্দেশ করে যে মানটি |
hasUnconfirmedComponents | অন্তত একটি ঠিকানা উপাদান শ্রেণীবদ্ধ বা যাচাই করা যাবে না, বিস্তারিত জানার জন্য |
hasInferredComponents | অন্তত একটি ঠিকানা উপাদান অনুমান করা হয়েছে (যোগ করা হয়েছে) যা ইনপুটে ছিল না, বিস্তারিত জানার জন্য |
hasReplacedComponents | অন্তত একটি ঠিকানা উপাদান প্রতিস্থাপিত হয়েছে, বিস্তারিত জানার জন্য |
গ্রানুলারিটি
একটি ঠিকানা বা একটি জিওকোড থাকতে পারে এমন বিভিন্ন গ্রানুলারিটি। যখন একটি ঠিকানার জন্য গ্রানুলারিটি নির্দেশ করতে ব্যবহৃত হয়, তখন এই মানগুলি নির্দেশ করে যে ঠিকানাটি একটি মেইলিং গন্তব্যকে কতটা সূক্ষ্ম কণিকা চিহ্নিত করে। উদাহরণ স্বরূপ, একটি ঠিকানা যেমন "123 Main Street, Redwood City, CA, 94061" একটি PREMISE
সনাক্ত করে যখন "Redwood City, CA, 94061" এর মতো কিছু একটি LOCALITY
সনাক্ত করে৷ যাইহোক, যদি আমরা রেডউড সিটিতে "123 মেইন স্ট্রিট"-এর জন্য একটি জিওকোড খুঁজে না পাই, তবে ঠিকানাটি আরও দানাদার হওয়া সত্ত্বেও যে জিওকোড ফেরত দেওয়া হয়েছে তা LOCALITY
গ্র্যানুলারিটির হতে পারে৷
Enums | |
---|---|
GRANULARITY_UNSPECIFIED | ডিফল্ট মান। এই মান অব্যবহৃত. |
SUB_PREMISE | নিম্ন-বিল্ডিং স্তরের ফলাফল, যেমন একটি অ্যাপার্টমেন্ট। |
PREMISE | বিল্ডিং-স্তরের ফলাফল। |
PREMISE_PROXIMITY | একটি জিওকোড যা ঠিকানাটির বিল্ডিং-স্তরের অবস্থান আনুমানিক করে। |
BLOCK | ঠিকানা বা জিওকোড একটি ব্লক নির্দেশ করে। শুধুমাত্র সেই অঞ্চলে ব্যবহৃত হয় যেখানে ব্লক-লেভেল অ্যাড্রেসিং আছে, যেমন জাপান। |
ROUTE | জিওকোড বা ঠিকানাটি রুটের জন্য দানাদার, যেমন রাস্তা, রাস্তা বা হাইওয়ে। |
OTHER | অন্যান্য সমস্ত গ্রানুলারিটি, যেগুলিকে একসাথে বাকেট করা হয় যেহেতু সেগুলি বিতরণযোগ্য নয়৷ |
ঠিকানা
পোস্ট-প্রসেসড ঠিকানার বিশদ বিবরণ। পোস্ট-প্রসেসিং এর মধ্যে রয়েছে ঠিকানার ভুল বানান অংশ সংশোধন করা, ভুল অংশ প্রতিস্থাপন করা এবং অনুপস্থিত অংশ অনুমান করা।
JSON প্রতিনিধিত্ব |
---|
{ "formattedAddress": string, "postalAddress": { object ( |
ক্ষেত্র | |
---|---|
formattedAddress | পোস্ট-প্রসেসড অ্যাড্রেস, যেখানে ঠিকানাটি অবস্থিত সেই অঞ্চলের অ্যাড্রেস ফরম্যাটিং নিয়ম অনুসরণ করে একটি একক-লাইন ঠিকানা হিসাবে ফর্ম্যাট করা হয়। |
postalAddress | পোস্ট-প্রসেসড ঠিকানা একটি ডাক ঠিকানা হিসাবে প্রতিনিধিত্ব করে। |
addressComponents[] | Unordered তালিকা। বৈধতা তথ্য সহ ফর্ম্যাট করা এবং সংশোধন করা ঠিকানার পৃথক ঠিকানা উপাদান। এটি পৃথক উপাদানের বৈধতা অবস্থার তথ্য প্রদান করে। ঠিকানা উপাদান একটি নির্দিষ্ট উপায়ে আদেশ করা হয় না. তালিকার ঠিকানা উপাদানগুলির ক্রমানুসারে কোনো অনুমান করবেন না। |
missingComponentTypes[] | সঠিকভাবে ফরম্যাট করা মেইলিং ঠিকানায় উপস্থিত থাকার প্রত্যাশিত উপাদানগুলির প্রকারগুলি কিন্তু ইনপুটে পাওয়া যায়নি এবং অনুমান করা যায়নি৷ এই ধরনের উপাদানগুলি |
unconfirmedComponentTypes[] | |
unresolvedTokens[] | ইনপুটে কোনো টোকেন আছে যা সমাধান করা যায়নি। এটি এমন একটি ইনপুট হতে পারে যা একটি ঠিকানার একটি বৈধ অংশ হিসাবে স্বীকৃত হয়নি (উদাহরণস্বরূপ একটি ইনপুটে যেমন "123235253253 Main St, San Francisco, CA, 94105", অমীমাংসিত টোকেনগুলি |
ঠিকানা উপাদান
একটি ঠিকানা উপাদান প্রতিনিধিত্ব করে, যেমন একটি রাস্তা, শহর বা রাজ্য।
JSON প্রতিনিধিত্ব |
---|
{ "componentName": { object ( |
ক্ষেত্র | |
---|---|
componentName | এই উপাদান জন্য নাম. |
componentType | ঠিকানা উপাদানের ধরন। সারণি 2 দেখুন: সম্ভাব্য প্রকারের তালিকার জন্য স্থান পরিষেবা দ্বারা প্রত্যাবর্তিত অতিরিক্ত প্রকারগুলি । |
confirmationLevel | আমাদের নিশ্চিততার স্তর নির্দেশ করে যে উপাদানটি সঠিক। |
inferred | ইঙ্গিত করে যে উপাদানটি ইনপুটের অংশ ছিল না, কিন্তু আমরা ঠিকানার অবস্থানের জন্য এটি অনুমান করেছি এবং বিশ্বাস করি এটি একটি সম্পূর্ণ ঠিকানার জন্য প্রদান করা উচিত। |
spellCorrected | উপাদান নামের একটি ভুল বানান সংশোধন নির্দেশ করে। API সর্বদা একটি বানান বৈকল্পিক থেকে অন্য বানান পরিবর্তন করে না, যেমন যখন "কেন্দ্র" থেকে "কেন্দ্র" পরিবর্তন করে। এটি সর্বদা সাধারণ ভুল বানানগুলিকেও ফ্ল্যাগ করে না, যেমন যখন "Amphitheater Pkwy" থেকে "Amphitheatre Pkwy" পরিবর্তন করে। |
replaced | ইঙ্গিত করে যে উপাদানটির নাম সম্পূর্ণ ভিন্ন একটি দিয়ে প্রতিস্থাপিত হয়েছে, উদাহরণস্বরূপ ঠিকানার জন্য সঠিক একটি দিয়ে একটি ভুল পোস্টাল কোড প্রতিস্থাপিত হচ্ছে৷ এটি একটি প্রসাধনী পরিবর্তন নয়, ইনপুট উপাদান একটি ভিন্ন একটি পরিবর্তন করা হয়েছে. |
unexpected | একটি ঠিকানা উপাদান নির্দেশ করে যা প্রদত্ত অঞ্চলের জন্য একটি ডাক ঠিকানায় উপস্থিত থাকার আশা করা হয় না৷ আমরা এটিকে ধরে রেখেছি কারণ এটি ইনপুটের অংশ ছিল। |
উপাদানের নাম
কম্পোনেন্টের নামের জন্য একটি মোড়ক।
JSON প্রতিনিধিত্ব |
---|
{ "text": string, "languageCode": string } |
ক্ষেত্র | |
---|---|
text | নামের পাঠ্য। উদাহরণস্বরূপ, রাস্তার নামের জন্য "5ম অ্যাভিনিউ" বা রাস্তার নম্বরের জন্য "1253"। |
languageCode | BCP-47 ভাষার কোড। এটি উপস্থিত থাকবে না যদি উপাদানের নামটি একটি ভাষার সাথে যুক্ত না হয়, যেমন রাস্তার নম্বর। |
নিশ্চিতকরণ স্তর
নিশ্চিতকরণ স্তরের জন্য বিভিন্ন সম্ভাব্য মান।
Enums | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED | ডিফল্ট মান। এই মান অব্যবহৃত. |
CONFIRMED | আমরা যাচাই করতে সক্ষম হয়েছি যে এই উপাদানটি বিদ্যমান এবং বাকি ঠিকানার প্রেক্ষাপটে অর্থপূর্ণ। |
UNCONFIRMED_BUT_PLAUSIBLE | এই উপাদানটি নিশ্চিত করা যায়নি, তবে এটির অস্তিত্ব আছে বলে বিশ্বাসযোগ্য। উদাহরণস্বরূপ, একটি রাস্তার নম্বর যেখানে নির্দিষ্ট বাড়ির নম্বর জানা নেই এমন একটি রাস্তায় সংখ্যার একটি পরিচিত বৈধ পরিসরের মধ্যে। |
UNCONFIRMED_AND_SUSPICIOUS | এই উপাদানটি নিশ্চিত করা হয়নি এবং সম্ভবত ভুল হতে পারে। উদাহরণস্বরূপ, একটি আশেপাশের এলাকা যা বাকি ঠিকানার সাথে খাপ খায় না। |
জিওকোড
যেখানে ইনপুটটি জিওকোড করা হয়েছিল সে সম্পর্কে তথ্য রয়েছে৷
JSON প্রতিনিধিত্ব |
---|
{ "location": { object ( |
ক্ষেত্র | |
---|---|
location | ইনপুটের জিওকোডেড অবস্থান। ঠিকানা, অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক বা প্লাস কোড ব্যবহার করার চেয়ে স্থান আইডি ব্যবহার করা পছন্দনীয়। ড্রাইভিং দিকনির্দেশ রাউটিং বা গণনা করার সময় স্থানাঙ্ক ব্যবহার করার ফলে সর্বদা পয়েন্টটি সেই স্থানাঙ্কগুলির নিকটবর্তী রাস্তায় স্ন্যাপ করা হবে। এটি এমন একটি রাস্তা নাও হতে পারে যা দ্রুত বা নিরাপদে গন্তব্যে নিয়ে যাবে এবং সম্পত্তির অ্যাক্সেস পয়েন্টের কাছাকাছি নাও হতে পারে। উপরন্তু, যখন একটি অবস্থান বিপরীত জিওকোড করা হয়, তখন কোন গ্যারান্টি নেই যে ফেরত ঠিকানাটি আসলটির সাথে মিলবে। |
plusCode | |
bounds | জিওকোড করা স্থানের সীমানা। |
featureSizeMeters | জিওকোড করা জায়গার মাপ, মিটারে। এটি জিওকোডেড অবস্থানের স্থূলতার আরেকটি পরিমাপ, কিন্তু শব্দার্থগত অর্থের পরিবর্তে প্রকৃত আকারে। |
placeId | এই ইনপুট জিওকোড করা জায়গার PlaceID। প্লেস আইডি সম্পর্কে আরও তথ্যের জন্য এখানে দেখুন। |
placeTypes[] | ইনপুট জিওকোড করা স্থানের প্রকার(গুলি)৷ উদাহরণস্বরূপ, |
LatLng
একটি বস্তু যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া প্রতিনিধিত্ব করে। এটি ডিগ্রী অক্ষাংশ এবং ডিগ্রী দ্রাঘিমাংশের প্রতিনিধিত্ব করার জন্য এক জোড়া দ্বিগুণ হিসাবে প্রকাশ করা হয়। অন্যথায় নির্দিষ্ট করা না থাকলে, এই বস্তুটিকে অবশ্যই WGS84 মান মেনে চলতে হবে। মানগুলি অবশ্যই স্বাভাবিক সীমার মধ্যে থাকতে হবে৷
JSON প্রতিনিধিত্ব |
---|
{ "latitude": number, "longitude": number } |
ক্ষেত্র | |
---|---|
latitude | ডিগ্রী অক্ষাংশ. এটি অবশ্যই [-90.0, +90.0] এর মধ্যে হতে হবে। |
longitude | ডিগ্রী দ্রাঘিমাংশ. এটি অবশ্যই [-180.0, +180.0] পরিসরে হতে হবে। |
প্লাসকোড
প্লাস কোড ( http://plus.codes ) হল দুটি ফর্ম্যাট সহ একটি অবস্থানের রেফারেন্স: গ্লোবাল কোড একটি 14mx14m (ডিগ্রীর 1/8000তম) বা ছোট আয়তক্ষেত্র সংজ্ঞায়িত করে এবং যৌগিক কোড, একটি রেফারেন্স অবস্থানের সাথে উপসর্গ প্রতিস্থাপন করে।
JSON প্রতিনিধিত্ব |
---|
{ "globalCode": string, "compoundCode": string } |
ক্ষেত্র | |
---|---|
globalCode | স্থানের গ্লোবাল (সম্পূর্ণ) কোড, যেমন "9FWM33GV+HQ", একটি 1/8000 বাই 1/8000 ডিগ্রী এলাকা (~14 বাই 14 মিটার) প্রতিনিধিত্ব করে। |
compoundCode | স্থানের যৌগিক কোড, যেমন "33GV+HQ, Ramberg, Norway", যেখানে গ্লোবাল কোডের প্রত্যয় রয়েছে এবং একটি রেফারেন্স সত্তার ফর্ম্যাট করা নামের সাথে প্রিফিক্স প্রতিস্থাপন করা হয়েছে। |
ভিউপোর্ট
একটি অক্ষাংশ-দ্রাঘিমাংশ ভিউপোর্ট, দুটি তির্যক বিপরীত low
এবং high
বিন্দু হিসাবে উপস্থাপিত। একটি ভিউপোর্টকে একটি বন্ধ অঞ্চল হিসাবে বিবেচনা করা হয়, অর্থাৎ এটি এর সীমানা অন্তর্ভুক্ত করে। অক্ষাংশের সীমাগুলি অবশ্যই -90 থেকে 90 ডিগ্রী সহ, এবং দ্রাঘিমাংশের সীমাগুলি অবশ্যই -180 থেকে 180 ডিগ্রী সহ এর মধ্যে হতে হবে৷ বিভিন্ন ক্ষেত্রে অন্তর্ভুক্ত:
low
=high
হলে, ভিউপোর্টটি সেই একক বিন্দু নিয়ে গঠিত।low.longitude
>high.longitude
হলে, দ্রাঘিমাংশের সীমাটি উল্টানো হয় (ভিউপোর্টটি 180 ডিগ্রি দ্রাঘিমাংশের রেখা অতিক্রম করে)।low.longitude
= -180 ডিগ্রি এবংhigh.longitude
= 180 ডিগ্রি হলে, ভিউপোর্টে সমস্ত দ্রাঘিমাংশ অন্তর্ভুক্ত থাকে।low.longitude
= 180 ডিগ্রি এবংhigh.longitude
= -180 ডিগ্রি হলে, দ্রাঘিমাংশের পরিসর খালি।low.latitude
>high.latitude
হলে, অক্ষাংশ পরিসর খালি থাকে।
low
এবং high
উভয়ই জনবসতিপূর্ণ হতে হবে এবং উপস্থাপিত বাক্সটি খালি হতে পারে না (উপরের সংজ্ঞা দ্বারা নির্দিষ্ট করা হয়েছে)। একটি খালি ভিউপোর্ট একটি ত্রুটির কারণ হবে.
উদাহরণস্বরূপ, এই ভিউপোর্টটি সম্পূর্ণরূপে নিউ ইয়র্ক সিটিকে ঘিরে রেখেছে:
{ "নিম্ন": { "অক্ষাংশ": 40.477398, "দ্রাঘিমাংশ": -74.259087 }, "উচ্চ": { "অক্ষাংশ": 40.91618, "দ্রাঘিমাংশ": -73.70018 } }
JSON প্রতিনিধিত্ব |
---|
{ "low": { object ( |
ক্ষেত্র | |
---|---|
low | প্রয়োজন। ভিউপোর্টের নিম্ন পয়েন্ট। |
high | প্রয়োজন। ভিউপোর্টের উচ্চ বিন্দু। |
ঠিকানা মেটাডেটা
ঠিকানার জন্য মেটাডেটা। ঠিকানা যাচাইকরণ API এ পাঠানো প্রতিটি ঠিকানার জন্য metadata
সম্পূর্ণরূপে জনবহুল হওয়ার নিশ্চয়তা নেই।
JSON প্রতিনিধিত্ব |
---|
{ "business": boolean, "poBox": boolean, "residential": boolean } |
ক্ষেত্র | |
---|---|
business | নির্দেশ করে যে এটি একটি ব্যবসার ঠিকানা। যদি সেট না থাকে, তাহলে নির্দেশ করে যে মানটি অজানা। |
poBox | একটি PO বক্সের ঠিকানা নির্দেশ করে। যদি সেট না থাকে, তাহলে নির্দেশ করে যে মানটি অজানা। |
residential | নির্দেশ করে যে এটি একটি বাসস্থানের ঠিকানা। যদি সেট না থাকে, তাহলে নির্দেশ করে যে মানটি অজানা। |
ইউএসপিএস ডেটা
ঠিকানার জন্য USPS ডেটা। ঠিকানা যাচাইকরণ API এ পাঠানো প্রতিটি US বা PR ঠিকানার জন্য uspsData
সম্পূর্ণরূপে জনবহুল হওয়ার নিশ্চয়তা নেই। আপনি যদি প্রতিক্রিয়ার প্রাথমিক অংশ হিসাবে uspsData ব্যবহার করেন তবে প্রতিক্রিয়াতে ব্যাকআপ ঠিকানা ক্ষেত্রগুলিকে সংহত করার পরামর্শ দেওয়া হয়।
JSON প্রতিনিধিত্ব |
---|
{
"standardizedAddress": {
object ( |
ক্ষেত্র | |
---|---|
standardizedAddress | USPS প্রমিত ঠিকানা। |
deliveryPointCode | 2 সংখ্যার ডেলিভারি পয়েন্ট কোড |
deliveryPointCheckDigit | ডেলিভারি পয়েন্ট চেক ডিজিট। এই নম্বরটি যান্ত্রিকভাবে স্ক্যান করা মেলের জন্য বিতরণ_পয়েন্ট_বারকোডের শেষে যোগ করা হয়। Delivery_point_barcode, deliveryPointCheckDigit, পোস্টাল কোড, এবং ZIP+4 এর সমস্ত সংখ্যা একসাথে যোগ করলে 10 দ্বারা বিভাজ্য সংখ্যা পাওয়া উচিত। |
dpvConfirmation | DPV নিশ্চিতকরণের সম্ভাব্য মান। একটি একক অক্ষর প্রদান করে বা কোনো মান প্রদান করে না।
|
dpvFootnote | ডেলিভারি পয়েন্ট বৈধতা থেকে পাদটীকা. একাধিক পাদটীকা একই স্ট্রিং এ একসাথে স্ট্রং করা যেতে পারে।
|
dpvCmra | ঠিকানাটি একটি CMRA (বাণিজ্যিক মেল রিসিভিং এজেন্সি)- - ক্লায়েন্টদের জন্য একটি ব্যক্তিগত ব্যবসায়িক মেল গ্রহণ করে কিনা তা নির্দেশ করে৷ একটি একক অক্ষর প্রদান করে।
|
dpvVacant | এই জায়গা কি খালি? একটি একক অক্ষর প্রদান করে।
|
dpvNoStat | এটি কি কোন স্ট্যাট ঠিকানা না একটি সক্রিয় ঠিকানা? কোন স্ট্যাট ঠিকানা এমন নয় যা ক্রমাগত দখল করা হয় না বা এমন ঠিকানা যা USPS পরিষেবা দেয় না। একটি একক অক্ষর প্রদান করে।
|
dpvNoStatReasonCode | NoStat প্রকার নির্দেশ করে। int হিসাবে একটি কারণ কোড প্রদান করে।
|
dpvDrop | পতাকা নির্দেশ করে যে একটি সাইটে একটি একক গ্রহণযোগ্য মেল বিতরণ করা হয়েছে। একটি একক অক্ষর প্রদান করে।
|
dpvThrowback | ইঙ্গিত করে যে মেল রাস্তার ঠিকানায় বিতরণ করা হয় না। একটি একক অক্ষর প্রদান করে।
|
dpvNonDeliveryDays | পতাকা নির্দেশ করে মেইল ডেলিভারি সপ্তাহের প্রতিদিন সঞ্চালিত হয় না। একটি একক অক্ষর প্রদান করে।
|
dpvNonDeliveryDaysValues | পূর্ণসংখ্যা নন-ডেলিভারি দিন সনাক্ত করে। বিট ফ্ল্যাগ ব্যবহার করে জিজ্ঞাসাবাদ করা যেতে পারে: 0x40 - রবিবার একটি নন-ডেলিভারির দিন 0x20 - সোমবার একটি নন-ডেলিভারির দিন 0x10 - মঙ্গলবার একটি নন-ডেলিভারির দিন 0x08 - বুধবার একটি নন-ডেলিভারির দিন 0x04 - বৃহস্পতিবার একটি নন-ডেলিভারি দিন -ডেলিভারির দিন 0x02 - শুক্রবার একটি নন-ডেলিভারির দিন 0x01 - শনিবার একটি নন-ডেলিভারির দিন |
dpvNoSecureLocation | পতাকা নির্দেশ করে দরজা অ্যাক্সেসযোগ্য, কিন্তু নিরাপত্তা উদ্বেগের কারণে প্যাকেজটি ছেড়ে দেওয়া হবে না। একটি একক অক্ষর প্রদান করে।
|
dpvPbsa | ইঙ্গিত করে ঠিকানাটি PBSA রেকর্ডের সাথে মিলে গেছে। একটি একক অক্ষর প্রদান করে।
|
dpvDoorNotAccessible | পতাকা সেই ঠিকানাগুলি নির্দেশ করে যেখানে ইউএসপিএস মেল বিতরণের জন্য দরজায় টোকা দিতে পারে না। একটি একক অক্ষর প্রদান করে।
|
dpvEnhancedDeliveryCode | নির্দেশ করে যে ঠিকানার জন্য একাধিক DPV রিটার্ন কোড বৈধ। একটি একক অক্ষর প্রদান করে।
|
carrierRoute | ক্যারিয়ার রুট কোড। একটি চার অক্ষরের কোড যা একটি এক অক্ষর উপসর্গ এবং একটি তিন অঙ্কের রুট ডিজাইনার নিয়ে গঠিত। উপসর্গ:
|
carrierRouteIndicator | ক্যারিয়ার রুট রেট সাজানোর সূচক। |
ewsNoMatch | ডেলিভারির ঠিকানা মিলছে, কিন্তু EWS ফাইলটি নির্দেশ করে যে শীঘ্রই একটি সঠিক মিল পাওয়া যাবে। |
postOfficeCity | প্রধান পোস্ট অফিস শহর। |
postOfficeState | প্রধান পোস্ট অফিস রাষ্ট্র. |
abbreviatedCity | সংক্ষিপ্ত শহর। |
fipsCountyCode | FIPS কাউন্টি কোড। |
county | কাউন্টির নাম। |
elotNumber | ভ্রমণের বর্ধিত লাইন (eLOT) নম্বর। |
elotFlag | eLOT অ্যাসেন্ডিং/ডিসেন্ডিং ফ্ল্যাগ (A/D)। |
lacsLinkReturnCode | LACSLink রিটার্ন কোড। |
lacsLinkIndicator | LACSLink সূচক। |
poBoxOnlyPostalCode | PO বক্স শুধুমাত্র পোস্টাল কোড. |
suitelinkFootnote | পাদটীকাগুলি একটি রাস্তার বা হাইরাইজ রেকর্ডের সাথে স্যুট তথ্যের সাথে মিলে যায়৷ ব্যবসার নামের মিল পাওয়া গেলে, সেকেন্ডারি নম্বর ফেরত দেওয়া হয়।
|
pmbDesignator | PMB (প্রাইভেট মেইল বক্স) ইউনিট মনোনীত। |
pmbNumber | PMB (ব্যক্তিগত মেইল বক্স) নম্বর; |
addressRecordType | ঠিকানা রেকর্ডের প্রকার যা ইনপুট ঠিকানার সাথে মেলে।
|
defaultAddress | নির্দেশক যে একটি ডিফল্ট ঠিকানা পাওয়া গেছে, কিন্তু আরো নির্দিষ্ট ঠিকানা বিদ্যমান। |
errorMessage | USPS ডেটা পুনরুদ্ধারের জন্য ত্রুটি বার্তা। কৃত্রিমভাবে তৈরি ঠিকানা সনাক্তকরণের কারণে যখন USPS প্রক্রিয়াকরণ স্থগিত করা হয় তখন এটি জনবহুল হয়। এই ত্রুটি উপস্থিত থাকলে USPS ডেটা ক্ষেত্রগুলি জনবহুল নাও হতে পারে। |
cassProcessed | নির্দেশক যে অনুরোধটি CASS প্রক্রিয়া করা হয়েছে। |
ইউএসপিএস ঠিকানা
একটি মার্কিন ঠিকানার USPS প্রতিনিধিত্ব.
JSON প্রতিনিধিত্ব |
---|
{ "firstAddressLine": string, "firm": string, "secondAddressLine": string, "urbanization": string, "cityStateZipAddressLine": string, "city": string, "state": string, "zipCode": string, "zipCodeExtension": string } |
ক্ষেত্র | |
---|---|
firstAddressLine | প্রথম ঠিকানা লাইন। |
firm | দৃঢ় নাম। |
secondAddressLine | দ্বিতীয় ঠিকানা লাইন। |
urbanization | পুয়ের্তো রিকান নগরায়নের নাম। |
cityStateZipAddressLine | শহর + রাজ্য + পোস্টাল কোড। |
city | শহরের নাম। |
state | 2 অক্ষরের রাষ্ট্রীয় কোড। |
zipCode | পোস্টাল কোড যেমন 10009। |
zipCodeExtension | 4-সংখ্যার পোস্টাল কোড এক্সটেনশন যেমন 5023। |
- HTTP অনুরোধ
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- ডাক ঠিকানা
- ভাষার বিকল্প
- যাচাইকরণের ফলাফল
- রায়
- গ্রানুলারিটি
- ঠিকানা
- ঠিকানা উপাদান
- উপাদানের নাম
- নিশ্চিতকরণ স্তর
- জিওকোড
- LatLng
- প্লাসকোড
- ভিউপোর্ট
- ঠিকানা মেটাডেটা
- ইউএসপিএস ডেটা
- ইউএসপিএস ঠিকানা
একটি ঠিকানা যাচাই করে।
HTTP অনুরোধ
POST https://addressvalidation.googleapis.com/v1:validateAddress
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{ "address": { object ( |
ক্ষেত্র | |
---|---|
address | প্রয়োজন। ঠিকানা যাচাই করা হচ্ছে। বিন্যাসহীন ঠিকানা এই ইনপুটে ক্ষেত্রগুলির মোট দৈর্ঘ্য 280 অক্ষরের বেশি হওয়া উচিত নয়৷ সমর্থিত অঞ্চলগুলি এখানে পাওয়া যাবে। ইনপুট ঠিকানায় ঠিকানা যাচাইকরণ API |
previousResponseId | প্রথম ঠিকানা যাচাইকরণের অনুরোধের জন্য এই ক্ষেত্রটি অবশ্যই খালি থাকতে হবে। যদি একটি একক ঠিকানাকে সম্পূর্ণরূপে বৈধ করার জন্য আরও অনুরোধের প্রয়োজন হয় (উদাহরণস্বরূপ যদি ব্যবহারকারীর প্রাথমিক যাচাইকরণের পরে যে পরিবর্তনগুলি করা হয় তা পুনরায় যাচাই করা প্রয়োজন), তাহলে প্রতিটি ফলোআপ অনুরোধকে অবশ্যই প্রথম প্রতিক্রিয়া থেকে |
enableUspsCass | USPS CASS সামঞ্জস্যপূর্ণ মোড সক্ষম করে৷ এটি শুধুমাত্র এটি একটি কম্পোনেন্টাইজড |
languageOptions | ঐচ্ছিক। পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন। প্রতিক্রিয়াতে অতিরিক্ত তথ্য অন্তর্ভুক্ত করতে ঠিকানা যাচাইকরণ API সক্ষম করে৷ |
sessionToken | ঐচ্ছিক। একটি স্ট্রিং যা বিলিং উদ্দেশ্যে একটি স্বয়ংসম্পূর্ণ সেশন সনাক্ত করে৷ সর্বাধিক 36টি ASCII অক্ষর সহ একটি URL এবং ফাইলের নাম নিরাপদ base64 স্ট্রিং হতে হবে৷ অন্যথায় একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হবে৷ সেশন শুরু হয় যখন ব্যবহারকারী একটি স্বয়ংসম্পূর্ণ ক্যোয়ারী করে, এবং শেষ হয় যখন তারা একটি স্থান নির্বাচন করে এবং স্থানের বিবরণ বা ঠিকানা যাচাইকরণে কল করা হয়। প্রতিটি সেশনে একাধিক স্বয়ংসম্পূর্ণ প্রশ্ন থাকতে পারে, তার পরে একটি স্থানের বিবরণ বা ঠিকানা যাচাইকরণের অনুরোধ থাকতে পারে। একটি সেশনের মধ্যে প্রতিটি অনুরোধের জন্য ব্যবহৃত শংসাপত্রগুলি অবশ্যই একই Google Cloud Console প্রকল্পের অন্তর্গত। একবার একটি অধিবেশন শেষ হয়ে গেলে, টোকেনটি আর বৈধ থাকে না; আপনার অ্যাপকে অবশ্যই প্রতিটি সেশনের জন্য একটি নতুন টোকেন তৈরি করতে হবে। যদি দ্রষ্টব্য: ঠিকানার বৈধতা কেবলমাত্র স্বতঃপ্রবাহ (নতুন) এপিআইয়ের সাথে সেশনে ব্যবহার করা যেতে পারে, স্বতঃপূরিত এপিআই নয়। আরও তথ্যের জন্য https://developers.google.com/maps/docamentation/places/web-service/sion-pricing দেখুন। |
প্রতিক্রিয়া শরীর
একটি ঠিকানা বৈধতা অনুরোধ প্রতিক্রিয়া।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{
"result": {
object ( |
ক্ষেত্র | |
---|---|
result | ঠিকানা বৈধতার ফলাফল। |
responseId | ইউইউআইডি যা এই প্রতিক্রিয়া চিহ্নিত করে। যদি ঠিকানাটি পুনরায় বৈধতা দেওয়া দরকার, তবে এই ইউইউডকে অবশ্যই নতুন অনুরোধের সাথে থাকতে হবে। |
ডাক ঠিকানা
ডাক বিতরণ বা প্রদানের ঠিকানাগুলির জন্য যেমন একটি ডাক ঠিকানা উপস্থাপন করে। একটি ডাক ঠিকানা দেওয়া, একটি ডাক পরিষেবা একটি ভিত্তি, পিও বক্স বা অনুরূপ আইটেম সরবরাহ করতে পারে। এটি ভৌগলিক অবস্থানগুলি (রাস্তা, শহর, পর্বতমালা) মডেল করার উদ্দেশ্যে নয়।
সাধারণ ব্যবহারে একটি ঠিকানা ব্যবহারকারী ইনপুট মাধ্যমে বা প্রক্রিয়াটির ধরণের উপর নির্ভর করে বিদ্যমান ডেটা আমদানি করে তৈরি করা হবে।
ঠিকানা ইনপুট/সম্পাদনা সম্পর্কিত পরামর্শ: - একটি আন্তর্জাতিকীকরণ -প্রস্তুত ঠিকানা উইজেট যেমন https://github.com/google/libaddressinput ) ব্যবহার করুন - ব্যবহারকারীদের সেই ক্ষেত্রের বাইরে ক্ষেত্রগুলির ইনপুট বা সম্পাদনার জন্য ইউআই উপাদানগুলির সাথে উপস্থাপন করা উচিত নয় যেখানে ব্যবহৃত
এই স্কিমাটি কীভাবে ব্যবহার করবেন সে সম্পর্কে আরও দিকনির্দেশনার জন্য, দয়া করে দেখুন: https://support.google.com/business/answer/6397478
JSON প্রতিনিধিত্ব |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
ক্ষেত্র | |
---|---|
revision | |
regionCode | ঐচ্ছিক। সিএলডিআর অঞ্চল কোড/ঠিকানার অঞ্চলের কোড। বিশদগুলির জন্য https://cldr.unicode.org/ এবং https://www.unicode.org/cldr/charts/30/supplemental/territority_information.html দেখুন। উদাহরণ: সুইজারল্যান্ডের জন্য "সিএইচ"। যদি অঞ্চল কোড সরবরাহ না করা হয় তবে এটি ঠিকানা থেকে অনুমান করা হবে। সেরা পারফরম্যান্সের জন্য, অঞ্চল কোডটি যদি আপনি এটি জানেন তবে এটি অন্তর্ভুক্ত করার পরামর্শ দেওয়া হচ্ছে। অসঙ্গতিপূর্ণ বা পুনরাবৃত্তি অঞ্চলগুলি থাকার ফলে দুর্বল পারফরম্যান্স হতে পারে, উদাহরণস্বরূপ, যদি |
languageCode | ইনপুট ঠিকানায় ভাষা কোডটি ভবিষ্যতের ব্যবহারের জন্য সংরক্ষিত এবং আজ উপেক্ষা করা হয়। এপিআই ঠিকানাটি যেখানে রয়েছে তার উপযুক্ত ভাষায় ঠিকানাটি ফেরত দেয়। |
postalCode | ঐচ্ছিক। ঠিকানা ডাক কোড। সমস্ত দেশ পোস্টের কোডগুলি উপস্থিত থাকার জন্য ব্যবহার করে না বা প্রয়োজন হয় না, তবে যেখানে সেগুলি ব্যবহৃত হয়, তারা ঠিকানার অন্যান্য অংশগুলির সাথে অতিরিক্ত বৈধতা ট্রিগার করতে পারে (যেমন মার্কিন যুক্তরাষ্ট্রে রাষ্ট্র/জিপ বৈধতা)। |
sortingCode | ঐচ্ছিক। অতিরিক্ত, দেশ-নির্দিষ্ট, বাছাই কোড। এটি বেশিরভাগ অঞ্চলে ব্যবহৃত হয় না। যেখানে এটি ব্যবহৃত হয়, মানটি হয় হয় "সিডেক্স" এর মতো স্ট্রিং, ally চ্ছিকভাবে একটি সংখ্যা (যেমন "সিডেক্স 7") অনুসরণ করে, বা কেবলমাত্র একটি সংখ্যা, "সেক্টর কোড" (জামাইকা) উপস্থাপন করে, "ডেলিভারি অঞ্চল সূচক" উপস্থাপন করে " (মালাউই) বা "পোস্ট অফিস সূচক" (যেমন কোট ডি'ভায়ার)। |
administrativeArea | ঐচ্ছিক। সর্বোচ্চ প্রশাসনিক মহকুমা যা কোনও দেশ বা অঞ্চলের ডাক ঠিকানাগুলির জন্য ব্যবহৃত হয়। উদাহরণস্বরূপ, এটি একটি রাষ্ট্র, একটি প্রদেশ, একটি ওব্লাস্ট বা প্রদেশ হতে পারে। বিশেষত, স্পেনের জন্য এটি প্রদেশ এবং স্বায়ত্তশাসিত সম্প্রদায় নয় (যেমন "বার্সেলোনা" এবং "ক্যাটালোনিয়া" নয়)। অনেক দেশ ডাক ঠিকানাগুলিতে প্রশাসনিক অঞ্চল ব্যবহার করে না। যেমন সুইজারল্যান্ডে এটি অপ্রিয় থাকা উচিত। |
locality | ঐচ্ছিক। সাধারণত ঠিকানার শহর/শহরের অংশকে বোঝায়। উদাহরণ: ইউএস সিটি, আইটি কমুন, ইউকে পোস্ট টাউন। বিশ্বের অঞ্চলগুলিতে যেখানে অঞ্চলগুলি ভালভাবে সংজ্ঞায়িত হয় না বা এই কাঠামোর সাথে ভাল ফিট করে না, লোকেশনটি খালি ছেড়ে দিন এবং ঠিকানা লাইনগুলি ব্যবহার করুন। |
sublocality | ঐচ্ছিক। ঠিকানার sublocaly। উদাহরণস্বরূপ, এটি পাড়া, বরো, জেলা হতে পারে। |
addressLines[] | প্রয়োজন। কোনও ঠিকানার নিম্ন স্তরের বর্ণনা করে অরক্ষিত ঠিকানা লাইনগুলি। |
recipients[] | দয়া করে এই ক্ষেত্রটি সেট করা এড়িয়ে চলুন। ঠিকানা বৈধতা এপিআই বর্তমানে এটি ব্যবহার করে না। যদিও এই মুহুর্তে এপিআই এই ক্ষেত্রের সেট দিয়ে অনুরোধগুলি প্রত্যাখ্যান করবে না, তথ্যটি বাতিল করা হবে এবং প্রতিক্রিয়াতে ফিরে আসবে না। |
organization | দয়া করে এই ক্ষেত্রটি সেট করা এড়িয়ে চলুন। ঠিকানা বৈধতা এপিআই বর্তমানে এটি ব্যবহার করে না। যদিও এই মুহুর্তে এপিআই এই ক্ষেত্রের সেট দিয়ে অনুরোধগুলি প্রত্যাখ্যান করবে না, তথ্যটি বাতিল করা হবে এবং প্রতিক্রিয়াতে ফিরে আসবে না। |
ভাষাগত
পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রাক-জিএ) এ রয়েছে। প্রাক-জিএ পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-জিএ পণ্যগুলিতে পরিবর্তন এবং বৈশিষ্ট্যগুলি অন্যান্য প্রাক-জিএ সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-জিএ অফারগুলি গুগল ম্যাপস প্ল্যাটফর্ম পরিষেবা নির্দিষ্ট শর্তাদি দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।
প্রতিক্রিয়াতে অতিরিক্ত তথ্য অন্তর্ভুক্ত করতে ঠিকানা বৈধতা এপিআই সক্ষম করে।
JSON প্রতিনিধিত্ব |
---|
{ "returnEnglishLatinAddress": boolean } |
ক্ষেত্র | |
---|---|
returnEnglishLatinAddress | পূর্বরূপ: একটি |
যাচাইকরণের ফলাফল
একটি ঠিকানা বৈধ করার ফলাফল।
JSON প্রতিনিধিত্ব |
---|
{ "verdict": { object ( |
ক্ষেত্র | |
---|---|
verdict | সামগ্রিক রায় পতাকা |
address | জিওকোডের বিরোধী হিসাবে ঠিকানা সম্পর্কে তথ্য। |
geocode | ঠিকানাটি জিওকোড করা অবস্থান এবং স্থান সম্পর্কে তথ্য। |
metadata | বিতরণযোগ্যতার সাথে সম্পর্কিত অন্যান্য তথ্য। ঠিকানা বৈধতা এপিআইতে প্রেরিত প্রতিটি ঠিকানার জন্য |
uspsData | ইউএসপিএস দ্বারা সরবরাহিত অতিরিক্ত বিতরণযোগ্য পতাকা। কেবলমাত্র |
englishLatinAddress | পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রাক-জিএ) এ রয়েছে। প্রাক-জিএ পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-জিএ পণ্যগুলিতে পরিবর্তন এবং বৈশিষ্ট্যগুলি অন্যান্য প্রাক-জিএ সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-জিএ অফারগুলি গুগল ম্যাপস প্ল্যাটফর্ম পরিষেবা নির্দিষ্ট শর্তাদি দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন। ঠিকানাটি ইংরেজিতে অনুবাদ করা হয়েছে। অনুবাদকৃত ঠিকানাগুলি এপিআই ইনপুট হিসাবে পুনরায় ব্যবহারযোগ্য নয়। পরিষেবাটি তাদের সরবরাহ করে যাতে ব্যবহারকারী তাদের স্থানীয় ভাষা ব্যবহার করতে পারে যা মূলত সরবরাহিত ঠিকানার বৈধতা নিশ্চিত করতে বা অস্বীকার করতে পারে। যদি ঠিকানার কিছু অংশে কোনও ইংরেজি অনুবাদ না থাকে তবে পরিষেবাটি সেই অংশটি একটি বিকল্প ভাষায় ফিরিয়ে দেয় যা লাতিন স্ক্রিপ্ট ব্যবহার করে। বিকল্প ভাষা কীভাবে নির্বাচন করা হয় তার একটি ব্যাখ্যার জন্য এখানে দেখুন। যদি ঠিকানার কিছু অংশে কোনও ভাষায় কোনও অনুবাদ বা অনুবাদ না থাকে যা কোনও ল্যাটিন স্ক্রিপ্ট ব্যবহার করে তবে পরিষেবাটি ঠিকানাটির সাথে যুক্ত স্থানীয় ভাষায় সেই অংশটি ফিরিয়ে দেয়। দ্রষ্টব্য: |
রায়
ঠিকানা বৈধতা ফলাফল এবং জিওকোডের উচ্চ স্তরের ওভারভিউ।
JSON প্রতিনিধিত্ব |
---|
{ "inputGranularity": enum ( |
ক্ষেত্র | |
---|---|
inputGranularity | ইনপুট ঠিকানার গ্রানুলারিটি। এটি ইনপুট ঠিকানাটি পার্স করার ফলাফল এবং কোনও বৈধতা সংকেত দেয় না। বৈধতা সংকেতগুলির জন্য, নীচে উদাহরণস্বরূপ, যদি ইনপুট ঠিকানাটিতে একটি নির্দিষ্ট অ্যাপার্টমেন্ট নম্বর অন্তর্ভুক্ত থাকে তবে এখানে |
validationGranularity | গ্রানুলারিটি স্তর যা এপিআই ঠিকানাটিকে পুরোপুরি বৈধ করতে পারে। উদাহরণস্বরূপ, প্রতি ঠিকানা উপাদান বৈধকরণের ফলাফল |
geocodeGranularity | এটি মাঝে মাঝে উপরের |
addressComplete | যদি কোনও অমীমাংসিত টোকেন না থাকে, অপ্রত্যাশিত বা অনুপস্থিত ঠিকানা উপাদান না থাকে তবে ঠিকানাটি সম্পূর্ণ বিবেচনা করা হয়। যদি আনসেট হয় তবে নির্দেশ করে যে মানটি |
hasUnconfirmedComponents | কমপক্ষে একটি ঠিকানার উপাদানটি শ্রেণিবদ্ধ বা বৈধ করা যায় না, |
hasInferredComponents | কমপক্ষে একটি ঠিকানার উপাদানটি অনুমান করা হয়েছিল (যুক্ত) যা ইনপুটটিতে ছিল না, |
hasReplacedComponents | কমপক্ষে একটি ঠিকানার উপাদানটি প্রতিস্থাপন করা হয়েছিল, |
গ্রানুলারিটি
একটি ঠিকানা বা জিওকোড যে বিভিন্ন গ্রানুলারিটি থাকতে পারে। যখন কোনও ঠিকানার জন্য গ্রানুলারিটি নির্দেশ করতে ব্যবহৃত হয়, এই মানগুলি ঠিকানাটি কোনও মেইলিং গন্তব্য সনাক্ত করে এমন একটি গ্রানুলারিটি কতটা সূক্ষ্মতার সাথে নির্দেশ করে। উদাহরণস্বরূপ, "123 মেইন স্ট্রিট, রেডউড সিটি, সিএ, 94061" এর মতো একটি ঠিকানা একটি PREMISE
চিহ্নিত করে যখন "রেডউড সিটি, সিএ, 94061" এর মতো কিছু একটি LOCALITY
চিহ্নিত করে। তবে, যদি আমরা রেডউড সিটিতে "123 মেইন স্ট্রিট" এর জন্য কোনও জিওকোড খুঁজে পেতে অক্ষম হই তবে ঠিকানাটি আরও দানাদার হলেও জিওকোডটি LOCALITY
গ্রানুলারিটির হতে পারে।
Enums | |
---|---|
GRANULARITY_UNSPECIFIED | ডিফল্ট মান। এই মান অব্যবহৃত। |
SUB_PREMISE | নীচে-বিল্ডিং স্তরের ফলাফল যেমন একটি অ্যাপার্টমেন্ট। |
PREMISE | বিল্ডিং-স্তরের ফলাফল। |
PREMISE_PROXIMITY | একটি জিওকোড যা ঠিকানার বিল্ডিং-স্তরের অবস্থানের কাছাকাছি। |
BLOCK | ঠিকানা বা জিওকোড একটি ব্লক নির্দেশ করে। কেবল জাপানের মতো ব্লক-লেভেল অ্যাড্রেসিং রয়েছে এমন অঞ্চলে ব্যবহৃত। |
ROUTE | জিওকোড বা ঠিকানাটি রুটে দানাদার, যেমন রাস্তা, রাস্তা বা মহাসড়ক। |
OTHER | অন্যান্য সমস্ত গ্রানুলারিটিগুলি, যা একসাথে বালতি করা হয় যেহেতু তারা বিতরণযোগ্য নয়। |
ঠিকানা
পোস্ট-প্রক্রিয়াজাত ঠিকানার বিশদ। পোস্ট-প্রসেসিংয়ের মধ্যে ঠিকানাটির ভুল বানানযুক্ত অংশগুলি সংশোধন করা, ভুল অংশগুলি প্রতিস্থাপন করা এবং অনুপস্থিত অংশগুলি অনুমান করা অন্তর্ভুক্ত।
JSON প্রতিনিধিত্ব |
---|
{ "formattedAddress": string, "postalAddress": { object ( |
ক্ষেত্র | |
---|---|
formattedAddress | পোস্ট-প্রক্রিয়াজাত ঠিকানা, ঠিকানাটি যেখানে অবস্থিত সেই অঞ্চলের ঠিকানা বিন্যাসের নিয়ম অনুসরণ করে একক-লাইন ঠিকানা হিসাবে ফর্ম্যাট করা। |
postalAddress | পোস্ট-প্রক্রিয়াজাত ঠিকানা একটি ডাক ঠিকানা হিসাবে প্রতিনিধিত্ব করে। |
addressComponents[] | Unordered তালিকা। বৈধতা সম্পর্কিত তথ্যের সাথে ফর্ম্যাট এবং সংশোধিত ঠিকানার পৃথক ঠিকানা উপাদানগুলি। এটি পৃথক উপাদানগুলির বৈধতা স্থিতির তথ্য সরবরাহ করে। ঠিকানা উপাদানগুলি একটি নির্দিষ্ট উপায়ে অর্ডার করা হয় না। তালিকার ঠিকানা উপাদানগুলির ক্রম সম্পর্কে কোনও অনুমান করবেন না। |
missingComponentTypes[] | যে ধরণের উপাদানগুলি সঠিকভাবে ফর্ম্যাট করা মেলিং ঠিকানায় উপস্থিত থাকবে বলে আশা করা হয়েছিল তবে ইনপুটটিতে পাওয়া যায় নি এবং এটি অনুমান করা যায়নি। এই ধরণের উপাদানগুলি |
unconfirmedComponentTypes[] | |
unresolvedTokens[] | ইনপুটটিতে কোনও টোকেন যা সমাধান করা যায়নি। এটি এমন একটি ইনপুট হতে পারে যা কোনও ঠিকানার বৈধ অংশ হিসাবে স্বীকৃত ছিল না (উদাহরণস্বরূপ "123235253253 মেইন এসটি, সান ফ্রান্সিসকো, সিএ, 94105" এর মতো ইনপুটটিতে, অমীমাংসিত টোকেনগুলি |
অ্যাড্রেস কমপোনেন্ট
রাস্তা, শহর বা রাষ্ট্রের মতো কোনও ঠিকানা উপাদান উপস্থাপন করে।
JSON প্রতিনিধিত্ব |
---|
{ "componentName": { object ( |
ক্ষেত্র | |
---|---|
componentName | এই উপাদানটির জন্য নাম। |
componentType | ঠিকানা উপাদানটির ধরণ। সারণী 2 দেখুন: সম্ভাব্য ধরণের তালিকার জন্য স্থান পরিষেবা দ্বারা ফিরে অতিরিক্ত প্রকারগুলি । |
confirmationLevel | আমাদের কাছে নিশ্চিততার স্তরটি নির্দেশ করে যে আমাদের রয়েছে যে উপাদানটি সঠিক। |
inferred | ইঙ্গিত দেয় যে উপাদানটি ইনপুটটির অংশ ছিল না, তবে আমরা এটি ঠিকানা অবস্থানের জন্য অনুমান করেছি এবং বিশ্বাস করি এটি একটি সম্পূর্ণ ঠিকানার জন্য সরবরাহ করা উচিত। |
spellCorrected | উপাদানটির নামের একটি ভুল বানান সংশোধন নির্দেশ করে। এপিআই সর্বদা একটি বানান বৈকল্পিক থেকে অন্য বানান পরিবর্তনের পতাকা দেয় না, যেমন "কেন্দ্র" পরিবর্তন করার সময় "কেন্দ্রে"। এটি সর্বদা সাধারণ ভুল বানানগুলিও পতাকাঙ্কিত করে না, যেমন "অ্যাম্ফিথিয়েটার পিকেডব্লিউওয়াই" পরিবর্তন করার সময় "অ্যাম্ফিথিয়েটার পিকেডব্লিউওয়াই" তে। |
replaced | নির্দেশ করে যে উপাদানটির নামটি সম্পূর্ণ আলাদা একটি দিয়ে প্রতিস্থাপন করা হয়েছিল, উদাহরণস্বরূপ একটি ভুল ডাক কোডটি ঠিকানার জন্য সঠিক একটি দিয়ে প্রতিস্থাপন করা হচ্ছে। এটি কোনও প্রসাধনী পরিবর্তন নয়, ইনপুট উপাদানটি অন্যটিতে পরিবর্তন করা হয়েছে। |
unexpected | একটি ঠিকানা উপাদান নির্দেশ করে যা প্রদত্ত অঞ্চলের জন্য কোনও ডাক ঠিকানায় উপস্থিত থাকার আশা করা যায় না। আমরা কেবল এটি ধরে রেখেছি কারণ এটি ইনপুটটির অংশ ছিল। |
উপাদানের নাম
উপাদানটির নামের জন্য একটি মোড়ক।
JSON প্রতিনিধিত্ব |
---|
{ "text": string, "languageCode": string } |
ক্ষেত্র | |
---|---|
text | নাম পাঠ্য। উদাহরণস্বরূপ, রাস্তার নামের জন্য "5 তম অ্যাভিনিউ" বা রাস্তার সংখ্যার জন্য "1253"। |
languageCode | বিসিপি -47 ভাষা কোড। যদি উপাদানটির নাম কোনও ভাষার সাথে যেমন কোনও রাস্তার নম্বর সম্পর্কিত না হয় তবে এটি উপস্থিত হবে না। |
নিশ্চিতকরণ লেভেল
নিশ্চিতকরণ স্তরের জন্য বিভিন্ন সম্ভাব্য মান।
Enums | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED | ডিফল্ট মান। এই মান অব্যবহৃত। |
CONFIRMED | আমরা যাচাই করতে সক্ষম হয়েছি যে এই উপাদানটি বিদ্যমান রয়েছে এবং বাকী ঠিকানার প্রসঙ্গে অর্থবোধ করে। |
UNCONFIRMED_BUT_PLAUSIBLE | এই উপাদানটি নিশ্চিত করা যায়নি, তবে এটি বিদ্যমান তা প্রশংসনীয়। উদাহরণস্বরূপ, একটি রাস্তায় যেখানে নির্দিষ্ট বাড়ির নম্বরগুলি জানা যায় না সেখানে একটি পরিচিত বৈধ পরিসরের মধ্যে একটি রাস্তার সংখ্যা। |
UNCONFIRMED_AND_SUSPICIOUS | এই উপাদানটি নিশ্চিত হয়নি এবং সম্ভবত এটি ভুল হতে পারে। উদাহরণস্বরূপ, এমন একটি পাড়া যা বাকী ঠিকানার সাথে খাপ খায় না। |
জিওকোড
ইনপুটটি জিওকোড করা হয়েছিল সেই জায়গা সম্পর্কে তথ্য রয়েছে।
JSON প্রতিনিধিত্ব |
---|
{ "location": { object ( |
ক্ষেত্র | |
---|---|
location | ইনপুট জিওকোডেড অবস্থান। ঠিকানা, অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক বা প্লাস কোডগুলি ব্যবহার করে প্লেস আইডি ব্যবহার করা পছন্দ করা হয়। রাউটিং বা ড্রাইভিংয়ের দিকনির্দেশগুলি গণনা করার সময় স্থানাঙ্কগুলি ব্যবহার করার ফলে সর্বদা সেই স্থানাঙ্কগুলির নিকটতম রাস্তায় বিন্দুটি ছড়িয়ে পড়ে। এটি এমন কোনও রাস্তা নাও হতে পারে যা দ্রুত বা নিরাপদে গন্তব্যে নিয়ে যাবে এবং সম্পত্তির অ্যাক্সেস পয়েন্টের কাছাকাছি নাও হতে পারে। অতিরিক্তভাবে, যখন কোনও অবস্থান বিপরীত জিওকোড করা হয়, তখন ফিরে আসা ঠিকানাটি মূলটির সাথে মেলে এমন কোনও গ্যারান্টি নেই। |
plusCode | |
bounds | জিওকোডেড জায়গার সীমা। |
featureSizeMeters | মিটারে জিওকোডযুক্ত জায়গার আকার। এটি জিওকোডেড অবস্থানের মোটামুটিতার আরেকটি পরিমাপ, তবে শব্দার্থক অর্থের চেয়ে শারীরিক আকারে। |
placeId | এই ইনপুটটি জিওকোডগুলিতে স্থানটি স্থান দেয়। স্থান আইডি সম্পর্কে আরও তথ্যের জন্য এখানে দেখুন। |
placeTypes[] | ইনপুট জিওকোডে যে জায়গা (গুলি)। উদাহরণস্বরূপ, |
LatLng
একটি অবজেক্ট যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড় উপস্থাপন করে। এটি ডিগ্রি অক্ষাংশ এবং ডিগ্রি দ্রাঘিমাংশের প্রতিনিধিত্ব করার জন্য ডাবলগুলির একটি জুড়ি হিসাবে প্রকাশ করা হয়। অন্যথায় নির্দিষ্ট না করা হলে, এই অবজেক্টটি অবশ্যই ডাব্লুজিএস 84 স্ট্যান্ডার্ডের সাথে সামঞ্জস্য করতে হবে। মানগুলি অবশ্যই স্বাভাবিক রেঞ্জের মধ্যে থাকতে হবে।
JSON প্রতিনিধিত্ব |
---|
{ "latitude": number, "longitude": number } |
ক্ষেত্র | |
---|---|
latitude | ডিগ্রিতে অক্ষাংশ। এটি অবশ্যই [-90.0, +90.0] এর মধ্যে থাকতে হবে। |
longitude | ডিগ্রিতে দ্রাঘিমাংশ। এটি অবশ্যই [-180.0, +180.0] এর মধ্যে থাকতে হবে। |
প্লাসকোড
প্লাস কোড ( http://plus.codes ) দুটি ফর্ম্যাট সহ একটি অবস্থানের রেফারেন্স: গ্লোবাল কোড একটি 14MX14M (একটি ডিগ্রির 1/8000 তম) বা আরও ছোট আয়তক্ষেত্র এবং যৌগিক কোড সংজ্ঞায়িত করে, উপসর্গটিকে একটি রেফারেন্স অবস্থানের সাথে প্রতিস্থাপন করে।
JSON প্রতিনিধিত্ব |
---|
{ "globalCode": string, "compoundCode": string } |
ক্ষেত্র | |
---|---|
globalCode | প্লেসের গ্লোবাল (পূর্ণ) কোড, যেমন "9FWM33GV+এইচকিউ", 1/8000 ডিগ্রি অঞ্চল (~ 14 বাই 14 মিটার) দ্বারা 1/8000 উপস্থাপন করে। |
compoundCode | প্লেসের যৌগিক কোড, যেমন "33GV+সদর দফতর, রামবার্গ, নরওয়ে", গ্লোবাল কোডের প্রত্যয়যুক্ত এবং উপসর্গটিকে একটি রেফারেন্স সত্তার ফর্ম্যাট নামের সাথে প্রতিস্থাপন করে। |
ভিউপোর্ট
একটি অক্ষাংশ-দৃ und ়তা ভিউপোর্ট, দুটি তির্যকভাবে low
এবং high
পয়েন্ট হিসাবে প্রতিনিধিত্ব করে। একটি ভিউপোর্টকে একটি বদ্ধ অঞ্চল হিসাবে বিবেচনা করা হয়, অর্থাত্ এটি এর সীমানা অন্তর্ভুক্ত করে। অক্ষাংশের সীমাগুলি অবশ্যই অন্তর্ভুক্ত থাকতে হবে -90 থেকে 90 ডিগ্রি অন্তর্ভুক্ত এবং দ্রাঘিমাংশের সীমা অবশ্যই -180 থেকে 180 ডিগ্রি অন্তর্ভুক্ত থাকতে হবে। বিভিন্ন ক্ষেত্রে অন্তর্ভুক্ত:
যদি
low
=high
তবে ভিউপোর্টটি সেই একক পয়েন্ট নিয়ে গঠিত।যদি
low.longitude
>high.longitude
, দ্রাঘিমাংশের পরিসীমা উল্টানো হয় (ভিউপোর্টটি 180 ডিগ্রি দ্রাঘিমাংশ লাইনটি অতিক্রম করে)।যদি
low.longitude
high.longitude
high.longitude
low.longitude
।যদি
low.latitude
high.latitude
low
এবং high
উভয়ই অবশ্যই পপুলেট করতে হবে এবং প্রতিনিধিত্ব করা বাক্সটি খালি থাকতে পারে না (উপরের সংজ্ঞাগুলি দ্বারা নির্দিষ্ট হিসাবে)। একটি খালি ভিউপোর্টের ফলে একটি ত্রুটি হবে।
উদাহরণস্বরূপ, এই ভিউপোর্টটি পুরোপুরি নিউ ইয়র্ক সিটিকে ঘিরে রেখেছে:
{"নিম্ন": {"অক্ষাংশ": 40.477398, "দ্রাঘিমাংশ": -74.259087}, "উচ্চ": {"অক্ষাংশ": 40.91618, "দ্রাঘিমাংশ": -73.70018}}}}
JSON প্রতিনিধিত্ব |
---|
{ "low": { object ( |
ক্ষেত্র | |
---|---|
low | প্রয়োজন। ভিউপোর্টের নিম্ন পয়েন্ট। |
high | প্রয়োজন। ভিউপোর্টের উচ্চ পয়েন্ট। |
অ্যাড্রেসমেটাটাটা
ঠিকানার জন্য মেটাডেটা। ঠিকানা বৈধতা এপিআইতে প্রেরিত প্রতিটি ঠিকানার জন্য metadata
সম্পূর্ণরূপে পপুলেশন হওয়ার গ্যারান্টিযুক্ত নয়।
JSON প্রতিনিধিত্ব |
---|
{ "business": boolean, "poBox": boolean, "residential": boolean } |
ক্ষেত্র | |
---|---|
business | ইঙ্গিত দেয় যে এটি একটি ব্যবসায়ের ঠিকানা। যদি আনসেট হয় তবে নির্দেশ করে যে মানটি অজানা। |
poBox | ইঙ্গিত করে যে একটি পিও বক্সের ঠিকানা। যদি আনসেট হয় তবে নির্দেশ করে যে মানটি অজানা। |
residential | ইঙ্গিত দেয় যে এটি একটি আবাসনের ঠিকানা। যদি আনসেট হয় তবে নির্দেশ করে যে মানটি অজানা। |
ইউএসপিএসডাটা
ঠিকানার জন্য ইউএসপিএস ডেটা। uspsData
প্রতিটি মার্কিন বা ঠিকানা বৈধতা এপিআইতে প্রেরিত পিআর ঠিকানার জন্য সম্পূর্ণরূপে পপুলেশন হওয়ার গ্যারান্টিযুক্ত নয়। আপনি যদি ইউএসপিএসডেটাকে প্রতিক্রিয়ার প্রাথমিক অংশ হিসাবে ব্যবহার করেন তবে প্রতিক্রিয়াতে ব্যাকআপ ঠিকানা ক্ষেত্রগুলিকে সংহত করার পরামর্শ দেওয়া হচ্ছে।
JSON প্রতিনিধিত্ব |
---|
{
"standardizedAddress": {
object ( |
ক্ষেত্র | |
---|---|
standardizedAddress | ইউএসপিএস মানক ঠিকানা। |
deliveryPointCode | 2 ডিজিট ডেলিভারি পয়েন্ট কোড |
deliveryPointCheckDigit | ডেলিভারি পয়েন্ট চেক ডিজিট। এই সংখ্যাটি যান্ত্রিকভাবে স্ক্যান করা মেলের জন্য ডেলিভারি_পয়েন্ট_বারকোডের শেষে যুক্ত করা হয়েছে। ডেলিভারি_পয়েন্ট_বারকোড, ডেলিভারি পয়েন্টচেকডিজিট, ডাক কোড এবং জিপ+4 একসাথে সমস্ত অঙ্ক যুক্ত করা 10 দ্বারা বিভাজ্য একটি সংখ্যা অর্জন করা উচিত। |
dpvConfirmation | ডিপিভি নিশ্চিতকরণের জন্য সম্ভাব্য মানগুলি। একটি একক চরিত্র প্রদান করে বা কোনও মান দেয় না।
|
dpvFootnote | ডেলিভারি পয়েন্ট বৈধতা থেকে পাদটীকা। একাধিক পাদটীকা একই স্ট্রিংয়ে একসাথে স্ট্রিং হতে পারে।
|
dpvCmra | ঠিকানাটি কোনও সিএমআরএ (বাণিজ্যিক মেল গ্রহণকারী সংস্থা)-ক্লায়েন্টদের জন্য মেল গ্রহণকারী একটি ব্যক্তিগত ব্যবসা। একটি একক চরিত্র প্রদান।
|
dpvVacant | এই জায়গাটি কি শূন্য? একটি একক চরিত্র প্রদান।
|
dpvNoStat | এটি কি কোনও স্ট্যাট ঠিকানা বা সক্রিয় ঠিকানা? কোনও স্ট্যাট ঠিকানাগুলি এমন নয় যা অবিচ্ছিন্নভাবে দখল করা হয় না বা এমন ঠিকানা যা ইউএসপিগুলি পরিষেবা দেয় না। একটি একক চরিত্র প্রদান।
|
dpvNoStatReasonCode | নস্ট্যাট প্রকার নির্দেশ করে। ইন্ট হিসাবে একটি কারণ কোড প্রদান করে।
|
dpvDrop | পতাকা নির্দেশ করে মেইল কোনও সাইটে একক গ্রহণযোগ্যতে সরবরাহ করা হয়। একটি একক চরিত্র প্রদান।
|
dpvThrowback | ইঙ্গিত দেয় যে মেইল রাস্তার ঠিকানায় সরবরাহ করা হয়নি। একটি একক চরিত্র প্রদান।
|
dpvNonDeliveryDays | পতাকা নির্দেশ করে যে মেল ডেলিভারি সপ্তাহের প্রতিটি দিন সঞ্চালিত হয় না। একটি একক চরিত্র প্রদান।
|
dpvNonDeliveryDaysValues | পূর্ণসংখ্যা অ-বিতরণ দিনগুলি সনাক্তকরণ। এটি বিট ফ্ল্যাগগুলি ব্যবহার করে জিজ্ঞাসাবাদ করা যেতে পারে: 0x40-রবিবার একটি ডেলিভারি ডে 0x20-সোমবার একটি ডেলিভারি দিন 0x10-মঙ্গলবার একটি ডেলিভারি ডে 0x08-বুধবার একটি ডেলিভারি ডে 0x04-বৃহস্পতিবার একটি নন নন-ডেলিভারি দিন 0 -ডেলিভারি দিন 0x02-শুক্রবার একটি ডেলিভারি ডে 0x01-শনিবার একটি ডেলিভারি দিন |
dpvNoSecureLocation | পতাকা নির্দেশ করে যে দরজাটি অ্যাক্সেসযোগ্য, তবে সুরক্ষা উদ্বেগের কারণে প্যাকেজটি ছেড়ে যাবে না। একটি একক চরিত্র প্রদান।
|
dpvPbsa | ইঙ্গিত দেয় যে ঠিকানাটি পিবিএসএ রেকর্ডের সাথে মিলেছে। একটি একক চরিত্র প্রদান।
|
dpvDoorNotAccessible | পতাকা ঠিকানাগুলি নির্দেশ করে যেখানে ইউএসপিগুলি মেল সরবরাহের জন্য কোনও দরজায় কড়া নাড়তে পারে না। একটি একক চরিত্র প্রদান।
|
dpvEnhancedDeliveryCode | ইঙ্গিত করে যে একাধিক ডিপিভি রিটার্ন কোড ঠিকানার জন্য বৈধ। একটি একক চরিত্র প্রদান।
|
carrierRoute | ক্যারিয়ার রুট কোড। একটি চিঠি উপসর্গ এবং একটি তিন অঙ্কের রুট ডিজাইনার সমন্বিত একটি চারটি চরিত্রের কোড। উপসর্গ:
|
carrierRouteIndicator | ক্যারিয়ার রুট রেট বাছাই সূচক। |
ewsNoMatch | বিতরণ ঠিকানাটি মিলযোগ্য, তবে EWS ফাইলটি ইঙ্গিত দেয় যে শীঘ্রই একটি সঠিক মিল পাওয়া যাবে। |
postOfficeCity | প্রধান পোস্ট অফিস শহর। |
postOfficeState | প্রধান পোস্ট অফিস রাজ্য। |
abbreviatedCity | সংক্ষিপ্ত শহর। |
fipsCountyCode | ফিপস কাউন্টি কোড। |
county | কাউন্টির নাম। |
elotNumber | ভ্রমণের বর্ধিত লাইন (এলট) নম্বর। |
elotFlag | এলট আরোহী/অবতরণ পতাকা (এ/ডি)। |
lacsLinkReturnCode | Lacslink রিটার্ন কোড। |
lacsLinkIndicator | Lacslink সূচক। |
poBoxOnlyPostalCode | পিও বক্স কেবল ডাক কোড। |
suitelinkFootnote | কোনও রাস্তার বা উচ্চতর রেকর্ডের সাথে সম্পর্কিত তথ্য স্যুইট করার জন্য পাদটীকাগুলি। যদি ব্যবসায়ের নাম ম্যাচটি পাওয়া যায় তবে মাধ্যমিক নম্বরটি ফিরে আসে।
|
pmbDesignator | পিএমবি (প্রাইভেট মেল বক্স) ইউনিট ডিজাইনার। |
pmbNumber | পিএমবি (প্রাইভেট মেল বক্স) নম্বর; |
addressRecordType | ইনপুট ঠিকানার সাথে মেলে ঠিকানা রেকর্ডের ধরণ।
|
defaultAddress | সূচক যে একটি ডিফল্ট ঠিকানা পাওয়া গেছে, তবে আরও নির্দিষ্ট ঠিকানা বিদ্যমান। |
errorMessage | ইউএসপিএস ডেটা পুনরুদ্ধারের জন্য ত্রুটি বার্তা। কৃত্রিমভাবে তৈরি ঠিকানাগুলি সনাক্তকরণের কারণে ইউএসপিএস প্রসেসিং স্থগিত করা হলে এটি পপুলেট হয়। এই ত্রুটি উপস্থিত থাকলে ইউএসপিএস ডেটা ক্ষেত্রগুলি পপুলেশন নাও হতে পারে। |
cassProcessed | সূচক যে অনুরোধটি ক্যাস প্রক্রিয়াজাত করা হয়েছে। |
ইউএসপিএসএড্রেস
ইউএসপিএস একটি মার্কিন ঠিকানার প্রতিনিধিত্ব।
JSON প্রতিনিধিত্ব |
---|
{ "firstAddressLine": string, "firm": string, "secondAddressLine": string, "urbanization": string, "cityStateZipAddressLine": string, "city": string, "state": string, "zipCode": string, "zipCodeExtension": string } |
ক্ষেত্র | |
---|---|
firstAddressLine | প্রথম ঠিকানা লাইন। |
firm | দৃ firm ় নাম। |
secondAddressLine | দ্বিতীয় ঠিকানা লাইন। |
urbanization | পুয়ের্তো রিকান নগরায়ণের নাম। |
cityStateZipAddressLine | শহর + রাজ্য + ডাক কোড। |
city | শহরের নাম। |
state | 2 লেটার স্টেট কোড। |
zipCode | ডাক কোড ইজি 10009। |
zipCodeExtension | 4-অঙ্কের ডাক কোড এক্সটেনশন ইজি 5023। |