‏MapKit JS 6؛ نقشهٔ اپل، بازسازی‌شده برای وب امروز

اپل تو این پست از تیم وب‌کیت، نسخهٔ ۶ MapKit JS رو معرفی می‌کنه؛ کتابخونه‌ای که قدرت و کیفیت نقشهٔ اپل رو میاره تو سایت و وب‌اپت. به گفتهٔ نویسنده، تمرکز این نسخه اینه که کار با MapKit JS رو دور الگوهای امروزی توسعهٔ وب مدرن کنه، و مقاله این تغییرها رو با ساخت یه اپ نمونه به اسم Yosemite Explorer نشون می‌ده.

دو تا تغییر بزرگ سر شروع کار: اول، لودر MapKit JS حالا یه پکیج npm‌ـه که مستقیم تو پایپ‌لاین‌های بیلد مدرن جا می‌گیره و تایپ‌های TypeScript رو هم خودکار میاره. دوم، راه‌اندازی توکن خیلی ساده‌تر شده — می‌تونی از یه توکن ثابت که به دامنهٔ سایتت مقید شده استفاده کنی، بدون مدیریت کلید خصوصی یا self-signing:

import { load } from "@apple/mapkit-loader";

const mapkit = await load({
    libraries: ["map", "services", "annotations"],
    token: "your-token-here"
});

بقیهٔ تغییرها هم همه یه جهت دارن: مدرن‌شدن. مثلاً PlaceLookup حالا Promise برمی‌گردونه، پس می‌تونی یه Place ID بدی، نتیجه رو await کنی و تو یه جریان واحد annotation بسازی. مدیریت رویدادها هم روی مدل استاندارد EventTarget مرورگر سواره، یعنی با addEventListener مثل هر رویداد DOM دیگه کار می‌کنی:

map.addEventListener("select", (event) => {
    const selected = event.annotation;
    setListSelected(selected.id);
});

MapKit JS ویژگی‌هاش رو به کتابخونه‌های جدا تقسیم می‌کنه، پس فقط چیزی رو که لازم داری لود می‌کنی تا بهترین کارایی رو بگیری. با PlaceAnnotation هم می‌تونی نقاط دیدنی رو با عنوان و آیکون و مختصاتِ خودکار از دیتای اپل نشون بدی. جمع‌بندی نویسنده اینه که این تغییرها با هم، آوردن نقشهٔ اپل به سایت رو به بخشی طبیعی از فرایند توسعه تبدیل می‌کنن.

نکات کلیدی:

• MapKit JS 6 اِس‌دی‌کِی نقشهٔ اپل رو دور الگوهای مدرن وب بازسازی کرده
• نصب به‌صورت پکیج npm با تایپ خودکار TypeScript
• توکن ثابتِ مقید به دامنه، بدون مدیریت کلید خصوصی
• Promiseهای بومی و مدل استاندارد EventTarget برای رویدادها
• تقسیم ویژگی‌ها به کتابخونه‌ها برای لود فقط چیزی که لازمه