پرش به محتوای اصلی
Vue Neshan Mapsراهنمای توسعه‌دهندگان

هیت‌مپ وزنی

تراکم را با منبع وزنی مستقل از خوشه‌ها نمایش دهید.

۳ دقیقه مطالعهVue 3 / Nuxt 4همراه مثال زنده
مطالب این صفحهنمونهٔ کامل خوشه‌بندی و هیت‌مپ
مثال تعاملیMapLibre

اجرا روی نقشهٔ واقعی نشان

کلید وب با مجوز دامنه وارد کنید. هندسه نمونه است؛ نقشهٔ پایه واقعی است.

دامنهٔ sajadjanat.github.io را مجاز کنید. کلید فقط در حافظه می‌ماند و وارد کد کپی‌شده نمی‌شود.

‏نمونهٔ کامل خوشه‌بندی و هیت‌مپ#

vue
<script setup lang="ts">
import { ref } from 'vue'
import { NeshanMapLibre, type Coordinates, type MapResourceFailure } from 'vue-neshan-maps'
import 'vue-neshan-maps/style.css'
import 'vue-neshan-maps/fonts/vazir.css'
const webKey = import.meta.env.VITE_NESHAN_WEB_KEY
const center = ref<Coordinates>([35.72, 51.36])
const zoom = ref(12)
const clustered = ref(true), heat = ref(false)
const map = ref<InstanceType<typeof NeshanMapLibre>>()
const failure = ref<MapResourceFailure>()
const data = ref<GeoJSON.FeatureCollection>({
  type: 'FeatureCollection',
  features: Array.from({ length: 1000 }, (_, id) => ({
    type: 'Feature', id, properties: { weight: 1 + id % 5 },
    geometry: { type: 'Point', coordinates: [51.36 + Math.sin(id * 2.4) * 0.05, 35.72 + Math.cos(id * 1.7) * 0.04] },
  })),
})
const clusterOptions = { radius: 55, maxZoom: 14, minPoints: 2, expandOnClick: true }
const heatOptions = { weightProperty: 'weight', radius: 30, intensity: 0.9, opacity: 0.65 }
function replaceData() {
  data.value = { ...data.value, features: data.value.features.slice(0, 500) }
}
</script>
<template>
  <section class="neshan-font-vazir" lang="fa" dir="rtl">
    <label><input v-model="clustered" type="checkbox">خوشه‌بندی</label>
    <label><input v-model="heat" type="checkbox">هیت‌مپ</label>
    <button @click="replaceData">نمایش ۵۰۰ نقطهٔ نمونه</button>
    <p v-if="failure" role="alert">{{ failure.kind }}: {{ failure.message }}</p>
    <NeshanMapLibre ref="map" v-model="center" v-model:zoom="zoom" :api-key="webKey"
      :geojson="data" :cluster="clustered ? clusterOptions : false"
      :heatmap="heat ? heatOptions : false" traffic poi :center-marker="false"
      :styles="{ height: '550px' }" @resource-error="failure = $event" />
  </section>
</template>

‏نقاط بالا دادهٔ نمونه‌اند و از نشان دریافت نشده‌اند. مختصات عمومی کامپوننت به ترتیب عرض و طول است؛ داخل GeoJSON ترتیب طول و عرض است.

‏خوشه‌بندی روی نقاط geojson انجام می‌شود؛ مارکرهای DOM در آرایهٔ markers خوشه‌بندی نمی‌شوند. برای تعداد زیاد مکان‌ها از GeoJSON استفاده کنید. تنظیم قبلی geojsonOptions.cluster همچنان کار می‌کند؛ اگر پراپ cluster را صریح بدهید، اولویت با آن است.

‏گزینهٔ خوشه‌بندی ‏رفتار و پیش‌فرض
radius ‏شعاع پیکسلی؛ پیش‌فرض ۵۰
maxZoom ‏آخرین زوم خوشه‌بندی؛ پیش‌فرض ۱۴
minPoints ‏حداقل نقطه برای تشکیل خوشه؛ پیش‌فرض ۲
expandOnClick ‏بزرگ‌نمایی با کلیک؛ پیش‌فرض روشن
color, pointColor, textColor ‏رنگ خوشه، نقطهٔ مستقل و عدد خوشه

‏رویداد cluster-click اطلاعات { clusterId, pointCount, coordinates } را می‌دهد. برای کنترل اختصاصی، expandOnClick را خاموش کنید. دو متد زیر Promise برمی‌گردانند:

ts
const leaves = await map.value!.getClusterLeaves(clusterId, 20, 0)
const expansionZoom = await map.value!.expandCluster(clusterId, [35.72, 51.36])

‏شناسهٔ خوشه پس از تغییر داده یا بازسازی استایل ممکن است عوض شود. پیش از پرس‌وجو دربارهٔ خوشهٔ جدید، منتظر آماده‌شدن منبع بمانید. مرکز اختیاری به ترتیب عرض و طول است؛ دادهٔ برگشتی برگ‌ها GeoJSON است.

‏در هیت‌مپ، weightProperty نام ویژگی وزن است؛ مقدار ناموجود یا غیرعددی صفر و مقدار منفی به صفر محدود می‌شود. بدون این گزینه، وزن همهٔ نقاط یک است. پیش‌فرض‌ها: شعاع ۲۴ پیکسل، شدت ۱، شفافیت ۰٫۸ و حداکثر زوم ۲۲. هیت‌مپ منبع جدا و بدون خوشه‌بندی دارد تا همراه خوشه‌ها هم تراکم واقعی همهٔ نقاط را نشان دهد. این کار یک نسخهٔ دوم از داده در Worker می‌سازد؛ برای دادهٔ بسیار حجیم فقط نمای موردنیاز را روشن کنید.

‏پراپ geojsonLayers ظاهر معمول نقطه، خط و چندضلعی را جایگزین می‌کند؛ لایه‌های خودکار خوشه و هیت‌مپ جدا اضافه می‌شوند.

کتابخانهٔ مستقل جامعهٔ توسعه‌دهندگان؛ سرویس و انتساب نقشه متعلق به نشان و OpenStreetMap است. · Sajad Janat · MIT