Positionstack API ile Kurumsal Düzeyde Coğrafi Kodlamayı Ücretsiz Alın (İNCELEME)

Coğrafi kodlamadan değer elde etmek için Google Haritalar olmanız gerekmez. Ayrıca Positionstack sayesinde, bunu yapmak için Big G'nin teknik bütçesine de ihtiyacınız yok. Bugün, kurumsal düzeyde ileri ve geri coğrafi kodlamayı hem son derece uygun fiyatlı hem de kullanılabilir hale getirmeyi amaçlayan Positionstack'in güçlü API'sini inceliyoruz.

Pozisyon yığını 101

Öyleyse, Positionstack'te 2.000'den fazla kelimelik bir incelemeyi neden okuma zahmetine giresiniz ve ne kazanacaksınız? Cevap sevimli geliyor, ama doğru değil: tüm dünyayı .

Bir an için dünya haritasında kaç tane yer olduğunu düşünün. Şimdi, bu sayıyı, işletmenizin bu yerler hakkında bilmesi gereken her meta veri parçasıyla çarpın. Positionstack'in sunduğu şey bu, ve sonra bazıları.

Positionstack ile ilgili bazı hızlı istatistiklere bakalım:

• Her gün, her saat işlenen gerçek milyarlarca coğrafi kodlama arama isteği; %100 çalışma süresi ve < 100ms="" yanıt=""> ile
• Bulut tabanlı, yüksek düzeyde ölçeklenebilir altyapı
• Dünyadaki her ülkeye ilişkin gerçek zamanlı veriler, birkaç saatte bir güncellenen devasa bir veri kümesinde derlenir
• Cömertçe dağıtılmış, rekabetçi fiyatlı abonelik planları; artı Ücretsiz kullanıcılar için rakipsiz 10.000 istek aylık kota
• Tüm büyük programlama dilleri için entegrasyon desteği
• Kod parçacıklarıyla eksiksiz, kapsamlı, okunması kolay belgeler
• Zendesk, Slack, LinkedIn, Lyft, Apple ve Amazon gibi müşterilere hizmet verme deneyimine sahip birinci sınıf bir müşteri memnuniyeti ekibi

Positionstack'in soyağacı kesinlikle kontrol altında, ancak bir avuç madde işaretiyle ikna olmamanız durumunda, API'yi gerçekten kullanmanın nasıl bir şey olduğuna derin bir dalış yapalım.

Positionstack'in 3 Adımlı Hızlı Başlangıç ​​Kılavuzu

Web sitelerinde herhangi bir zaman geçirirseniz, Positionstack'in API'lerinin birincil satış noktası olarak kullanım kolaylığını gerçekten vurguladığını göreceksiniz. Kayıt işlemi sırasında, bunun oldukça doğru olduğunu hemen göreceksiniz. Aslında, hesap kimlik bilgilerinizi yazdıktan sonra gördüğünüz ilk şey, üç kolay adımda Positionstack'i kullanmaya başlamanız ve çalıştırmanız için gerekenlere dair hızlı bir yol haritasıdır. Hadi bir bakalım:

1. API erişim anahtarınızı ayarlayın – Varsayılan olarak, kutudan çıkmaya hazır bir erişim anahtarı alırsınız. Ancak, gerektiğinde bunu kolayca sıfırlayabilirsiniz.
2. API uç noktalarını seçin – Sonraki bölümde API uç noktalarını daha ayrıntılı olarak ele alacağız, ancak şimdilik bu adımın, uygulamanız Positionstack'e bir istekte bulunduğunda ne tür verilerin döndürüleceğinin yapılandırılmasıyla ilgili olduğunu anlıyoruz. Burada ilk olarak, isteklerinizi hedeflediğiniz temel URL'yi göreceksiniz, ancak bu aynı zamanda belgelerde de görünüyor. Son olarak, yalnızca birkaç kolay kod satırından oluşan örnek bir API isteği görüyoruz.
3. Uygulama entegrasyonu – Son adım, Positionstack'in API'sinin uygulamanıza son entegrasyonunu ifade eder. Bu süreç hakkında bilinmesi gereken çok şey var ve bunların çoğu belgelerde yer alıyor. Burada önemli olan şudur: Positionstack'in destek ekibi arkanızdadır ve API'lerini yapılandırmak ve uygulamanıza entegre etmek için ihtiyaç duyduğunuz kadar çok veya az yardım sunacaktır.

