টাইল লেয়ার

প্ল্যাটফর্ম বেছে নিন: Android iOS JavaScript

আপনি টাইল লেয়ার হিসেবে আপনার ম্যাপের উপরে ছবি যোগ করতে পারবেন। টাইল লেয়ার নির্দিষ্ট জুম লেভেলে ম্যাপ টাইলের উপরে প্লেস করা হয়। পর্যাপ্ত টাইল থাকলে, আপনি একাধিক জুম লেভেলে, সম্পূর্ণ ম্যাপের জন্য Google-এর ম্যাপ ডেটা পরিপূরণ করতে পারবেন।

ভূমিকা

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

আপনি যখন ম্যাপে সাধারণত বড় ভৌগোলিক এলাকা কভার করে এমন বিস্তৃত ছবি যোগ করতে চান, তখন টাইল লেয়ার উপযোগী হয়। অন্যদিকে, ম্যাপের কোনও একটি পয়েন্টে একটি ছবি ফিক্স করতে চাইলে, গ্রাউন্ড ওভারলে ব্যবহার করা সুবিধাজনক।

টাইল স্থানাঙ্ক

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

মার্কেটর প্রজেকশনের Google ইমপ্লিমেন্টেশনে, (০,০) কোঅর্ডিনেট সহ টাইলটি সবসময় ম্যাপের উত্তর-পশ্চিম কোণে থাকে, যেখানে x-এর মান পশ্চিম থেকে পূর্ব দিকে এবং y-এর মান উত্তর থেকে দক্ষিণ দিকে বৃদ্ধি পায়। সেই উৎস থেকে x,y কোঅর্ডিনেট ব্যবহার করে টাইল ইন্ডেক্স করা হয়। যেমন, জুম লেভেল ২-এ, যখন পৃথিবীকে ১৬টি টাইলসে ভাগ করা হয়, তখন প্রতিটি টাইলসকে একটি অনন্য x,y পেয়ার দ্বারা রেফারেন্স করা যেতে পারে:

চারটি সারি ও চারটি কলামের টাইলসে বিভক্ত পৃথিবীর ম্যাপ।

প্রতিটি ম্যাপ টাইল হল ২৫৬x২৫৬ পয়েন্টের বর্গক্ষেত্র। জুম লেভেল ০-তে, পুরো পৃথিবী একটি টাইল হিসেবে রেন্ডার করা হয়। প্রতিটি জুম লেভেল ম্যাগনিফিকেশনকে দুইয়ের গুণিতক হিসেবে বাড়ায়। যেমন, জুম লেভেল ১-এ ম্যাপ ২x২ গ্রিড টাইল হিসেবে, জুম লেভেল ২-এ ৪x৪ গ্রিড টাইল হিসেবে এবং জুম লেভেল ৩-এ ৮x৮ গ্রিড টাইল হিসেবে রেন্ডার করা হয়। টাইল লেয়ারের জন্য ছবি তৈরি করতে, আপনি যে জুম লেভেল দেখাতে চান, তার প্রতিটি টাইলসের জন্য ২৫৬x২৫৬ পয়েন্টের ছবি তৈরি করুন।

টাইল লেয়ার যোগ করুন

  1. GMSURLTileLayer অবজেক্ট বা GMSTileLayer বা GMSSyncTileLayer-এর কাস্টম সাবক্লাস ইনস্ট্যান্টিয়েট করুন।
  2. অন্যান্য টাইল লেয়ারের সাথে সম্পর্কিত পজিশন অ্যাডজাস্ট করতে, ঐচ্ছিকভাবে zIndex প্রপার্টি পরিবর্তন করুন।
  3. map প্রপার্টি সেট করে ম্যাপে GMSTileLayer অবজেক্ট অ্যাসাইন করুন।

iOS-এর জন্য Maps SDK তিনটি ক্লাস প্রদান করে যা টাইল লেয়ার প্রয়োগ করতে ব্যবহার করা যেতে পারে। প্রতিটি ক্লাসের সাথে, আপনাকে নির্দিষ্ট {x,y,zoom} স্থানাঙ্কের সেটের জন্য সঠিক ম্যাপ টাইল কীভাবে আনতে হবে তা নির্ধারণ করতে হবে। উপলভ্য বিকল্পগুলি হল:

  • সাবক্লাস GMSSyncTileLayer, tileForX:y:zoom-এর ইমপ্লিমেন্টেশন প্রদান করে যা UIImage ইনস্ট্যান্স রিটার্ন করে।
  • সাবক্লাস GMSTileLayer, অ্যাসিঙ্ক্রোনাস পদ্ধতির requestTileForX:y:zoom ইমপ্লিমেন্টেশন প্রদান করে যা পরে টাইল ইমেজের সাথে কলব্যাক করে।
  • GMSTileURLConstructor ব্লক প্রদান করে, URL থেকে অটোমেটিক টাইল ফেচ করতে, আগে থেকে থাকা ক্লাস, GMSURLTileLayer ব্যবহার করুন। GMSURLTileLayer হল একটি কনক্রিট ক্লাস যার সাবক্লাস তৈরি করা যাবে না।

GMSSyncTileLayer বা GMSTileLayer-এর সাবক্লাসিংয়ের ক্ষেত্রে, nil টাইল ফলাফল প্রদান করলে, iOS-এর জন্য Maps SDK-কে জানানো হবে যে ডেটা উপলভ্য নেই, তবে ভবিষ্যতে উপলভ্য হতে পারে। অন্যথায়, এই লোকেশনে কোনও টাইল নেই তা বোঝাতে kGMSTileLayerNoTile রিটার্ন করুন।

