ArcGIS REST Servis Gezgini

ArcGIS REST servis dizini nedir

ArcGIS Server ve ArcGIS Enterprise, yayımlanan her harita, obje ve görüntü servisini bir REST arayüzüyle sunar. Bu arayüzün kökü genellikle …/arcgis/rest/services biçimindedir ve altında klasörler, servisler (MapServer, FeatureServer, ImageServer ve diğerleri) ile bu servislerin katman ve tabloları yer alır. ArcGIS Online'da barındırılan obje katmanları da aynı yapıyı izler. Her kaynak, adresine ?f=json eklendiğinde kendini makine tarafından okunabilir biçimde tanımlar: adı, geometri tipi, koordinat sistemi, alanları ve desteklediği işlemler.

Bu gezgin, o JSON tanımlarını okuyup düzenli bir ağaç ve özet tablolar hâline getirir. Bir servisin hangi katmanlardan oluştuğunu görmek, bir alanın tipini ya da kodlu değerlerini kontrol etmek, obje sayısını öğrenmek ve katmanı haritada hızlıca önizlemek için REST sayfalarında tek tek gezinmek gerekmez.

Nasıl kullanılır

1. Adres kutusuna bir services dizini, klasör, servis ya da tek katman adresi yapıştır. Örneğin …/rest/services, …/rest/services/Klasor/Servis/MapServer ya da …/FeatureServer/0. Adresin sonundaki ?f=pjson gibi ekler sorun olmaz.
2. Servisi Oku düğmesine bas. Klasör ve servisler ağaçta listelenir; bir klasöre ya da servise tıklayınca içeriği yüklenir. Grup katmanları alt katmanlarıyla birlikte gösterilir.
3. Bir katman ya da tablo seç. Ayrıntı panelinde ad, tür, geometri tipi, koordinat sistemi (wkid ve latestWkid), kapsam, maxRecordCount, yetenekler, sürüm ve obje sayısı; altta ise alan tablosu görünür. Harita, kesikli çizgiyle katmanın kapsamına yakınlaşır.
4. İstersen where ifadesiyle filtre yaz ve yalnız ihtiyaç duyduğun alanları seç. Haritada Önizle ile objeler sayfa sayfa yüklenir; ilerleme çubuğu kaç objenin geldiğini gösterir. Haritada bir objeye tıklayınca öznitelikleri açılır.
5. Yüklenen kayıtları GeoJSON, CSV ya da KML olarak indir.

Filtre, sayfalama ve kayıt sınırı

Where alanı, servisin sorgu işlemine doğrudan iletilen SQL benzeri bir koşuldur. Sayılar için POP2000 > 100000, metinler için tek tırnakla STATE_NAME = 'Texas' gibi yazılır. Alan adları, alan tablosundaki adlarla aynı olmalıdır. Koşulu değiştirdikten sonra # düğmesiyle obje sayısını güncelleyebilirsin.

Servisler bir istekte en fazla maxRecordCount kadar obje döndürür. Araç bu sınırı aşmak için sayfalama kullanır: servis destekliyorsa resultOffset ve resultRecordCount ile ObjectID sırasında ilerler, desteklemiyorsa önce ObjectID listesini alıp objeleri parça parça ister. Varsayılan üst sınır 2.000 objedir ve 10.000'e kadar artırılabilir. Daha büyük katmanları where ifadesiyle bölerek indirmek hem senin tarayıcın hem de servis için daha sağlıklıdır.

Dışa aktarma biçimleri

• GeoJSON: Koordinatlar WGS84 (EPSG:4326) boylam, enlem sırasındadır. Servis GeoJSON çıktısını destekliyorsa doğrudan kullanılır; desteklemiyorsa Esri JSON yanıtı tarayıcıda GeoJSON'a çevrilir. Bu çeviride çokgenlerin dış halka ve delikleri halka yönüne göre ayrılır.
• CSV: Seçili alanlar sütun olur. Geometri tek bir WKT sütununa yazılır; nokta katmanlarında bunun yerine X (boylam) ve Y (enlem) sütunları seçilebilir. Tarih alanları ISO 8601 biçimine çevrilir. Dosya, Türkçe karakterlerin elektronik tabloda doğru görünmesi için UTF-8 BOM ile kaydedilir.
• KML: Her obje bir Placemark olur; adı katmanın gösterim alanından gelir, öznitelikler ExtendedData içinde yer alır.

Güvenli servisler ve token

Herkese açık olmayan servisler 499 (Token Required) yanıtı döndürür. Erişim yetkin varsa kendi portalından ya da sunucundan aldığın token'ı isteğe bağlı token alanına girebilirsin. Token yalnız bellekte tutulur, istek gövdesinde yalnız girdiğin sunucuya gider ve ekranda gösterilen adreslere eklenmez. Kurumlarda güvenli servislerin kime, hangi süreyle ve hangi uygulamalar üzerinden açılacağı, token'ların nasıl üretilip yenileneceği ayrı bir yönetim konusudur; bu işin proxy ve token katmanında nasıl ele alınabileceğine Proxy Token Manager sayfasında değiniyoruz.

Veri ve yöntem

Araç, ArcGIS REST API'nin standart uç noktalarını kullanır: dizin, servis ve katman tanımları için f=json, obje sayısı için returnCountOnly, kapsam için returnExtentOnly, önizleme için outSR=4326 ile query işlemi. Tüm istekler tarayıcından doğrudan girdiğin sunucuya gider; Rodosto sunucusundan geçmez. Bu nedenle sunucunun tarayıcı isteklerine (CORS) izin vermesi gerekir. Simgeler Lucide (ISC lisansı) kütüphanesindendir. Altlık haritalar Esri ve OpenStreetMap katkıcılarına aittir. Kullanılan açık kaynak kütüphaneler ve lisansları: Veri Kaynakları.

Sınırlar

• CORS ve iç ağ: Tarayıcı isteklerine kapalı ya da yalnız kurum ağından erişilen sunucular bu sayfadan okunamaz. Araç bu durumu ayrıca belirtir.
• HTTP adresler: Sayfa HTTPS üzerinden açıldığı için http ile başlayan adresler önce https ile denenir. Sunucunun HTTPS desteği yoksa tarayıcı isteği engeller.
• Görsel servisler: ImageServer ve önbellekli harita servislerinde ayrıntılar ve kapsam gösterilir; piksel verisi indirilmez.
• Kullanım hakkı: Bir servisin herkese açık olması verinin her amaçla kullanılabileceği anlamına gelmez. Veriyi yalnız kullanma hakkın olan servislerden indir; servis sahibinin kullanım koşulları geçerlidir.

Kurumsal çalışmalar için

Servislerin hangi bileşen üzerinde yayımlandığını ve portal ile sunucunun birlikte nasıl çalıştığını ArcGIS Enterprise nedir rehberinde bulabilirsin. Kurum içinde servis yayımlama altyapısı kurmayı planlıyorsan ArcGIS Enterprise kurulum sayfasına göz atabilirsin.