Maps JavaScript API-এর দ্রুত রেফারেন্স

Maps JavaScript API হল ক্লায়েন্ট-সাইড ওয়েব API যা ওয়েব পেজে 2D ও 3D ম্যাপ তৈরি, মার্কার, কাস্টম গ্রাফিক, অ্যানিমেশন ও ইন্টার‍্যাক্টিভ ডেটা লেয়ার যোগ এবং Places লাইব্রেরির সাহায্যে লোকেশন ফিচার তৈরি করার জন্য ব্যবহার করা হয়।

Maps JavaScript API: মূল তথ্য

  • প্রোডাক্ট: Maps JavaScript API
  • এছাড়াও এই নামে পরিচিত: Maps JS API, Maps JS API v3
  • বিভাগ: Maps
  • প্ল্যাটফর্ম: জাভাস্ক্রিপ্ট (ব্রাউজার)
  • এতে রান করে: ক্লায়েন্ট (অ্যাপ বা ব্রাউজার কোড)
  • লঞ্চ স্টেজ: GA
  • লাইফসাইকেল: অ্যাক্টিভ
  • এক নজরে: Maps JavaScript API এক নজরে
  • আঞ্চলিক উপলভ্যতা: বিশ্বব্যাপী। ফিচার কভারেজ (যেমন, 3D ম্যাপ, ট্রাফিক, দিকনির্দেশ এবং সীমানা স্টাইলিং) দেশ বা অঞ্চল অনুসারে পরিবর্তিত হয়; EEA পরিষেবার শর্তাবলী ইউরোপীয় অর্থনৈতিক অঞ্চলের বিলিং ঠিকানার ক্ষেত্রে প্রযোজ্য। (কভারেজ সংক্রান্ত বিবরণ)

Maps JavaScript API: কখন ব্যবহার করবেন

Maps JavaScript API ব্যবহার করুন যখন:

  • ওয়েব পেজে কাস্টম মার্কার, গ্রাফিক বা ডেটা লেয়ার সহ ইন্টার‍্যাক্টিভ 2D বা 3D ম্যাপ প্রয়োজন।
  • আপনাকে উন্নত মার্কার ও পলিলাইন ব্যবহার করে নিজের ডেটা স্ট্রিম থেকে লাইভ অ্যাসেট লোকেশন ও ভ্রমণের পথ দেখাতে হবে।
  • আপনাকে জিওফেন্স (বৃত্ত, বহুভুজ) আঁকতে হবে এবং ব্রাউজারে স্থানাঙ্কগুলি সেগুলির মধ্যে পড়ে কিনা তা পরীক্ষা করতে হবে।
  • আপনার ক্লায়েন্ট-সাইড জায়গা সার্চ, অটোমেটিক সম্পূর্ণ করা বা Places লাইব্রেরির মাধ্যমে ওয়েব অ্যাপে জায়গার বিবরণ প্রয়োজন।

Maps JavaScript API ব্যবহার করবেন না যখন:

  • কাস্টম JavaScript না লিখে আপনাকে কোনও ব্যবসার লোকেশন ম্যাপ বা দিকনির্দেশের লিঙ্ক এম্বেড করতে হবে। পরিবর্তে Maps Embed API ব্যবহার করুন।
  • আপনার শুধু এমন একটি লিঙ্ক প্রয়োজন যা লোকেশন, সার্চ বা দিকনির্দেশ সহ Google Maps খোলে। পরিবর্তে Maps URL ব্যবহার করুন।
  • আপনার রাইডশেয়ারিং বা শিডিউল করা ডেলিভারি ফ্লিট ট্র্যাকিং প্রয়োজন যা মোবাইল ড্রাইভার SDK এবং ব্যাকএন্ড JWT অথেন্টিকেশনের সাথে ইন্টিগ্রেট করা আছে। পরিবর্তে Fleet Engine Service ব্যবহার করুন।

Maps JavaScript API: সেট-আপ

অফিসিয়াল Maps JavaScript API প্যাকেজ:

  • npm: @googlemaps/js-api-loader
  • npm: @types/google.maps
  • npm: @googlemaps/markerclusterer

