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

ইউরোপিয়ান ইকোনমিক এরিয়া (EEA) ডেভেলপার

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

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

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

একটি স্থান জিওকোডিং অনুরোধ ফর্মটিতে একটি HTTP GET অনুরোধ:

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

যেখানে PLACE_ID আগ্রহের অবস্থানের স্থান আইডি রয়েছে৷

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

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 ব্যবহার করুন

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

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

এছাড়াও, আপনি সমস্ত জিওকোডিং API এন্ডপয়েন্টের জন্য সাধারণ 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 ব্যবহার করতে পারেন। স্থান আইডি সম্পর্কে আরও তথ্যের জন্য, স্থান আইডি দেখুন।

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

  • ভাষা কোড

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

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

  • অঞ্চল কোড

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

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