map
Harita üzerindeki yerler: yakındaki mağazalar, bir rota, kuryenin nerede olduğu.
Neyin nerede olduğu. map, harita üzerine her biri kısa bir etikete sahip en fazla on raptiye yerleştirir — son kullanıcının yakınındaki mağazalar, bir rotanın durakları, kuryenin şu anda nerede olduğu.
Sayfada harita raptiyelerin sabit bir görüntüsüdür; bir dokunuş haritayı tam ekran açar, burada kaydırılıp yakınlaştırılabilir ve Haritalar'da aç seçeneğini sunar. SDK'lar bunu, OpenFreeMap'in sunduğu OpenStreetMap açık harita verileri üzerinde MapLibre ile çizer; hiçbir harita sağlayıcısı, kendisinden istenen karolar dışında hiçbir şey görmez.
Ekran görüntüsü değildir; tarayıcınızda SDK'nın kendi boyut ve renkleriyle canlı olarak çizilir.
Flutter SDK ile 0.43.0 ve Web SDK ile 0.20.0 sürümünden itibaren yerel olarak render edilir. Bunu bildirmeyen bir derlemeye asla sunulmaz.
Flutter 0.43 ve sonraki sürümler, maplibre_gl için Flutter 3.29 / Dart 3.7'ye ve Android'de JDK 21'e ihtiyaç duyar. Web'de, bir Content-Security-Policy gönderen sitenin connect-src https://tiles.openfreemap.org ve worker-src blob: izinlerini de vermesi gerekir, aksi takdirde harita boş çizilir; bkz. Web SDK.
Sunucunun kontrol ettikleri
Her raptiyenin koordinatları, aksiyonlarınızdan birinin döndürdüğü sonuçla tam olarak aynı olmalıdır. Model asla bir harita görüntüsü veya bir karo adresi vermez.
Props
Her blok ayrıca type ve 1 ila 300 karakterden oluşan zorunlu bir fallback_text taşır.
| Prop | Tür | Zorunlu | Kısıtlamalar |
|---|---|---|---|
pins | array | Evet | 1 ila 10 öğe. |
pins[].lat | number | Evet | -90 ila 90. |
pins[].lng | number | Evet | -180 ila 180. |
pins[].label | string | Evet | 1 ila 60 karakter. |
pins[].subtitle | string | Hayır | En fazla 80 karakter. |
caption | string | Hayır | En fazla 120 karakter. |
Ağ üzerinde
{
"id": "blk_87",
"type": "map",
"fallback_text": "Two stores near you: Kalverstraat (1.2 km) and De Pijp (2.8 km).",
"props": {
"pins": [
{
"lat": 52.3702,
"lng": 4.8913,
"label": "Kalverstraat",
"subtitle": "1.2 km · open until 20:00"
},
{
"lat": 52.3546,
"lng": 4.8932,
"label": "De Pijp",
"subtitle": "2.8 km · open until 18:00"
}
],
"caption": "Neon Kicks stores with your size in stock."
}
}Etkileşim
Harita sayfada hareket etmez, bu nedenle sayfanın kaydırılmasıyla asla çakışmaz. Bir dokunuş haritayı tam ekran açar: burada kaydırılabilir ve yakınlaştırılabilir, dokunulan bir raptiye etiketini ve alt başlığını gösterir ve Haritalar'da aç, o raptiyeyi veya ilkini harita uygulamasında açar. Haritanın çizilemediği durumlarda raptiyeler satırlar halinde listelenir ve her biri yine harita uygulamasında açılır. Raptiyeler aksiyonlarınızın sonuçlarından gelmelidir.