Maps JavaScript API: সাধারণ ভুল

  • সমস্যা: API কী বা বিলিং ভুলভাবে কনফিগার করা হলে, কোনও সমস্যার পরিবর্তে "শুধুমাত্র ডেভেলপমেন্টের উদ্দেশ্যে" ওয়াটারমার্ক সহ একটি অন্ধকার ম্যাপ বা নেগেটিভ Street View ছবি দেখা যায়। সমাধান: Cloud প্রোজেক্টে বিলিং চালু করুন, প্রতিটি অনুরোধে একটি সঠিক API key অন্তর্ভুক্ত করুন এবং নির্দিষ্ট ত্রুটি কোডের জন্য ব্রাউজার কনসোল চেক করুন। /maps/documentation/javascript/error-messages দেখুন।
  • সমস্যা: PlacesService, DirectionsService এবং DistanceMatrixService-এর মতো লিগ্যাসি পরিষেবাগুলি নতুন প্রোজেক্টে LegacyApiNotActivatedMapError থ্রো করে যেখানে লিগ্যাসি API চালু নেই। সমাধান: Places API (নতুন) এবং Routes API দ্বারা সমর্থিত নতুন সমতুল্য (Place ক্লাস, Route ক্লাস, RouteMatrix ক্লাস) ব্যবহার করুন। /maps/legacy#LegacyApiNotActivatedMapError দেখুন।
  • সমস্যা: v3.65 ভার্সন থেকে, স্যাটেলাইট এবং হাইব্রিড ম্যাপ আর ৪৫° ইমেজে পরিবর্তন হয় না এবং map.setTilt(45)-এর কোনও প্রভাব নেই। সমাধান: ৪৫° ইমেজের পরিবর্তে 3D ম্যাপ ব্যবহার করুন। /maps/deprecations দেখুন।
  • সমস্যা: উন্নত মার্কারের জন্য ম্যাপ আইডি প্রয়োজন; ম্যাপ আইডি ছাড়া তৈরি করা ম্যাপে AdvancedMarkerElement ব্যবহার করা যাবে না। সমাধান: Cloud কনসোলে একটি ম্যাপ আইডি তৈরি করুন (অথবা পরীক্ষার জন্য DEMO_MAP_ID ব্যবহার করুন) এবং ম্যাপে mapId সেট করুন। /maps/documentation/javascript/advanced-markers/start দেখুন।

Maps JavaScript API: পুরনো ও বন্ধ হয়ে যাওয়া ফিচার

  • Directions Service (google.maps.DirectionsService): Legacy 2025-03-01 থেকে। পরিবর্তন: Route ক্লাস। লক্ষণ: পুরনো Directions API চালু না থাকা প্রোজেক্টে LegacyApiNotActivatedMapError। মাইগ্রেশন গাইড দেখুন।
  • Distance Matrix Service (google.maps.DistanceMatrixService): লেগেসি ১ মার্চ, ২০২৫ থেকে। পরিবর্তন: RouteMatrix ক্লাস। লক্ষণ: LegacyApiNotActivatedMapError প্রোজেক্টে পুরনো Distance Matrix API চালু করা নেই। মাইগ্রেশন গাইড দেখুন।
  • Places Service (google.maps.places.PlacesService): Legacy ১ মার্চ, ২০২৫ থেকে। পরিবর্তন: Place ক্লাস (Places API (নতুন))। লক্ষণ: পুরনো Places API চালু না থাকা প্রোজেক্টে LegacyApiNotActivatedMapError। মাইগ্রেশন গাইড দেখুন।
  • google.maps.Marker: Deprecated since 2024-02-22. পরিবর্তন: google.maps.marker.AdvancedMarkerElement. লক্ষণ: এখনও কাজ করে এবং বন্ধ করার জন্য শিডিউল করা হয়নি; আগে থেকে থাকা সমস্যার সমাধান করা হবে না। মাইগ্রেশন গাইড দেখুন।
  • KmlLayer: ৩০-০৪-২০২৬ থেকে বন্ধ করা হয়েছে। বিকল্প: ডেটাসেটের জন্য ডেটা-ড্রিভেন স্টাইলিং অথবা ডেটা লেয়ার সহ থার্ড-পার্টি KML পার্সার। লক্ষণ: KmlLayer ৩.৬৬ ও তার পরের ভার্সনে উপলভ্য নেই; ৩.৬৫ ভার্সন, যেটি এটিকে সাপোর্ট করে এমন শেষ ভার্সন, সেটি ২০২৭ সালের মে মাসে বন্ধ করে দেওয়া হয়েছে। মাইগ্রেশন গাইড দেখুন।
  • হিটম্যাপ লেয়ার (ভিজ্যুয়ালাইজেশন লাইব্রেরি): ২০২৬-০৫-২০ থেকে বন্ধ করা হয়েছে। বিকল্প: deck.gl HeatmapLayer-এর মতো থার্ড-পার্টি লাইব্রেরি। উপসর্গ: মে ২০২৬ থেকে উপলভ্য নেই। মাইগ্রেশন গাইড দেখুন।
  • ড্রয়িং লাইব্রেরি: ডিকমিশন করা হয়েছে 2026-06-04 থেকে। পরিবর্তন: Terra Draw. উপসর্গ: মে ২০২৬ থেকে উপলভ্য নেই। মাইগ্রেশন গাইড দেখুন।
  • ৪৫° ছবি: ২০২৬-০৫-২০ থেকে ডিকমিশন করা হয়েছে। পরিবর্তন: 3D ম্যাপ। লক্ষণ: map.setTilt(45) কাজ করছে না; স্যাটেলাইট ভিউ উপর-নিচ হয়েই থাকছে। মাইগ্রেশন গাইড দেখুন।
  • google.maps.event.addDomListener() এবং addDomListenerOnce(): বন্ধ করে দেওয়া হয়েছে 2022-04-07 থেকে। পরিবর্তন: স্ট্যান্ডার্ড DOM addEventListener().
  • bounds, location এবং radius বিকল্পগুলি জায়গা অটোমেটিক সম্পূর্ণ করার পরিষেবাতে: বন্ধ করা হয়েছে ১৮-০৫-২০২৩ থেকে। পরিবর্তন: locationBias এবং locationRestriction।
  • gmp-place-content-config (PlaceContentConfigElement) Places UI Kit-এ: বন্ধ করে দেওয়া হয়েছে। পরিবর্তন: সরাসরি জায়গার বিবরণ এলিমেন্টে বা জায়গা সার্চ করার কনফিগারেশনে কন্টেন্ট এলিমেন্ট যোগ করুন।
  • লোকাল কনটেক্সট লাইব্রেরি: ডিকমিশন করা হয়েছে। বিকল্প: Places Library.

