iOS এর জন্য Google Maps URL স্কিম

iOS 9 এবং পরবর্তীতে চলমান ডিভাইসগুলিতে, আপনার কাছে একটি Google মানচিত্র URL থাকলে আপনি Google মানচিত্র চালু করতে ইউনিভার্সাল লিঙ্ক ব্যবহার করতে পারেন।

আপনি iOS এর জন্য Google Maps অ্যাপ চালু করতে এবং অনুসন্ধান করতে, দিকনির্দেশের অনুরোধ পেতে এবং মানচিত্র দৃশ্যগুলি প্রদর্শন করতে Google Maps URL স্কিম ব্যবহার করতে পারেন। আপনি যখন Google মানচিত্র চালু করেন, তখন অনুরোধের অংশ হিসেবে আপনার বান্ডেল শনাক্তকারী স্বয়ংক্রিয়ভাবে পাঠানো হয়।

Google Maps URL স্কিম ব্যবহার করার জন্য আপনার Google API কী প্রয়োজন নেই৷

iOS-এর জন্য Google Maps iOS 9 বা তার পরের ডিভাইসে চলমান ডিভাইসগুলিতে ইউনিভার্সাল লিঙ্ক সমর্থন করে।

যদি আপনার URL নিম্নলিখিত রেগুলার এক্সপ্রেশনের সাথে মেলে, এবং ডিভাইসটি iOS 9 বা তার পরে চলমান থাকে, তাহলে আপনি সরাসরি openURL: পদ্ধতি ব্যবহার করার কথা বিবেচনা করতে পারেন।

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

যেমন,

সুইফট 

UIApplication.shared.openURL(URL(string:"https://www.google.com/maps/@42.585444,13.007813,6z")!)

উদ্দেশ্য-C 

[[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"https://www.google.com/maps/@42.585444,13.007813,6z"]];

ওভারভিউ

একটি URL স্কিম আপনাকে অন্য iOS অ্যাপ বা একটি ওয়েব অ্যাপ্লিকেশন থেকে একটি নেটিভ iOS অ্যাপ্লিকেশন চালু করতে দেয়। আপনি URL-এ বিকল্পগুলি সেট করতে পারেন যা লঞ্চ করা অ্যাপ্লিকেশনে পাস করা হবে। iOS-এর জন্য Google Maps অ্যাপ নিম্নলিখিত ইউআরএল স্কিমগুলিকে সমর্থন করে:

  • comgooglemaps:// এবং comgooglemaps-x-callback:// - এই স্কিমগুলি আপনাকে iOS-এর জন্য Google মানচিত্র অ্যাপ চালু করতে এবং বিভিন্ন ক্রিয়াকলাপের মধ্যে একটি সম্পাদন করতে দেয়:

    • একটি নির্দিষ্ট অবস্থান এবং জুম স্তরে একটি মানচিত্র প্রদর্শন করুন।
    • অবস্থান বা স্থান অনুসন্ধান করুন, এবং একটি মানচিত্রে তাদের প্রদর্শন করুন.
    • এক অবস্থান থেকে অন্য অবস্থানের দিকনির্দেশের জন্য অনুরোধ করুন। চারটি মোড পরিবহনের জন্য দিকনির্দেশ ফেরত যেতে পারে: ড্রাইভিং, হাঁটা, সাইকেল চালানো এবং পাবলিক ট্রানজিট।
    • আপনার অ্যাপে নেভিগেশন যোগ করুন।
    • iOS 8 এর মাধ্যমে, comgooglemaps-x-callback:// ব্যবহার করে অ্যাপটি সম্পূর্ণ হয়ে গেলে একটি কলব্যাক ইস্যু করুন। যে অ্যাপটি মূলত iOS-এর জন্য Google Maps খুলেছিল সেই অ্যাপে ব্যবহারকারীকে ফেরত দিতে প্রায়ই কলব্যাক ব্যবহার করা হয়। মনে রাখবেন যে iOS 9-এ, সিস্টেমটি স্বয়ংক্রিয়ভাবে স্ট্যাটাস বারের বাম কোণে একটি "ব্যাক টু" লিঙ্ক প্রদান করে।

  • comgooglemapsurl:// - এই স্কিমটি আপনাকে ডেস্কটপ Google Maps ওয়েবসাইট থেকে প্রাপ্ত URL ব্যবহার করে iOS-এর জন্য Google Maps অ্যাপ চালু করতে দেয়। এর মানে হল যে আপনি Google Maps ওয়েবসাইট লোড করার পরিবর্তে আপনার ব্যবহারকারীদের একটি নেটিভ মোবাইল অভিজ্ঞতা দিতে পারেন৷

    • আসল URL হতে পারে maps.google.com , বা google.com/maps এর জন্য, অথবা com পরিবর্তে যেকোনো বৈধ শীর্ষ-স্তরের দেশের ডোমেন ব্যবহার করা। এছাড়াও আপনি goo.gl/maps রিডাইরেকশন ইউআরএল পাস করতে পারেন।
    • আপনি comgooglemapsurl:// URL স্কিমের সাথে x-source এবং x-success পরামিতি ব্যবহার করে একটি কলব্যাক ইস্যু করতে পারেন।

