জিওকোডিং রাখুন

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ডেভেলপাররা

স্থান জিওকোডিং আপনাকে স্থান আইডি থেকে একটি ঠিকানা পুনরুদ্ধার করতে দেয়।

প্লেস আইডিগুলি গুগল প্লেস ডাটাবেস এবং গুগল ম্যাপে একটি স্থানকে অনন্যভাবে শনাক্ত করে। কোনও ঠিকানা জিওকোড করার সময় প্লেস আইডিগুলি পুনরুদ্ধার করুন। আপনি প্লেস ডিটেইলস (নতুন) , টেক্সট সার্চ (নতুন) এবং কাছাকাছি সার্চ (নতুন) এর মতো অনেক অন্যান্য API থেকেও একটি প্লেস আইডি পুনরুদ্ধার করতে পারেন।

জিওকোডিং অনুরোধগুলি রাখুন

একটি স্থানের জিওকোডিং অনুরোধ হল একটি HTTP GET অনুরোধ যা এই আকারে থাকে:

https://geocode.googleapis.com/v4beta/geocode/places/PLACE_ID

যেখানে PLACE_ID আগ্রহের স্থানের স্থান আইডি থাকে।

GET অনুরোধের অংশ হিসেবে অন্যান্য সমস্ত প্যারামিটার URL প্যারামিটার হিসেবে অথবা API কী বা ফিল্ড মাস্কের মতো প্যারামিটারের জন্য হেডারে পাস করুন। উদাহরণস্বরূপ:

https://geocode.googleapis.com/v4beta/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?key=API_KEY

অথবা একটি কার্ল কমান্ডে:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
"https://geocode.googleapis.com/v4beta/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw"

অনুরোধ করতে OAuth ব্যবহার করুন

Geocoding API v4 প্রমাণীকরণের জন্য OAuth 2.0 সমর্থন করে। Geocoding API-এর সাথে OAuth ব্যবহার করার জন্য, OAuth টোকেনটিকে সঠিক স্কোপ বরাদ্দ করতে হবে। Geocoding API স্থান জিওকোডিংয়ের সাথে ব্যবহারের জন্য নিম্নলিখিত স্কোপগুলিকে সমর্থন করে:

  • https://www.googleapis.com/auth/maps-platform.geocode — সকল জিওকোডিং API এন্ডপয়েন্টের সাথে ব্যবহার করুন।
  • https://www.googleapis.com/auth/maps-platform.geocode.place — স্থানের জিওকোডিংয়ের জন্য শুধুমাত্র GeocodePlace এর সাথে ব্যবহার করুন।

এছাড়াও, আপনি সমস্ত জিওকোডিং এপিআই এন্ডপয়েন্টের জন্য সাধারণ https://www.googleapis.com/auth/cloud-platform স্কোপ ব্যবহার করতে পারেন। এই স্কোপটি ডেভেলপমেন্টের সময় কার্যকর, কিন্তু উৎপাদনের সময় নয়, কারণ এটি একটি সাধারণ স্কোপ যা সমস্ত এন্ডপয়েন্টে অ্যাক্সেসের অনুমতি দেয়।

আরও তথ্য এবং উদাহরণের জন্য, OAuth ব্যবহার দেখুন।

স্থানের জিওকোডিং প্রতিক্রিয়া

প্লেস জিওকোডিং একটি GeocodeResult অবজেক্ট ফেরত দেয় যা প্লেস আইডির সাথে সম্পর্কিত স্থানটিকে প্রতিনিধিত্ব করে।

সম্পূর্ণ JSON অবজেক্টটি এই আকারে রয়েছে:

{
  "place": "//places.googleapis.com/places/ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "placeId": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "location": {
    "latitude": 37.4220541,
    "longitude": -122.08532419999999
  },
  "granularity": "ROOFTOP",
  "viewport": {
    "low": {
      "latitude": 37.4209489697085,
      "longitude": -122.08846930000001
    },
    "high": {
      "latitude": 37.4236469302915,
      "longitude": -122.0829156
    }
  },
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "postalAddress": {
    "regionCode": "US",
    "languageCode": "en",
    "postalCode": "94043",
    "administrativeArea": "CA",
    "locality": "Mountain View",
    "addressLines": [
      "1600 Amphitheatre Pkwy"
    ]
  },
  "addressComponents": [
    {
      "longText": "1600",
      "shortText": "1600",
      "types": [
        "street_number"
      ]
    },
    {
      "longText": "Amphitheatre Parkway",
      "shortText": "Amphitheatre Pkwy",
      "types": [
        "route"
      ],
      "languageCode": "en"
    },
    {
      "longText": "Mountain View",
      "shortText": "Mountain View",
      "types": [
        "locality",
        "political"
      ],
      "languageCode": "en"
    },
    {
      "longText": "Santa Clara County",
      "shortText": "Santa Clara County",
      "types": [
        "administrative_area_level_2",
        "political"
      ],
      "languageCode": "en"
    },
    {
      "longText": "California",
      "shortText": "CA",
      "types": [
        "administrative_area_level_1",
        "political"
      ],
      "languageCode": "en"
    },
    {
      "longText": "United States",
      "shortText": "US",
      "types": [
        "country",
        "political"
      ],
      "languageCode": "en"
    },
    {
      "longText": "94043",
      "shortText": "94043",
      "types": [
        "postal_code"
      ]
    }
  ],
  "types": [
    "establishment",
    "point_of_interest"
  ]
}