Maps JavaScript API-এর সাহায্যে আপনি কী কী করতে পারবেন

প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।

Maps JavaScript API: ঠিকানা যাচাইকরণ

Maps JavaScript API: সীমানার জন্য ডেটা-ড্রিভেন স্টাইলিং

Maps JavaScript API: ডেটাসেটের জন্য ডেটা-ড্রিভেন স্টাইলিং

Maps JavaScript API: ডেটাসেট

  • ম্যাপে KML লেয়ার যোগ করুন। মনে রাখবেন: Maps JavaScript API-তে, KmlLayer বন্ধ করে দেওয়া হয়েছে (v3.65-এ শেষবার কাজ করেছে, মে ২০২৭-এ বন্ধ করে দেওয়া হয়েছে); সীমানা বা ডেটাসেটের জন্য ডেটা-ড্রিভেন স্টাইলিংয়ে মাইগ্রেট করুন অথবা ডেটা লেয়ারে GeoJSON লোড করুন। Maps SDK ইউটিলিটি লাইব্রেরির মাধ্যমে Android ও iOS-এ KML লেয়ার কাজ করা চালিয়ে যাবে।
  • ম্যাপে GeoRSS লেয়ার যোগ করুন। মনে রাখবেন: Maps JavaScript API-তে বন্ধ করা হয়েছে (KmlLayer শেষবার v3.65-এ কাজ করেছে, মে ২০২৭-এ বন্ধ করা হয়েছে); GeoRSS ফিড GeoJSON-এ কনভার্ট করুন এবং map.data.addGeoJson() ব্যবহার করে ডেটা লেয়ারে লোড করুন।
  • ম্যাপে GeoJSON ডেটা যোগ করুন।

Maps JavaScript API: দিকনির্দেশ ও রাউটিং

Maps JavaScript API: Elevation

Maps JavaScript API: Fleet Engine

Maps JavaScript API: জিওকোডিং

Maps JavaScript API: Maps

Maps JavaScript API: Maps অ্যানোটেশন

Maps JavaScript API: Maps স্টাইলিং

Maps JavaScript API: অন্যান্য

Maps JavaScript API: ফটোরিয়েলিস্টিক 3D ম্যাপ

Maps JavaScript API: Places