iOS এর জন্য Google Maps অ্যাপ চালু করা এবং একটি নির্দিষ্ট ফাংশন সম্পাদন করা

iOS-এর জন্য Google Maps অ্যাপ চালু করতে এবং ঐচ্ছিকভাবে সমর্থিত ফাংশনগুলির একটি সম্পাদন করতে, নিম্নলিখিত ফর্মের একটি URL স্কিম ব্যবহার করুন:

comgooglemaps://?parameters

বা:

comgooglemaps-x-callback://?parameters

পরামিতিগুলি এই নথিতে পরে বিস্তারিতভাবে বর্ণনা করা হয়েছে।

ডিভাইসে Google Maps অ্যাপের উপলভ্যতা পরীক্ষা করা হচ্ছে

আপনি আপনার অ্যাপে ব্যবহারকারীর কাছে এই URLগুলির একটি উপস্থাপন করার আগে আপনাকে প্রথমে যাচাই করতে হবে যে অ্যাপ্লিকেশনটি ইনস্টল করা আছে৷ আপনার অ্যাপ চেক করতে পারে যে URL স্কিমটি নিম্নলিখিত কোডের সাথে উপলব্ধ:

সুইফট 

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)

উদ্দেশ্য-C 

[[UIApplication sharedApplication] canOpenURL:
    [NSURL URLWithString:@"comgooglemaps://"]];

উদাহরণস্বরূপ, নিউ ইয়র্কের সেন্ট্রাল পার্কের একটি মানচিত্র প্রদর্শন করতে, আপনি নিম্নলিখিত কোডটি ব্যবহার করতে পারেন:

সুইফট 

if (UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)) {
  UIApplication.shared.openURL(URL(string:
    "comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic")!)
} else {
  print("Can't use comgooglemaps://");
}

উদ্দেশ্য-C 