প্রয়োজনীয় পরামিতি

  • place — যে স্থানের জন্য আপনি মানুষের পঠনযোগ্য ঠিকানা পেতে চান তার স্থান আইডি। স্থান আইডি হল একটি অনন্য শনাক্তকারী যা অন্যান্য Google API-এর সাথে ব্যবহার করা যেতে পারে। উদাহরণস্বরূপ, আপনি একটি স্ন্যাপ করা বিন্দুর ঠিকানা পেতে Roads API দ্বারা প্রদত্ত placeID ব্যবহার করতে পারেন। স্থান আইডি সম্পর্কে আরও তথ্যের জন্য, স্থান আইডি দেখুন।

ঐচ্ছিক পরামিতি

  • ভাষা কোড

    যে ভাষায় ফলাফল দেখাতে হবে।

    • সমর্থিত ভাষার তালিকা দেখুন। গুগল প্রায়শই সমর্থিত ভাষাগুলি আপডেট করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
    • যদি languageCode সরবরাহ করা না থাকে, তাহলে API ডিফল্টভাবে en তে সেট করা হবে। যদি আপনি একটি অবৈধ ভাষা কোড উল্লেখ করেন, তাহলে API একটি INVALID_ARGUMENT ত্রুটি প্রদান করবে।
    • API এমন একটি রাস্তার ঠিকানা প্রদানের জন্য যথাসাধ্য চেষ্টা করে যা ব্যবহারকারী এবং স্থানীয় উভয়ের জন্যই পঠনযোগ্য। এই লক্ষ্য অর্জনের জন্য, এটি স্থানীয় ভাষায় রাস্তার ঠিকানাগুলি ফেরত দেয়, প্রয়োজনে ব্যবহারকারীর দ্বারা পঠনযোগ্য স্ক্রিপ্টে লিপ্যন্তরিত করে, পছন্দের ভাষা পর্যবেক্ষণ করে। অন্যান্য সমস্ত ঠিকানা পছন্দের ভাষায় ফেরত দেওয়া হয়। ঠিকানার উপাদানগুলি একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদান থেকে নির্বাচিত হয়।
    • যদি পছন্দের ভাষায় কোনও নাম পাওয়া না যায়, তাহলে API সবচেয়ে কাছের মিল ব্যবহার করে।
    • API কোন ফলাফলগুলি ফেরত দিতে বেছে নেয় এবং কোন ক্রমে সেগুলি ফেরত দেওয়া হয় তার উপর পছন্দের ভাষার প্রভাব খুব কম থাকে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপগুলিকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার ধরণের সংক্ষিপ্ত রূপ, অথবা প্রতিশব্দ যা এক ভাষায় বৈধ হতে পারে কিন্তু অন্য ভাষায় নয়।

  • অঞ্চল কোড

    অঞ্চল কোডটি দুই-অক্ষরের CLDR কোড মান। কোনও ডিফল্ট মান নেই। বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ।

    কোনও ঠিকানা জিওকোডিং করার সময়, জিওডকোডিং ফরোয়ার্ড করার সময় , এই প্যারামিটারটি নির্দিষ্ট অঞ্চলে পরিষেবা থেকে ফলাফলকে প্রভাবিত করতে পারে, কিন্তু সম্পূর্ণরূপে সীমাবদ্ধ করতে পারে না। কোনও অবস্থান বা স্থানের জিওকোডিং করার সময়, জিওকোডিং বিপরীত করার সময় বা স্থান জিওকোডিং করার সময় , এই প্যারামিটারটি ঠিকানাটি ফর্ম্যাট করতে ব্যবহার করা যেতে পারে। সমস্ত ক্ষেত্রে, এই প্যারামিটার প্রযোজ্য আইনের উপর ভিত্তি করে ফলাফলকে প্রভাবিত করতে পারে।