জিওকোডিং API v4 দিয়ে শুরু করুন

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

জিওকোডিং এপিআই ভি৪ হলো একটি পরিষেবা যা ঠিকানা ও স্থান আইডি-র জিওকোডিং, রিভার্স জিওকোডিং এবং গন্তব্য সম্পর্কিত তথ্য প্রদান করে।

জিওকোডিং হলো ঠিকানা (যেমন রাস্তার ঠিকানা) কে ভৌগোলিক স্থানাঙ্কে (যেমন অক্ষাংশ ও দ্রাঘিমাংশ) রূপান্তর করার প্রক্রিয়া, যা ব্যবহার করে মানচিত্রে মার্কার স্থাপন করা যায় বা মানচিত্রের অবস্থান নির্ধারণ করা যায়।

রিভার্স জিওকোডিং হলো ভৌগোলিক স্থানাঙ্ককে মানুষের পাঠযোগ্য ঠিকানায় রূপান্তর করার প্রক্রিয়া।

এছাড়াও আপনি জিওকোডিং এপিআই ব্যবহার করে একটি নির্দিষ্ট স্থান আইডির ঠিকানা খুঁজে বের করতে পারেন এবং SearchDestinations পদ্ধতির মাধ্যমে বিভিন্ন গন্তব্যস্থল সম্পর্কে বিস্তারিত তথ্য পেতে পারেন।

নমুনা অনুরোধ এবং প্রতিক্রিয়া

আপনি একটি HTTP ইন্টারফেসের মাধ্যমে জিওকোডিং এপিআই অ্যাক্সেস করেন। নিচে জিওকোডিং এবং রিভার্স জিওকোডিং অনুরোধের উদাহরণ দেওয়া হলো।

ভূ-কোডিং অনুরোধ এবং প্রতিক্রিয়া (অক্ষাংশ/দ্রাঘিমাংশ অনুসন্ধান)

নিম্নলিখিত উদাহরণে "1600 Amphitheatre Parkway, Mountain View, CA" ঠিকানার অক্ষাংশ এবং দ্রাঘিমাংশ জানতে চাওয়া হয়েছে এবং নির্দিষ্ট করে বলা হয়েছে যে আউটপুটটি অবশ্যই JSON ফরম্যাটে হতে হবে।

curl -H "X-Goog-Api-Key: YOUR_API_KEY" \
"https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"

আপনার ওয়েব ব্রাউজারে URL-টি প্রবেশ করিয়ে আপনি এটি পরীক্ষা করতে পারেন (অবশ্যই YOUR_API_KEY জায়গায় আপনার আসল API কী বসাবেন)। প্রতিক্রিয়াটিতে ঠিকানাটির অক্ষাংশ এবং দ্রাঘিমাংশ অন্তর্ভুক্ত থাকে।

জিওকোডিং অনুরোধের ইউআরএল তৈরি , উপলব্ধ প্যারামিটার এবং প্রতিক্রিয়া বোঝার বিষয়ে আরও তথ্যের জন্য ডেভেলপারের নির্দেশিকা দেখুন।

নিচে JSON ফরম্যাটে একটি নমুনা জিওকোডিং প্রতিক্রিয়া দেওয়া হলো:

{
  "results": [
    {
      "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ",
      "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ",
      "location": {
        "latitude": 37.4438238,
        "longitude": -122.0869895
      },
      "granularity": "ROOFTOP",
      "viewport": {
        "low": {
          "latitude": 37.4424748197085,
          "longitude": -122.0883384802915
        },
        "high": {
          "latitude": 37.445172780291493,
          "longitude": -122.08564051970852
        }
      },
      "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
      "postalAddress": {
        "regionCode": "US",
        "languageCode": "en",
        "postalCode": "94043-1351",
        "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"
          ]
        },
        {
          "longText": "1351",
          "shortText": "1351",
          "types": [
            "postal_code_suffix"
          ]
        }
      ],
      "types": [
        "premise",
        "street_address"
      ]
    }
  ]
}