if ([[UIApplication sharedApplication] canOpenURL:
     [NSURL URLWithString:@"comgooglemaps://"]]) {
  [[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic"]];
} else {
  NSLog(@"Can't use comgooglemaps://");
}

একটি মানচিত্র প্রদর্শন করা হচ্ছে

একটি নির্দিষ্ট জুম স্তর এবং অবস্থানে মানচিত্র প্রদর্শন করতে URL স্কিম ব্যবহার করুন৷ এছাড়াও আপনি আপনার মানচিত্রের উপরে অন্যান্য দৃশ্যগুলিকে ওভারলে করতে পারেন বা রাস্তার দৃশ্যের চিত্র প্রদর্শন করতে পারেন৷

পরামিতি

নিম্নলিখিত পরামিতি সব ঐচ্ছিক. যদি কোনো প্যারামিটার সেট করা না থাকে, তাহলে URL স্কিমটি iOS-এর জন্য Google Maps অ্যাপ চালু করবে।

  • center : এটি মানচিত্র ভিউপোর্ট কেন্দ্র বিন্দু। latitude,longitude একটি কমা বিভক্ত স্ট্রিং হিসাবে ফর্ম্যাট করা হয়েছে৷
  • mapmode : দেখানো মানচিত্রের ধরন সেট করে। এতে সেট করা যেতে পারে: standard বা streetview । নির্দিষ্ট না থাকলে, বর্তমান অ্যাপ্লিকেশন সেটিংস ব্যবহার করা হবে।
  • views : নির্দিষ্ট ভিউ চালু/বন্ধ করে। এতে সেট করা যেতে পারে: satellite , traffic বা transit । একটি কমা-বিভাজক ব্যবহার করে একাধিক মান সেট করা যেতে পারে। যদি প্যারামিটারটি কোনও মান ছাড়াই নির্দিষ্ট করা হয়, তবে এটি সমস্ত দর্শন সাফ করবে।
  • zoom : মানচিত্রের জুম স্তর নির্দিষ্ট করে।

এই উদাহরণ URLটি ট্রাফিক ভিউ সহ জুম 14 এ নিউ ইয়র্ক কেন্দ্রিক মানচিত্র প্রদর্শন করে: 

comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic

নিউ ইয়র্ক ট্রাফিক মানচিত্র

কিছু অতিরিক্ত উদাহরণ হল: 

comgooglemaps://?center=37.788463,-122.392545&zoom=12

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

একটি নির্দিষ্ট ভিউপোর্ট অবস্থানে অনুসন্ধান প্রশ্নগুলি প্রদর্শন করতে এই স্কিমটি ব্যবহার করুন৷

পরামিতি

মানচিত্র প্রদর্শনের জন্য ব্যবহৃত প্যারামিটার ছাড়াও, অনুসন্ধান q পরামিতি সমর্থন করে।

  • q : আপনার অনুসন্ধানের জন্য ক্যোয়ারী স্ট্রিং।

নির্দিষ্ট অবস্থানের আশেপাশে "পিজ্জা" অনুসন্ধান করার জন্য এই উদাহরণ URL: 

comgooglemaps://?q=Pizza&center=37.759748,-122.427135

কাছাকাছি পিজা

কিছু অতিরিক্ত উদাহরণ হল: 

comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA&center=37.782652,-122.410126&views=satellite,traffic&zoom=15

comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan&center=35.660888,139.73073&zoom=15&views=transit

দিকনির্দেশ প্রদর্শন করা হচ্ছে

অনুরোধ করতে এবং দুটি অবস্থানের মধ্যে নির্দেশ প্রদর্শন করতে এই স্কিমটি ব্যবহার করুন৷ এছাড়াও আপনি পরিবহন মোড নির্দিষ্ট করতে পারেন.

পরামিতি

  • saddr : দিকনির্দেশ অনুসন্ধানের জন্য সূচনা বিন্দু সেট করে। এটি একটি অক্ষাংশ, দ্রাঘিমাংশ বা একটি প্রশ্ন বিন্যাসিত ঠিকানা হতে পারে৷ যদি এটি একটি ক্যোয়ারী স্ট্রিং হয় যা একাধিক ফলাফল প্রদান করে, প্রথম ফলাফলটি নির্বাচন করা হবে। যদি মানটি ফাঁকা রাখা হয়, তাহলে ব্যবহারকারীর বর্তমান অবস্থান ব্যবহার করা হবে।
  • daddr : দিকনির্দেশ অনুসন্ধানের জন্য শেষ বিন্দু সেট করে। saddr মতো একই বিন্যাস এবং আচরণ রয়েছে।
  • directionsmode : পরিবহন পদ্ধতি। এতে সেট করা যেতে পারে: driving , transit , bicycling বা walking ।

উদাহরণ URLটি Google NYC এবং JFK বিমানবন্দরের মধ্যে ট্রানজিট দিকনির্দেশ প্রদর্শন করে: 

comgooglemaps://?saddr=Google+Inc,+8th+Avenue,+New+York,+NY&daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York&directionsmode=transit

ট্রানজিট দিকনির্দেশ

কিছু অতিরিক্ত উদাহরণ হল: 

comgooglemaps://?saddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA+94043&daddr=Google+Inc,+345+Spear+Street,+San+Francisco,+CA&center=37.422185,-122.083898&zoom=10

comgooglemaps://?saddr=2025+Garcia+Ave,+Mountain+View,+CA,+USA&daddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA,+United+States&center=37.423725,-122.0877&directionsmode=walking&zoom=17

একটি কলব্যাক URL উল্লেখ করা হচ্ছে

আপনি যদি একটি কলব্যাক URL নির্দিষ্ট করতে চান, তাহলে আপনাকে অবশ্যই comgooglemaps-x-callback:// URL স্কিম ব্যবহার করতে হবে৷ এই স্কিমটি এক্স-কলব্যাক-ইউআরএল স্পেসিফিকেশন মেনে চলে। আপনি যখন এই স্কিমের সাথে iOS-এর জন্য Google মানচিত্র অ্যাপে কল করবেন, অ্যাপটি স্ক্রিনের শীর্ষে একটি বোতাম প্রদর্শন করবে। এই বোতামটি আলতো চাপলে আপনার নির্দিষ্ট করা একটি URL-এ একটি কলব্যাক ইস্যু হবে৷

comgooglemaps-x-callback:// এ অনুরোধগুলি অবশ্যই ফর্মের হতে হবে: 

comgooglemaps-x-callback://?parameters

পরামিতি

x-কলব্যাক ইউআরএল স্কিম নিম্নলিখিত অতিরিক্ত প্যারামিটার সহ comgooglemaps:// URL স্কিমের মতো একই প্যারামিটার গ্রহণ করে। উভয় পরামিতি প্রয়োজন.

  • x-source — x-কলব্যাক অনুরোধ পাঠানোর অ্যাপ্লিকেশনটির নাম। সংক্ষিপ্ত নাম পছন্দ করা হয়.
  • x-success — সম্পূর্ণ হলে কল করার URL। প্রায়শই এটি আপনার নিজের অ্যাপের জন্য একটি URL স্কিম হবে, যা ব্যবহারকারীদের আসল অ্যাপ্লিকেশনে ফিরে যেতে দেয়।

মনে রাখবেন যে আপনার অ্যাপটিকে তার নিজস্ব URL স্কিম নিবন্ধন করতে হবে যাতে এটি কলব্যাক URL-এ সাড়া দিতে পারে।

  1. নিশ্চিত করুন যে আপনার অ্যাপ্লিকেশনটি একটি URL স্কিম নিবন্ধিত করেছে যা কলব্যাক অনুরোধে সাড়া দিতে পারে।
  2. x-source প্যারামিটারে কলব্যাক বোতামের জন্য লেবেলটি পাস করুন।
  3. x-success প্যারামিটারে কলব্যাক URL পাস করুন।

নিম্নলিখিত উদাহরণটি iOS-এর জন্য Google মানচিত্র অ্যাপ চালু করবে এবং নিউ ইয়র্ককে কেন্দ্র করে একটি মানচিত্র প্রদর্শন করবে। অ্যাপটি "সোর্সঅ্যাপ" লেবেলযুক্ত একটি বোতামও প্রদর্শন করবে। যখন "সোর্সঅ্যাপ" বোতামটি ক্লিক করা হয়, iOS এর জন্য Google মানচিত্র অ্যাপটি একটি কাল্পনিক URL স্কিমে একটি কলব্যাক ইস্যু করবে, sourceapp://?resume=true । 

comgooglemaps-x-callback://?center=40.765819,-73.975866&zoom=14
   &x-success=sourceapp://?resume=true
   &x-source=SourceApp

comgooglemaps:// URL স্কিমের মতো, আপনাকে প্রথমে যাচাই করতে হবে যে iOS-এর জন্য Google ম্যাপ অ্যাপ ডিভাইসে উপলব্ধ, এবং x-কলব্যাক URL স্কিম সমর্থন করে৷ আপনার অ্যাপ চেক করতে পারে যে URL স্কিমটি নিম্নলিখিত কোডের সাথে উপলব্ধ:

সুইফট 

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)

উদ্দেশ্য-C 

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemaps-x-callback://"]];

এটি একটি URL এর একটি উদাহরণ যা ব্যবহারকারীদের ডেজার্ট অনুসন্ধান করার পরে একটি অ্যাপে ফিরে যেতে দেয়৷ 

comgooglemaps-x-callback://?q=dessert&center=37.759748,-122.427135
   &x-success=sourceapp://?resume=true
   &x-source=Nom+Nom

আপনার অ্যাপে নেভিগেশন যোগ করা হচ্ছে

একটি দিকনির্দেশের অনুরোধ সহ iOS-এর জন্য Google মানচিত্র অ্যাপ চালু করা হল আপনার ব্যবহারকারীদের আপনার অ্যাপ থেকে পালাক্রমে নেভিগেশন অ্যাক্সেস দেওয়ার একটি সহজ উপায়। আপনি হয় comgooglemaps:// বা comgooglemaps-x-callback:// URL স্কিমগুলি ব্যবহার করতে পারেন৷

এই কোড স্নিপেট দেখায় কিভাবে comgooglemaps-x-callback:// স্কিম ব্যবহার করে দিকনির্দেশের অনুরোধ করতে হয় এবং তারপর আপনার ব্যবহারকারী প্রস্তুত হলে আপনার অ্যাপে ফিরে যান। কোড নিম্নলিখিত কাজ করবে:

  1. যাচাই করুন যে comgooglemaps-x-callback:// URL স্কিম উপলব্ধ।
  2. iOS-এর জন্য Google Maps অ্যাপ চালু করুন এবং নিউ ইয়র্ক শহরের JFK বিমানবন্দরের দিকনির্দেশের অনুরোধ করুন। ব্যবহারকারীর বর্তমান অবস্থান থেকে দিকনির্দেশের অনুরোধ করতে শুরুর ঠিকানাটি ফাঁকা রাখুন।
  3. iOS-এর জন্য Google Maps অ্যাপে "AirApp" লেবেলযুক্ত একটি বোতাম যোগ করুন। বোতাম লেবেল x-source পরামিতি দ্বারা সংজ্ঞায়িত করা হয়।
  4. ব্যবহারকারীরা যখন ব্যাক বোতামে ক্লিক করেন তখন কাল্পনিক URL স্কিম, sourceapp:// কল করুন।

সুইফট 

let testURL = URL(string: "comgooglemaps-x-callback://")!
if UIApplication.shared.canOpenURL(testURL) {
  let directionsRequest = "comgooglemaps-x-callback://" +
    "?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
    "&x-success=sourceapp://?resume=true&x-source=AirApp"

  let directionsURL = URL(string: directionsRequest)!
  UIApplication.shared.openURL(directionsURL)
} else {
  NSLog("Can't use comgooglemaps-x-callback:// on this device.")
}

উদ্দেশ্য-C 

NSURL *testURL = [NSURL URLWithString:@"comgooglemaps-x-callback://"];
if ([[UIApplication sharedApplication] canOpenURL:testURL]) {
  NSString *directionsRequest = @"comgooglemaps-x-callback://" +
      @"?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
      @"&x-success=sourceapp://?resume=true&x-source=AirApp";
  NSURL *directionsURL = [NSURL URLWithString:directionsRequest];
  [[UIApplication sharedApplication] openURL:directionsURL];
} else {
  NSLog(@"Can't use comgooglemaps-x-callback:// on this device.");
}

একটি Google মানচিত্র ডেস্কটপ URL থেকে iOS-এর জন্য Google মানচিত্র অ্যাপ চালু করা হচ্ছে

যদি আপনার অ্যাপের আগে থেকে বিদ্যমান Google Maps URL-এ অ্যাক্সেস থাকে, যেমন একটি ওয়েব পৃষ্ঠায় বা একটি ডাটাবেসে, আপনি এই স্কিমটি ব্যবহার করে iOS-এর জন্য Google Maps অ্যাপে URL খুলতে পারেন, এইভাবে আপনার ব্যবহারকারীদের সর্বোত্তম স্থানীয় অভিজ্ঞতা প্রদান করে .

  1. http:// অথবা https:// স্কিমটি comgooglemapsurl:// দিয়ে প্রতিস্থাপন করুন।
  2. আপনি যদি একটি কলব্যাক ব্যবহার করতে চান, x-source এবং x-success পরামিতি অন্তর্ভুক্ত করুন। এই স্কিমটি এক্স-কলব্যাক-ইউআরএল স্পেসিফিকেশন মেনে চলে।

সমর্থিত Google Maps URL ফরম্যাট

comgooglemapsurl:// স্কিম এই রেগুলার এক্সপ্রেশনের সাথে মেলে এমন URL গুলিকে সমর্থন করে, যেখানে {TLD} কোনো বৈধ টপ-লেভেল কান্ট্রি ডোমেনকে বোঝায়। স্পষ্টতার জন্য লাইন বিরতি যোগ করা হয়েছে: 

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

Google Maps অ্যাপের উপলভ্যতা পরীক্ষা করা হচ্ছে

প্রথমে যাচাই করুন যে iOS এর জন্য Google মানচিত্র অ্যাপটি ডিভাইসে উপলব্ধ, এবং URL স্কিম সমর্থন করে:

সুইফট 

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)