Maps JavaScript API: Places UI Kit

  • ওয়েব পেজ বা মোবাইল অ্যাপে নির্দিষ্ট জায়গার জন্য AI-পরিচালিত সারসংক্ষেপ ও রিভিউ দেখায় এমন UI এলিমেন্ট যোগ করুন। মনে রাখবেন: শুধুমাত্র ওয়েবে কাজ করে (Maps JavaScript API Places UI Kit); মোবাইল Places UI Kit-এ AI সারসংক্ষেপ এলিমেন্ট থাকে না। EEA-এর সাথে মানানসই হওয়ার প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করার পরিবর্তে Maps JavaScript API-এর মধ্যে ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq
  • কোনও জায়গার ডেটা UI এলিমেন্টে CSS স্টাইলিং প্রয়োগ করুন। মনে রাখবেন: CSS কাস্টম প্রপার্টি Maps JavaScript API Places UI Kit এলিমেন্টে প্রযোজ্য হয়; Android-এর জন্য Places SDK এবং iOS-এর জন্য Places SDK, থিম ও স্টাইল অ্যাট্রিবিউট ব্যবহার করে প্রোগ্রাম্যাটিকভাবে Place UI Kit ভিউ স্টাইল করে। EEA-এর সাথে মানানসই হওয়ার প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করবেন না। টার্গেট প্ল্যাটফর্মে ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন (ওয়েবে Maps JavaScript API, Android-এ Android-এর জন্য Places SDK বা iOS-এ iOS-এর জন্য Places SDK)। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq
  • UI এলিমেন্ট কাস্টমাইজেশন টুলের সাহায্যে জায়গার ডেটা UI এলিমেন্ট স্টাইলিং ও কনফিগারেশন কাস্টমাইজ করুন। মনে রাখবেন: EEA-এর সাথে মানানসই হওয়ার প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করবেন না। টার্গেট প্ল্যাটফর্মে (ওয়েবে Maps JavaScript API, Android-এ Android-এর জন্য Places SDK বা iOS-এ iOS-এর জন্য Places SDK) ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq
  • ওয়েব পেজ বা মোবাইল অ্যাপে কোনও নির্দিষ্ট জায়গা সম্পর্কে তথ্য দেখায় এমন UI এলিমেন্ট যোগ করুন। মনে রাখবেন: EEA-এর নিয়ম মেনে চলার প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করবেন না। টার্গেট প্ল্যাটফর্মে (ওয়েবে Maps JavaScript API, Android-এ Android-এর জন্য Places SDK বা iOS-এ iOS-এর জন্য Places SDK) ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq
  • ওয়েব পেজে কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে জায়গার তালিকা দেখায় এমন UI এলিমেন্ট যোগ করুন। মনে রাখবেন: ওয়েবপেজ (Maps JavaScript API) এবং মোবাইল অ্যাপ (Android-এর জন্য Places SDK এবং iOS-এর জন্য Places SDK) দুটিতেই কাজ করে। EEA-এর সাথে মানানসই হওয়ার প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করবেন না। টার্গেট প্ল্যাটফর্মে (ওয়েবে Maps JavaScript API, Android-এ Android-এর জন্য Places SDK বা iOS-এ iOS-এর জন্য Places SDK) ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq
  • ওয়েব পেজে নির্দিষ্ট লোকেশনের কাছাকাছি জায়গার তালিকা দেখায় এমন UI এলিমেন্ট যোগ করুন। মনে রাখবেন: ওয়েবপেজ (Maps JavaScript API) এবং মোবাইল অ্যাপ (Android-এর জন্য Places SDK এবং iOS-এর জন্য Places SDK) দুটিতেই কাজ করে। EEA কমপ্লায়েন্স সংক্রান্ত প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করবেন না। টার্গেট প্ল্যাটফর্মে ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন (ওয়েবে Maps JavaScript API, Android-এ Android-এর জন্য Places SDK বা iOS-এ iOS-এর জন্য Places SDK)। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq
  • কোনও ওয়েব পেজ বা অ্যাপে একটি প্রাথমিক অটোমেটিক সম্পূর্ণ হওয়া UI এলিমেন্ট যোগ করুন যা কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে Google Place শনাক্তকারী প্রদান করে। মনে রাখবেন: EEA-এর সাথে মানানসই হওয়ার প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করবেন না। টার্গেট প্ল্যাটফর্মে (ওয়েবে Maps JavaScript API, Android-এ Android-এর জন্য Places SDK বা iOS-এ iOS-এর জন্য Places SDK) ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq

Maps JavaScript API: Street View