Oldukça kolay değil mi? API'ler, ilk başta kapsamlı BT bilgisi olmayan kişiler için korkutucu görünebilir. Ancak, en başından, Positionstack kolay olduğu bilgisiyle sizi rahatlatır, aynı zamanda akıllı tasarımlarının inanılmaz belgeleriyle yol boyunca size yardımcı olur. Size yardımcı olmaya hazır tutkulu bir uzman ekibine sahip olmalarına yardımcı olur.

Positionstack Panonuz

Temel kullanıcı dostu olma değerini ikiye katlayan Positionstack, API'niz hakkında bilmeniz gereken her şeye erişebileceğiniz modern ve düzenli bir Pano sunar. Kenar çubuğu seçeneklerine bir göz atalım:

• Gösterge Tablosu – Burada bildirimler bulacaksınız (genellikle belirli kullanım eşiklerini geçtiğinizde sizi uyarır), ardından hem 3 Adımlı Hızlı Başlangıç ​​Kılavuzu'na hem de Belgeler sayfasına bağlantılar. Ayrıca API anahtarınıza, mevcut aboneliğinize, hesap ayrıntılarınıza ve ödeme yönteminize ilişkin bir genel bakış da bulunmaktadır.
• Yükseltme/Abonelik – Aboneliğinizi bu iki seçenekten biriyle değiştirebilirsiniz. İstediğiniz zaman yükseltin, ancak her iki yönde de aylık veya yıllık plan arasında geçiş yapmak istiyorsanız, önce Ücretsiz hesaba geçmeniz, ardından istediğiniz seçeneği belirlemeniz gerekir. Bunu yapmak için yardıma ihtiyacınız olursa Positionstack desteği size yardımcı olmaya hazırdır.
• Hesap/Ödeme – Bunlar açıklayıcıdır; her iki sekme de kimlik bilgilerinizi istediğiniz zaman güncellemenize olanak tanır. Bu temel kontrolleri aşırı tasarlanmış, gösterişli bir arayüze gömmediklerini takdir ettiğimizi söylememiz gerekir. WYSIWYG.
• API Kullanımı – Muhtemelen en sık tekrar ziyaret edeceğiniz sekmedir, burada şimdiye kadar aylık istek kotanızın ne kadarını tükettiğinizi bulabilirsiniz. Ayrıca, zaman içindeki kullanım istatistiklerinizi gösteren kullanışlı bir bölüm de vardır, böylece stratejinizi buna göre ayarlayabilirsiniz.

API Belgeleri

Şimdi Positionstack'in teklifinin özüne ve ruhuna geliyoruz: API belgeleri . Bu sayfayı, her bir API uç noktasının, parametrelerinin ve ne tür bilgilerin döndürüleceğinin ayrıntılarını veren başlangıç ​​kullanım kılavuzunuz olarak kabul edin.

Bu sayfa beş farklı bölüme ayrılmıştır. Ne bulacağınızı daha iyi anlamanız için size bir bağlam sağlamak için biraz zaman ve laf kalabalığı yaparak her birinin üzerinden geçeceğiz.

Başlarken

Burada, Positionstack ile yaptığınız her istek için geçerli olan temel işlevleri bulacaksınız . Bunlar:

• API Anahtarı – API anahtarınız, Positionstack'in veri kümesine erişmek için kullanacağınız dijital bir pasaport gibidir. Onsuz, API sizin için işe yaramaz. Güvenliğinin ihlal edildiğini düşünüyorsanız, eski anahtarınızı kolayca yenisiyle değiştirebilirsiniz.
• Şifreleme – 256-bit SSL şifrelemesi, İnternet'in her yerinde kullanılır ve iyi bir nedenle güvenlik için endüstri standardıdır. Uygulamanızın Positionstack sunucularıyla iletişimini şifrelemek için bir Temel plana veya daha iyisine ihtiyacınız olsa da, bu tek başına yatırıma değer. Şifrelemeyi başlatmak için, API temel URL'sinde HTTP'yi HTTPS olarak değiştirmeniz yeterlidir. Basit!
• JSON Geri Aramaları – Bunun nasıl çalıştığına dair çok fazla teknik ayrıntıya girmeyeceğiz, ancak API istekleriniz aynı kaynak ilkeleri tarafından engelleniyorsa, bir geçici çözümü etkilemek için JSON geri aramalarını kullanırsınız. Esasen, etki alanları arası sorunlarla çıkmaza girmeyen harici bir komut dosyasından veri talep edersiniz.
• API Hataları – Her şeyde olduğu gibi bazen API istekleriniz hatalarla karşılaşabilir. Positionstack bunu anlar ve neyin yanlış gittiğini belirlemenize yardımcı olmak için uygulamalarına bir hata raporlama işlevi yerleştirmiştir. API isteği başarısızlıkları, otomatik olarak JSON biçiminde bir hata nesnesi ve ayrıca hata için bağlam sağlamak için kod, mesaj ve bağlam alt nesneleri döndürür.

API Uç Noktaları

Bu bölüm, Positionstack'in et ve patates işlevselliğini, yani ileri ve geri coğrafi kodlamayı belgelemektedir. Farkın ne olduğundan %100 emin değilseniz, coğrafi kodlamayı, düz İngilizce ile yazılmış yerleri ve adresleri koordinatlar ve IP adresleri gibi konum verilerine veya tam tersi şekilde çevirebileceğiniz iki yönlü bir sokak olarak düşünün.

Böylece, Eyfel Kulesi'nin konumunu koordinatlara dönüştürmek için ileri coğrafi kodlamayı kullanırsınız. Benzer şekilde, ters coğrafi kodlamayı kullanarak bir IP adresiyle ilişkili sokak adresini öğrenebilirsiniz. Sonuçta oldukça basit!

İleri/geri coğrafi kodlama istekleri

Her iki tür coğrafi kodlama için temel bir istekte bulunmak için , API'nin temel URL'sine uygun uç noktayı ( /forward  veya /reverse ) eklemeniz gerekir . Ardından, erişim anahtarınızı sağlayacak, ardından Düz İngilizce bir konum adresini veya buna karşılık gelen konum verilerini kullanarak bir sorgu yapacaksınız —ve, işte! Bunun gibi bir şey görünecek:

https://api.positionstack.com/v1/forward
    ? access_key = YOUR_ACCESS_KEY
    & sorgu = 1600 Pennsylvania Ave NW, Washington DC

veya

https://api.positionstack.com/v1/reverse
    ? access_key = YOUR_ACCESS_KEY
    & sorgu = 40.7638435,-73.9729691

Elbette, Positionstack'in veri seti, adres ve koordinatlardan çok daha fazlasını içerir. Bu diğer kategorileri çeşitli parametreleri kullanarak ayrıştırabilirsiniz. Beyaz Saray'ı sorgulayan bir ileri coğrafi kodlama isteğinin nasıl göründüğüne dair bir örnek :