GMSURLTileLayer-এর জন্য, GMSTileURLConstructor থেকে nil রিটার্ন করলে বোঝা যাবে যে এই লোকেশনে কোনও টাইল নেই।

URL থেকে টাইল ফেচ করতে GMSURLTileLayer ব্যবহার করুন

GMSURLTileLayer-এর জন্য সাবক্লাসিংয়ের প্রয়োজন নেই, তবে আপনাকে GMSTileURLConstructor ব্লক প্রয়োগ করতে হবে। নিচের কোড থেকে জানতে পারবেন যে কীভাবে GMSURLTileLayer ব্যবহার করে বহুতল বিল্ডিংয়ের মেঝের পরিকল্পনা দেখানো যায়।

Swift

let floor = 1

// Implement GMSTileURLConstructor
// Returns a Tile based on the x,y,zoom coordinates, and the requested floor
let urls: GMSTileURLConstructor = { (x, y, zoom) in
  let url = "https://www.example.com/floorplans/L\(floor)_\(zoom)_\(x)_\(y).png"
  return URL(string: url)
}

// Create the GMSTileLayer
let layer = GMSURLTileLayer(urlConstructor: urls)

// Display on the map at a specific zIndex
layer.zIndex = 100
layer.map = mapView

Objective-C

NSInteger floor = 1;

// Create the GMSTileLayer
GMSURLTileLayer *layer = [GMSURLTileLayer tileLayerWithURLConstructor:^NSURL * _Nullable(NSUInteger x, NSUInteger y, NSUInteger zoom) {
  NSString *url = [NSString stringWithFormat:@"https://www.example.com/floorplans/L%ld_%lu_%lu_%lu.png",
                   (long)floor, (unsigned long)zoom, (unsigned long)x, (unsigned long)y];
  return [NSURL URLWithString:url];
}];

// Display on the map at a specific zIndex
layer.zIndex = 100;
layer.map = mapView;

UIImage হিসেবে টাইল পরিবেশন করতে GMSSyncTileLayer সাবক্লাস করুন

GMSSyncTileLayer এবং GMSTileLayer হল অ্যাবস্ট্র্যাক্ট ক্লাস যা সাবক্লাস করার জন্য ডিজাইন করা হয়েছে। UIImage-এর মতো টাইল দেখাতে আপনি এইসব ক্লাস ব্যবহার করতে পারবেন। নিচের উদাহরণে দেখানো হয়েছে যে GMSSyncTileLayer-এর সাবক্লাস তৈরি করে ম্যাপের কিছু টাইলসের উপর কীভাবে কাস্টম ছবি রেন্ডার করতে হয়।

Swift

class TestTileLayer: GMSSyncTileLayer {
  override func tileFor(x: UInt, y: UInt, zoom: UInt) -> UIImage? {
    // On every odd tile, render an image.
    if (x % 2 == 1) {
      return UIImage(named: "australia")
    } else {
      return kGMSTileLayerNoTile
    }
  }
}

Objective-C

@interface TestTileLayer : GMSSyncTileLayer
@end

@implementation TestTileLayer

- (UIImage *)tileForX:(NSUInteger)x y:(NSUInteger)y zoom:(NSUInteger)zoom {
  // On every odd tile, render an image.
  if (x % 2 == 1) {
    return [UIImage imageNamed:@"australia"];
  } else {
    return kGMSTileLayerNoTile;
  }
}

@end

আপনার ম্যাপে লেয়ার যোগ করতে, অবজেক্ট ইনস্ট্যান্টিয়েট করুন এবং এর ম্যাপ প্রপার্টি সেট করুন।

Swift

let layer = TestTileLayer()
layer.map = mapView

Objective-C

GMSTileLayer *layer = [[TestTileLayer alloc] init];
layer.map = mapView;

Retina ডিভাইসের জন্য হাই DPI টাইলস

আপনি GMSSyncTileLayer অথবা GMSURLTileLayer-এর সাথে হাই DPI ছবি ব্যবহার করতে পারবেন, এর জন্য tileSize-কে ৫১২-এ সেট করতে হবে। tileSize প্রপার্টি থেকে জানা যায় যে রিটার্ন করা টাইল ইমেজ কত পিক্সেল হিসেবে দেখানো হবে; এটি ডিফল্ট হিসেবে ২৫৬ পিক্সেল থাকে — নন-রেটিনা ডিভাইসে Google Maps টাইলের সাইজ।

আপনি যদি হাই DPI ডিভাইসে সাধারণ DPI টাইল দেখান, তাহলে tileSize-কে ৫১২-এ সেট করে ছবির সাইজ বাড়াতে পারবেন। মনে রাখবেন, ছবির সাইজ বড় করলে ছবির কোয়ালিটি খারাপ হতে পারে, বিশেষ করে সূক্ষ্ম লাইন বা টেক্সটের ক্ষেত্রে। সেরা ফলাফলের জন্য, ডিসপ্লের সাথে tileSize এবং ছবির DPI ম্যাচ করুন। Retina ডিভাইসে দেখানো ম্যাপ সবচেয়ে ভাল দেখাবে যখন ৫১২-এর tileSize সহ হাই DPI ছবি দেখানো হবে; যদিও নন-Retina ডিভাইসে দেখানো ম্যাপ সাধারণ ছবি এবং ২৫৬-এর ডিফল্ট tileSize সহ ভাল দেখাবে।

পুরনো টাইল মুছুন

লেয়ারের মাধ্যমে প্রদান করা টাইল 'পুরনো' হয়ে গেলে, রিফ্রেশ করার জন্য লেয়ারে clearTileCache পদ্ধতি কল করতে হবে। এর ফলে এই লেয়ারের সব টাইল আবার লোড হবে।

Swift

layer.clearTileCache()

Objective-C

[layer clearTileCache];