বিপরীত ভূ-কোডিং অনুরোধ এবং প্রতিক্রিয়া (ঠিকানা অনুসন্ধান)

নিম্নলিখিত উদাহরণটি মার্কিন যুক্তরাষ্ট্রের নিউ ইয়র্কের ব্রুকলিনে অবস্থিত একটি প্রদত্ত অক্ষাংশ/দ্রাঘিমাংশের সাথে সম্পর্কিত ঠিকানা জানতে চায়। এতে উল্লেখ করা হয়েছে যে আউটপুটটি অবশ্যই JSON ফরম্যাটে হতে হবে।

https://geocode.googleapis.com/v4/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEY

আপনার ওয়েব ব্রাউজারে URL-টি প্রবেশ করিয়ে আপনি এটি পরীক্ষা করতে পারেন (অবশ্যই 'YOUR_API_KEY'-এর জায়গায় আপনার আসল API কী বসাবেন)। প্রতিক্রিয়াটিতে অক্ষাংশ এবং দ্রাঘিমাংশের অবস্থানের জন্য একটি পাঠযোগ্য ঠিকানা অন্তর্ভুক্ত থাকে।

রিভার্স জিওকোডিং রিকোয়েস্ট ইউআরএল তৈরি , উপলব্ধ প্যারামিটার এবং রেসপন্স বোঝার বিষয়ে আরও তথ্যের জন্য ডেভেলপার গাইডটি দেখুন।

নিচে JSON ফরম্যাটে একটি নমুনা রিভার্স জিওকোডিং রেসপন্স দেওয়া হলো:

{
  "results": [
    {
      "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE",
      "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE",
      "location": {
        "latitude": 37.4225657,
        "longitude": -122.08465439999999
      },
      "granularity": "ROOFTOP",
      "viewport": {
        "low": {
          "latitude": 37.421214719708509,
          "longitude": -122.08603273029148
        },
        "high": {
          "latitude": 37.423912680291508,
          "longitude": -122.0833347697085
        }
      },
      "bounds": {
        "low": {
          "latitude": 37.4225178,
          "longitude": -122.08484599999998
        },
        "high": {
          "latitude": 37.422609600000008,
          "longitude": -122.0845215
        }
      },
      "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
      "postalAddress": {
        "regionCode": "US",
        "languageCode": "en",
        "postalCode": "94043",
        "administrativeArea": "CA",
        "locality": "Mountain View",
        "addressLines": [
          "Google Building 40",
          "1600 Amphitheatre Pkwy"
        ]
      },
      "addressComponents": [
        {
          "longText": "Google Building 40",
          "shortText": "Google Building 40",
          "types": [
            "premise"
          ],
          "languageCode": "en"
        },
        {
          "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": [
        "street_address",
        "subpremise"
      ]
    },
    ... Additional results truncated in this example[] ...
}

প্রমাণীকরণ, কোটা, মূল্য নির্ধারণ এবং নীতিমালা

প্রমাণীকরণ

জিওকোডিং এপিআই ব্যবহার করার জন্য, আপনাকে প্রথমে এপিআইটি সক্রিয় করতে হবে এবং যথাযথ প্রমাণীকরণ তথ্য সংগ্রহ করতে হবে। আরও তথ্যের জন্য, “গুগল ম্যাপস প্ল্যাটফর্ম দিয়ে শুরু করুন” দেখুন।

কোটা এবং মূল্য নির্ধারণ

জিওকোডিং এপিআই-এর জন্য নির্ধারিত কোটা এবং মূল্য সম্পর্কে বিস্তারিত জানতে ব্যবহার ও বিলিং পৃষ্ঠাটি পর্যালোচনা করুন।

নীতিমালা

জিওকোডিং এপিআই-এর ব্যবহার অবশ্যই এপিআই নীতিমালা অনুযায়ী হতে হবে।