{
   "veri": {
      "Sonuçlar": [
         {
            "enlem": 38.897675,
            "boylam": -77.036547,
            "etiket": "1600 Pennsylvania Avenue NW, Washington, DC, ABD",
            "ad": "1600 Pennsylvania Bulvarı KB",
            "tür": "adres",
            "sayı": "1600",
            "sokak": "Pensilvanya Bulvarı KB",
            "posta_kodu": "20500",
            "güven": 1,
            "bölge": "Kolombiya Bölgesi",
            "bölge_kodu": "DC",
            "yönetim_alanı": boş,
            "mahalle": "Beyaz Saray Arazisi",
            "ülke": "Amerika Birleşik Devletleri",
            "ülke_kodu": "ABD",
            "map_url": "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

İlginç bir şekilde, Beyaz Saray'ın yaklaşık koordinatlarını kullanarak bir ters coğrafi kodlama isteği yapacak olsaydınız, döndürülen sonuçlar hemen hemen aynı görünürdü, ancak sizin koordinatlarınız ile Beyaz Saray'ın resmi koordinatları arasındaki mesafe farkını Positionstack'te göründükleri gibi görmeniz dışında. veri kümesi.

Bu benzerliğin nedeni, her iki uç noktanın da aynı GET parametreleri dizisini kullanması ve bu nedenle (neredeyse) aynı yanıt nesnelerini döndürebilmesidir. Bu, hangi başlangıç ​​verisine sahip olursanız olun, karşılığında tam bir konum verisi alabileceğiniz anlamına gelir. (API'nin alanları  parametresini kullanarak bu sonuçları daraltmak mümkündür , ancak buna daha sonra değineceğiz.)

Not: Positionstack'in dokümantasyon sayfası, her bir parametreyi ve yanıt nesnesini tam olarak detaylandırır, bu yüzden kontrol ettiğinizden emin olun!

Toplu istekler

Bu belge ayarındaki son ana başlık, toplu isteklerle ilgilidir . Tek yapmanız gereken toplu iş  parametresini çağırmak , ardından birden çok sorgu örneğini (istediğiniz parametrelerle birlikte) tek bir istekte alta yerleştirmek ve Positionstack'in API'si gerisini halleder. Çok basit ve şuna benziyor:

{
   "grup":[
      {
         "sorgu": "Ana Cadde",
         "ülke": "ABD",
         "bölge": "Minnesota"
      },
      {
         "sorgu": "Ana Cadde",
         "ülke": "ABD",
         "bölge": "Illinois"
      },
      {
         "sorgu": "Ana Cadde",
         "ülke": "ABD",
         "bölge": "Missouri"
      }
   ]
}

Gelişmiş Veri

Temel konum parametrelerine ek olarak, daha gelişmiş veriler döndürmek için API isteklerinizi daha da özelleştirebilirsiniz . Bunlar şunları içerir:

• Yerleştirilebilir Haritalar – Web sitenizde veya uygulamanızda çekici bir görsel harita temsili oluşturmak için kullanabileceğiniz, coğrafi kodlama sonucunuzla bağlantılı bir map_url nesnesi döndürür.
• Ülke Modülü – Birkaç yanıt nesnesine kadar dönen diğer parametrelerin aksine country_module , sorguladığınız ülke hakkında inanılmaz bir veri dizisi döndürür. Sadece koordinatlar ve adresler de değil; başkenti, bayrağı, resmi adı, denize kıyısı olmayan (veya olmayan) ülke durumu, kullanılan para birimleri, konuşulan diller, arama kodları ve daha fazlası.
• Güneş Modülü – Esprili bir şekilde, Positionstack'in belgeleri bunu “Astrolojik” veri olarak tanımlar. Bu parametre ile burcunuzu alamayacaksınız, ancak astronomik, sivil ve deniz kronolojisine göre güneşin ne zaman doğup battığı ile ilgili verileri göreceksiniz.
• Saat Dilimi Modülü – Bir konumun GMT ofsetini saniye cinsinden veya doğal dil dizesi olarak döndürmek için timezone_module ekleyin .
• Sınırlayıcı Kutu Modülü – Tek bir x/y koordinat çifti göreviniz için uygun değilse, bir alanı boylam ve enlem için minimum ve maksimum değerlerle çevreleyen bir sınırlayıcı kutu deneyin.

Ekstra seçenekler

Positionstack API'sinin size atması gereken tonlarca veri vardır, ancak neyse ki bu bilgi hazinesini yönetmeniz için size ek araçlar sağlar.

• Yanıt Alanlarını Belirtin – Positionstack'in ne kadar veri döndürebileceğini derinlemesine ele aldık, ancak tüm bu verilerin bir maliyeti olduğunu unutmayın. Eğer aylık isteklerini sınırlamak istiyorsanız, ile yapabilirsiniz alanlar ekleme alanları = results.flag örneğin, yalnızca sorgulanan ülkenin bayrağı çıkışına API neden olur. Gereksinim duyduğunuz belirli veri kümesini almak için alanları gerektiği kadar çağırabilirsiniz .
• Çıktı Biçimini Belirtin - Ücretsiz aboneler, döndürülen coğrafi kodlama sonuçları için JSON biçimiyle sınırlıdır. Ancak ödeme yapan müşteriler, JSON, XML veya GeoJSON'u gerektiği gibi belirtme isteklerine çıktı ekleyebilir . 

Kod Örnekleri 

Positionstack size yardım etmek için burada olduklarını söylediğinde, bunu kastediyorlar. Belgelerinin ne kadar kapsamlı olduğunu zaten gördük, ancak API'lerinin desteklediği tüm dillerde kullanışlı kod örnekleriyle bunu tamamlıyorlar. Bu kodu buraya kopyalamayacağız/yapıştırmayacağız, ancak hızlı başvuru için bu diller şunlardır:

• piton
• düğümler
• jQuery
• Gitmek
• yakut

Kanıt ve performans

Bu noktada, Positionstack'in oldukça fazla şey yapabileceği açık olmalıdır. Ancak, bunları ne kadar iyi yapıyor?

İlk olarak, bazı bağlamları ele alalım. Positionstack, Apilayer'ın bulut tabanlı ekosistemindeki 20'den fazla API mikro hizmetinden biridir. Bu API'ler birlikte, başlangıçtan kuruluşa kadar bir milyondan fazla B2B istemcisine hizmet eder. En dikkate değer müşterilerinden bazıları Amazon, Apple, Slack, LinkedIn ve daha birçok ev adını içerir. Açıkçası, bu talep ölçeğini ele almak için sağlam bir altyapıya sahipler.

Kendi avantajlarıyla, Positionstack, yazıldığı sırada 2020 boyunca inanılmaz bir %100 çalışma süresi ile soyağacına kadar yaşıyor. API'nin balina istemcisi başına günde bir milyardan fazla coğrafi kod aramasını rutin olarak işlediğini düşündüğünüzde, bu durum daha da etkileyicidir . Ayrıca, bu istekler genellikle 10 ile 100 ms arasında yanıtlar alır.

Kitabımızda bu, özellikle bu SaaS teklifinin ne kadar agresif fiyatlandırıldığı düşünüldüğünde, teknolojik bir harikadır.

Ayrıca Positionstack'i bu kadar çekici yapan yalnızca ham güç değildir. Nominatim, GeoNames, Pelias ve OpenStreetMap gibi güvenilir isimlerden elde edilen veri kümeleri gerçekten karmaşıktır. Positionstack, bu zengin veriyi günde birden çok kez çapraz kontrol eder, filtreler ve yeniden birleştirerek, dünyanın herhangi bir yerinde ve gerçek zamanlı olarak her zaman yüksek doğrulukta konum verilerine sahip olmanızı sağlayan akıllı algoritmalar aracılığıyla düzenli güncellemeler sağlar.

Nihai kararımızı bozmaktan nefret ediyoruz, ancak sağlam, ölçeklenebilir bir coğrafi kodlama çözümü arıyorsanız, Positionstack'in özgeçmişi daha yakından bakmanızı gerektirir.

fiyatlandırma 

Apilayer, oldukça pahalı kurumsal düzeydeki coğrafi kodlama yazılımlarına uygun maliyetli bir alternatif sağlamak için yola çıktı ve bu amaçla başarılı oldular.

Positionstack beş fiyatlandırma katmanında gelir ve aylık faturalandırmayı veya yıllık abonelikleri %20 indirimle destekler. Bu katmanlar şunlardır:

• Ücretsiz – Kişisel kullanım için derecelendirildi, JSON biçiminde çıktısı alınan ileri ve geri coğrafi kodlama için aylık 25.000 istekle hala iyi bir mesafe alıyorsunuz. Pek çok gelişmiş özellik veya müşteri desteği alamıyorsunuz, ancak Belgeler sayfasının ne kadar değerli bir kaynak olduğunu size zaten gösterdik. Bu katman ücretsizdir ve yükümlülük içermez; başlamak için kredi kartı bilgilerini vermenize bile gerek yoktur.
• Temel – Giriş seviyesi ticari paket. Temel aboneler, aylık kotalarını 100.000 coğrafi kodlama isteğine dört katına çıkarır ve ayrıca HTTPS şifrelemesi, birden çok çıktı seçeneği (JSON, XML, GeoJSON), yerleştirilebilir haritalar, birden çok dil ve daha fazlası gibi gelişmiş özelliklere erişim elde eder. Ayda yalnızca 9,99 ABD dolarına ticari Positionstack lisansı alın.
• Profesyonel – Positionstack'in en popüler teklifi olan Profesyonel katman, coğrafi kodlama taleplerinde ayda 1.000.000'a kadar on kat artış sunar. Temel katmandaki tüm özellikler mevcut ve ardından bazıları, özellikle ağır hizmet uygulamaları için toplu istekler dahil. Bu katman ayda 49,99 ABD Doları tutarındadır.
• İş – Kurumsal ölçekte performansa geçiş yapan İş katmanı, aylık kotayı 3.000.000 istek gibi balonlarla doldurur. Bir kez daha, bunlardan en iyi şekilde yararlanmanıza yardımcı olmak için Positionstack'in tutkulu müşteri destek ekibi tarafından desteklenen her gelişmiş özellik tamamen mevcuttur. Ayda 99,99 dolar.
• Kurumsal - Bu, standart tekliflerin pencereden dışarı çıktığı ve müşterinin kral olduğu katmandır. Özel çözümler gerektiren kesin ihtiyaçlarınız var ve Positionstack hedeflerinize ulaşmak için hazır. (Özellikle) değişken olsalar bile, aylık hacim isteklerinizi siz belirlersiniz. API'den daha fazla beygir gücüne mi ihtiyacınız var? Özel olarak oluşturulmuş çözümler için desteğe ulaşın. Fiyat teklifi için Positionstack ile iletişime geçin.

Karar

Positionstack tam olarak yapmak istediği şeyi yapar: performanstan ödün vermeden çoğu KOBİ'ye kurumsal düzeyde coğrafi kodlamayı, aksi takdirde bütçe dışı fiyat noktalarından aşağı indirin. API'leri iyi belgelenmiştir ve kullanımı kolaydır, ancak maksimum fayda için tüm ana programlama dillerinde sağlam entegrasyona sahiptir. Positionstack'in rutin olarak ele aldığı isteklerin sayısı şaşırtıcıdır ve veri kümeleri, gerçek zamanlı coğrafi kodlamada gerçekten küresel erişim için akıllıca korunur. Bu tür bir ürün için pazardaysanız, Positionstack'te uyumayın.

Ne tür bir entegrasyon planlıyorsunuz? İşletmenizde coğrafi kodlamayı nasıl kullanacaksınız? Positionstack hakkında herhangi bir sorunuz veya yorumunuz var mı? Aşağıdaki yorumlarda bize bir not bırakın.