3 puan yazan GN⁺ 2024-01-27 | 1 yorum | WhatsApp'ta paylaş

Placemark uygulamasına giriş

  • Placemark, coğrafi mekânsal verileri içe aktarma, oluşturma, dışa aktarma, görselleştirme ve yayımlama yapabilen bir web uygulamasıdır.
  • Çeşitli coğrafi mekânsal veri biçimlerini, algoritma tabanlı düzenleme işlemlerini (ör. buffering) ve çizim tabanlı işlemleri destekler.
  • Bu aracı kullanan çok sayıda YouTube videosu vardır ve arşivlenmiş web sitesinde önceki pazarlama materyalleri bulunur.

İlk açık kaynak sürümü için notlar

  • Bu, bu kod tabanının ilk açık kaynak sürümüdür; kurulum konusunda yardımcı olunabilir ancak uçtan uca entegrasyon desteği sağlanamaz.
  • Karmaşık bir web uygulamasıdır ve geliştirildiği ortamda çalışır, ancak her ortamda çalışması garanti değildir (ör. Windows'ta neredeyse kesin olarak çalışmaz).
  • Diğer ortamlarda kurulumu kolaylaştıran, özellikleri isteğe bağlı hale getiren ya da başka iyileştirme ve düzeltmeler içeren PR'ler memnuniyetle karşılanır.

Teknoloji yığını

  • Uygulamanın teknoloji yığınına dair notlar docs/architecture.md içinde bulunabilir.

Docker ile çalıştırma

  • Örnek Docker dosyaları vardır; ayrıntılar docs/docker içinde görülebilir.

Render üzerinde çalıştırma

  • render.yaml dosyasıyla yapılandırılır ve Render üzerinde barındırmak en hızlı çalıştırma yöntemi olabilir.
  • Railway, Heroku ve Flightcontrol gibi benzer barındırma kurulumlarında da çalışabilir.

Kurulum

  • Proje yarn kullanılarak inşa edilmiştir ve en son test edilen yarn sürümü 1.22.19'dur.
  • npm veya başka bir paket yöneticisiyle kurulum yapıldığında farklı bağımlılıklar ortaya çıkabilir.

Ortam değişkenleri

  • Geliştirme sırasında .env dosyası okunur, üretim ortamında ise ortam değişkenleri gerekir.
  • Başlatma sırasında ortam değişkenleri kontrol edildiğinden, eksik değişkenler varsa uygulama çökebilir.
  • Gerekli ortam değişkenlerinin listesi app/lib/env_server.ts ve app/lib/env_client.ts içinde bulunabilir.

Zorunlu ve isteğe bağlı ortam değişkenleri

  • Zorunlu: GitHub, Replicache
  • İsteğe bağlı: Posthog, Cloudflare, Postmark, WorkOS, Stripe, CampaignMonitor, Logtail
  • Kendi kendine barındırılan kurulumlarda Stripe gibi bazı hizmetler gerekmeyebilir ve bunları isteğe bağlı hale getirmek mümkündür.

Altyapı

  • Placemark, uygulama (bu depo) ve Postgres 14 (veya üstü) veritabanı olmak üzere iki sunucuya bağımlıdır.

Alan adları

  • Web üzerinde Placemark üç alan adı altında sunulur: app.placemark.io, api.placemark.io, API
  • API, uygulamayla aynı web sunucusunda sunulur ve Cloudflare Worker kullanılarak api.placemark.io üzerindeki istekler app.placemark.io'ya proxy'lenir.

Yerel SSL testi

  • Yalnızca SSL altında çalışan özellikleri test etmeniz gerektiğinde gereklidir (ör. iPhone'da coğrafi konum testi).
  • Tailscale'in tailscale cert komutunu kullanın, sertifikayı bu dizine taşıyın ve ardından caddy start çalıştırın.

Stripe kullanımı

  • Stripe bu projenin isteğe bağlı bir bağımlılığı hâline gelmektedir.
  • Webhook proxy'si ./_scripts/webhook-proxy.js içindedir ve isteğe bağlı olarak çalıştırılabilir.

GN⁺ görüşü

  • Placemark, coğrafi mekânsal verilerle çalışmak için gereken çeşitli işlevleri sunan güçlü bir web uygulamasıdır; GIS uzmanları veya geliştiriciler için faydalıdır.
  • Açık kaynak olarak sunulduğu için topluluk katkıları alabilir ve farklı ortamlarda kullanım için iyileştirilebilir.
  • Docker gibi konteyner araçlarıyla kolayca dağıtılıp çalıştırılabilir; ayrıca bulut barındırma hizmetleri üzerinden hızlıca dağıtılabilmesi önemli bir avantajdır.

1 yorum

 
GN⁺ 2024-01-27
Hacker News görüşleri
  • Bir kullanıcı geojson.io'yu yapmıştı; ara sıra kullandığım harika bir araç. GeoJSON testleri için çok iyi. Placemark'ın bir şirket olarak başarılı olamaması üzücü. Ama artık açık kaynak olarak sunulması harika.
  • geomob ekibi yaklaşık 2 yıl önce Tom MacWright ile bir podcast röportajı yapmıştı. O sırada Placemark'ı yeni piyasaya sürmüşlerdi.
  • Placemark açık kaynağa dönüştü ve hizmetini kapattı. (72 gün önce)
  • Bunu açık kaynak olarak sunduğunuz için teşekkürler. chattymaps alan adına sahibim ve orada harita tabanlı bir sohbet uygulaması planlıyorum. Placemark'a bakmak bu projeyi hızlandırabilir.
  • Keşke bu aracı kullanmamı gerektiren bir işim olsa. GIS araçları genelde bu kadar şık ve sezgisel olmuyor. Placemark üzerine yetkin bir veri görüntüleyici yapılabilir gibi görünüyor, ama bunu yapınca özelliklerin yarısı göz ardı edilmiş olur.
  • Bunu gerçekten kullanmış kişilerden bir şeyler duymak isterim. Hangi amaçla kullandıkları, mevcut araçların yerini alıp almadığı ya da yeni tür işlerde kullanılıp kullanılmadığı ilgimi çekiyor.
  • Çalışan bir demonun görülebileceği bir yer olup olmadığını merak ediyorum.
  • Çok şık bir proje. Kurucusu şu anda Val Town'ı oluşturmaya yardım ediyor. O da oldukça havalı görünüyor.
  • ArcGIS o kadar baskın ve iş akışlarına o kadar derinden yerleşmiş durumda ki, başka alanlardaki çalışanlar yeterli olmuyor. Böyle ürünlerin bir ekosisteme ve bir 'killer app'e ihtiyacı var.
  • umap-project.org ile bir tür karşılıklı kullanım ya da en azından dost proje ilişkisi olması ilginç olurdu.
  • G Suite uygulaması gibi görünebilecek harika bir haber.