উদ্দেশ্য-C 

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemapsurl://"]];

উদাহরণ

একটি সাধারণ Google মানচিত্র URL এর উদাহরণ:

মূল Google মানচিত্র URL: 

https://www.google.com/maps/preview/@42.585444,13.007813,6z

URL স্কিম ব্যবহার করে: 

comgooglemapsurl://www.google.com/maps/preview/@42.585444,13.007813,6z

একটি সাধারণ Google মানচিত্র URL এর উদাহরণ:

আসল Google Maps URL: 

https://maps.google.com/?q=@37.3161,-122.1836

URL স্কিম ব্যবহার করে: 

comgooglemapsurl://maps.google.com/?q=@37.3161,-122.1836

এক্স-কলব্যাক সহ টোকিও টাওয়ারের দিকনির্দেশের অনুরোধ করার উদাহরণ:

আসল Google Maps URL: 

http://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1

নিম্নলিখিত উদাহরণটি iOS-এর জন্য Google Maps অ্যাপ চালু করবে এবং টোকিও টাওয়ারের দিকনির্দেশ সহ একটি মানচিত্র প্রদর্শন করবে, যেমনটি মূল Google মানচিত্রের URL (উপরে) উল্লেখ করা হয়েছে। অ্যাপটি "সোর্সঅ্যাপ" লেবেলযুক্ত একটি বোতামও প্রদর্শন করবে। যখন "সোর্সঅ্যাপ" বোতামটি ক্লিক করা হয়, iOS এর জন্য Google মানচিত্র অ্যাপটি একটি কাল্পনিক URL স্কিমে একটি কলব্যাক ইস্যু করবে, sourceapp://?resume=true । 

comgooglemapsurl://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1
    &x-source=SourceApp
    &x-success=sourceapp://?resume=true