Positionstack API'sı ile Kurumsal Düzeyde Coğrafi Kodlamayı Ücretsiz Alın (REVIEW)

Coğrafi kodlamadan değer almak için Google Haritalar olmanıza gerek yoktur. Ve Positionstack sayesinde, Big G’nin teknoloji bütçesine de ihtiyacınız yok. Bugün, Positionstack’ın kurumsal düzeyde ileri ve geri coğrafi kodlamayı hem son derece uygun fiyatlı hem de kullanılabilir hale getirmeyi amaçlayan sağlam API'sını inceliyoruz.

Pozisyonlar 101

Öyleyse, neden 2.000'den fazla kelime incelemesi okumakla uğraşasınız ki Positionstackve ne kazanacaksınız? Cevap kulağa hoş geliyor, ama doğru: tüm dünya.

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

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

• Her saat, her gün işlenen milyarlarca coğrafi kod arama talebi; % 100 çalışma süresi ve <100 ms yanıt süreleri ile
• Bulut tabanlı, yüksek ölçeklenebilir altyapı
• Birkaç saatte bir güncellenen kavernöz bir veri kümesinde derlenen, dünyanın her ülkesine ilişkin gerçek zamanlı veriler
instagram viewer
• Cömertçe paylaştırılmış, rekabetçi fiyatlı abonelik planları; artı Ücretsiz kullanıcılar için rakipsiz 10.000 istek aylık kotası
• Tüm önemli programlama dilleri için entegrasyon desteği
• Kod parçacıklarıyla birlikte kapsamlı, okunması kolay belgeler
• Zendesk, Slack, LinkedIn, Lyft, Apple ve Amazon gibi müşterilere hizmet veren birinci sınıf müşteri memnuniyeti ekibi

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

Positionstack’ın 3 Adımlı Hızlı Başlangıç ​​Kılavuzu

Web sitelerinde herhangi bir zaman geçirirseniz, Positionstack uygulamasının API'larının birincil satış noktası olarak kullanım kolaylığını gerçekten vurguladığını görürsünüz. Kayıt işlemi sırasında hemen bunun doğru olduğunu göreceksiniz. Aslında, hesap bilgilerinizi girdikten sonra ilk gördüğünüz şey, üç kolay adımda Positionstack ile çalışmaya başlamanın hızlı bir yol haritasıdır. Hadi bir bakalım:

1. API erişim anahtarınızı ayarlayın - Varsayılan olarak, kutunun dışına çıkmaya hazır bir erişim anahtarı verilir. Ancak, gerektiğinde bunu kolayca sıfırlayabilirsiniz.
2. API uç noktalarını seçin - Bir sonraki bölümde API uç noktalarını daha ayrıntılı bir şekilde ele alıyoruz, ancak şimdilik bu adımın, uygulamanız Positionstack için istekte bulunduğunda hangi tür verilerin döndürüleceğini yapılandırmayı ifade ettiğini anlıyoruz. Burada önce isteklerinizi hedeflediğiniz temel URL'yi görürsünüz, ancak dokümantasyonda da görünür. Son olarak, sadece birkaç kolay kod satırından oluşan örnek bir API isteği görüyoruz.
3. Uygulama entegrasyonu - Son adım, Positionstack API'sının uygulamanıza son entegrasyonu ile ilgilidir. Bu süreç hakkında bilinmesi gereken adil bir miktar vardır ve bunların çoğu dokümantasyonda ele alınmıştır. Burada önemli olan nokta: Positionstack’ın destek ekibinin arkanız var ve API'larını uygulamanıza yapılandırmak ve entegre etmek için ihtiyaç duyduğunuz kadar veya az yardım sunacak.

Oldukça kolay değil mi? API'lar başlangıçta kapsamlı BT bilgisi olmayan kişilere korkutucu gelebilir. Ama yarasadan hemen sonra, Positionstack, sadece kolay olmasının yanı sıra akıllı tasarımlarının inanılmaz dokümantasyonuyla size yardımcı olacak bilgilerle sizi rahatlatır. Size yardımcı olmaya hazır tutkulu bir uzman ekibine sahip olmalarına yardımcı olur.

Pozisyon Belirleme Gösterge Tablonuz

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

• Gösterge Paneli - Burada bildirimler bulacaksınız (genellikle belirli kullanım eşiklerini geçerken sizi uyarır), ardından hem 3 Adımlı Hızlı Başlangıç ​​Kılavuzu'na hem de Belgeler sayfasına bağlantı verir. Ayrıca API anahtarınıza, mevcut aboneliğinize, hesap ayrıntılarına ve ödeme yönteminize genel bir bakış da vardır.
• / Abonelik Yükseltme - Aboneliğinizi bu iki seçenekten herhangi birinde değiştirebilirsiniz. İstediğiniz zaman yükseltin, ancak her iki yönde de aylık veya yıllık bir plan arasında geçiş yapmak istiyorsanız, önce Ücretsiz bir hesaba geçmeniz ve ardından istediğiniz seçeneği belirlemeniz gerekir. Positionstack desteği, bu konuda yardıma ihtiyacınız olursa 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üncellemenizi sağlar. Bu temel kontrolleri aşırı tasarlanmış, gösterişli bir arayüze gömmediklerini takdir etmeliyiz. WYSIWYG.
• API Kullanımı - Muhtemelen en sık tekrar ziyaret edeceğiniz sekme, burada şimdiye kadar aylık istek kotanızın ne kadarını yediğinizi bulabilirsiniz. Zaman içinde 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’ın teklifinin kalbine ve ruhuna ulaşıyoruz: API belgeleri. Bu sayfayı, her bir API uç noktasını, parametrelerini ve ne tür bilgiler döndüreceklerini ayrıntılarıyla açıklayan kullanım kılavuzunuzu düşünün.

Bu sayfa beş farklı bölüme ayrılmıştır. Her birini inceleyeceğiz, ne bulacağınızı daha iyi anlamanız için bir bağlam sağlamak için biraz zaman ve ayrıntı harcayacağız.

Başlangıç

Burada bulacaksınız temel fonksiyonlar Bu, Positionstack ile yaptığınız her istek için geçerlidir. Bunlar:

• API Anahtarı - API anahtarınız, Positionstack’ın veri kümesine erişmek için kullanacağınız dijital bir pasaport gibidir. Bu olmadan, API sizin için işe yaramaz. Tehlikede olduğuna inanıyorsanız, eski anahtarınızı yenisi için kolayca döndürebilirsiniz.
• Şifreleme - 256 bit SSL şifrelemesi tüm İnternet'te kullanılır ve güvenlik için endüstri standardıdır. Uygulamanızın iletişimlerini Positionstack’ın sunucularıyla şifrelemek için Temel bir plana veya daha iyisine ihtiyacınız olsa da, yatırıma tek başına değer. Şifrelemeyi uyarmak için API temel URL'sinde HTTP'yi HTTPS olarak değiştirin. Basit!
• JSON Geri Aramaları - Bunun nasıl çalıştığına ilişkin çok fazla teknik ayrıntıya girmeyeceğiz, ancak API istekleriniz aynı menşei politikaları tarafından taşlanıyorsa, bir geçici çözümü etkilemek için JSON geri aramalarını kullanırsınız. Esasen, alanlar arası sorunlarla ilgili olmayan, harici bir komut dosyasından veri istersiniz.
• API Hataları - Her şeyde olduğu gibi, bazen API istekleriniz hatalarla karşılaşır. Positionstack bunu anlıyor ve neyin yanlış gittiğini belirlemenize yardımcı olmak için uygulamalarına bir hata raporlama işlevi ekledi. API isteği hataları, hataya bağlam sağlamak için otomatik olarak JSON biçiminde bir hata nesnesinin yanı sıra kod, mesaj ve bağlam alt nesnelerini döndürür.

API Uç Noktaları

Bu bölüm, Positionstack’in ileri ve geri coğrafi kodlaması anlamına gelen et ve patates işlevselliğini belgelemektedir. Farkın ne olduğundan% 100 emin değilseniz, coğrafi kodlamayı, çevirebileceğiniz iki yönlü bir sokak olarak düşünün koordinatlar ve IP adresleri gibi verileri konumlandırmak için düz İngilizce olarak yazılmış yerler ve adresler ve tam zıttı.

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

İleri / geri coğrafi kodlama istekleri

Her iki coğrafi kodlama türü için de temel bir istekte bulunmak için, uygun bitiş noktasını eklemeniz gerekir (/forward veya /reverse) API’nın temel URL'sine yönlendirir. Ardından, erişim anahtarınızı vereceksiniz, ardından sorgu Düz İngilizce konum adresi veya karşılık gelen konum verilerini kullanarak - ve, voila! Bunun gibi bir şey olacak:

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

veya

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

Elbette, Positionstack’ın veri kümesi yalnızca adreslerden ve koordinatlardan çok daha fazlasını içerir. Bu diğer kategorileri çeşitli parametreler kullanarak ayrıştırabilirsiniz. İşte bir ileri coğrafi kodlama Beyaz Saray'ı sorgulama isteği şöyle görünür:

{"data": {"results": [{"enlem": 38.897675, "boylam": -77.036547, "label": "1600 Pennsylvania Avenue KB, Washington, DC, ABD", "ad": "1600 Pennsylvania Avenue NW "," type ":" adres "," number ":" 1600 "," street ":" Pennsylvania Avenue NW "," postal_code ":" 20500 "," güven ": 1," bölge ":" İlçe Columbia "," region_code ":" DC "," administrative_area ": null," neighbourhood ":" White House Grounds "," country ":" Amerika Birleşik Devletleri "," country_code ":" US ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

İlginç bir şekilde, eğer ters coğrafi kodlama Beyaz Saray’ın yaklaşık koordinatlarını kullanarak talep ettiğinizde, döndürülen sonuçlar neredeyse aynı görünecektir, ancak mesafe Koordinatlarınızla Beyaz Saray’ın resmi koordinatları arasında, Positionstack’ın veri kümesinde göründükleri gibi.

Bu benzerliğin nedeni, her iki uç noktanın da aynı GET parametresi dizisini kullanması ve böylece aynı yanıt nesnelerini (neredeyse) döndürme yeteneğinin olmasıdır. Bu, hangi başlangıç ​​verilerinden geçmeniz gerektiğine bakılmaksızın, karşılığında konum verilerini tam olarak tamamlayabileceğiniz anlamına gelir. (API'leri kullanarak bu sonuçları daraltmak mümkündür alanlar parametresi, ancak daha sonra buna değineceğiz.)

Not: Positionstack’ın dokümantasyon sayfası her bir parametreyi ve yanıt nesnesini tam olarak detaylandırır;

Toplu istekler

Bu dokümantasyon ayarındaki son ana başlık toplu istekler. Tek yapmanız gereken, yığın parametresini kullanın, ardından birden çok sorgu altındaki örnekleri (istediğiniz parametrelerle birlikte) tek bir istekte ve Positionstack’ın API'sı gerisini halleder. Çok basit ve şu şekilde görünüyor:

{"toplu iş": [{"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ş Veriler

Temel konum parametrelerine ek olarak, API isteklerinizi daha fazla geri dönecek şekilde uyarlayabilirsiniz gelişmiş veri. Bunlar:

• Yerleşik Haritalar - Web sitenizde veya uygulamanızda çekici bir görsel harita sunumu oluşturmak için kullanabileceğiniz coğrafi kodlama sonucunuza bağ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 sorgulanan ülkeniz hakkında inanılmaz bir veri dizisi döndürür. Sadece koordinatlar ve adresler de değil; başkent, bayrak, resmi ad, kara ile çevrili (veya değil) bir ülke statüsü, kullanılan para birimleri, konuşulan diller, arama kodları ve daha fazlası.
• Güneş Modülü - Mizahi bir şekilde, Positionstack’ın belgeleri bunu “Astrolojik” veri olarak tanımlıyor. Bu parametreyle burcunuzu almayacaksınız, ancak astronomik, sivil ve deniz kronolojisine göre güneşin ne zaman yükselip battığı ile ilgili verileri göreceksiniz.
• Saat Dilimi Modülü - Ekle timezone_module bir konumun GMT farkını saniye veya doğal dil dizesi olarak döndürmek için.
• Sınırlayıcı Kutu Modülü - Tek bir x / y çift koordinatı göreviniz için doğru değilse, boylam ve enlem için minimum ve maksimum değerleri olan bir alanı kapsayan bir sınırlayıcı kutu deneyin.

Ekstra seçenekler

Positionstack API'sının size atmak için bir ton verisi vardır, ancak neyse ki size ek araçlar bu bilgi hazinesini yönetmek için

• Yanıt Alanlarını Belirtin - Positionstack'in ne kadar veri döndürebileceğini derinlemesine inceledik, ancak tüm bu verilerin bir maliyet getirdiğini unutmayın. Aylık isteklerinizi sınırlamak istiyorsanız, bunu alanlar Eklemeye fields = results.flagörneğin, API'nın yalnızca sorgulanan ülkenizin bayrağını çıkarmasına neden olur. Sen çağırabilirsin alanlar İhtiyacınız olan belirli veri kümesini elde etmek için ihtiyacınız olduğu kadar.
• Çıktı Biçimini Belirtme - Ücretsiz aboneler, iade edilen coğrafi kodlama sonuçları için JSON biçimiyle sınırlıdır. Ancak, ödeme yapan müşteriler çıktı JSON, XML veya GeoJSON'u gerektiği gibi belirtme isteklerinde.

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 kullanışlı bir şekilde tamamlıyorlar kod örnekleri API'larının desteklediği tüm dillerde. Bu kodu buraya kopyalayamayacağız / yapıştırmayacağız, ancak hızlı başvuru için bu diller:

• piton
• Nodejs
• jQuery
• Git
• Yakut

Kanıt ve performans

Bu noktada, Positionstack'ın oldukça fazla şey yapabildiği açık olmalıdır. Fakat, ne kadar iyi bu şeyleri yapıyor mu?

İlk olarak, bir bağlam düşünelim. Positionstack, Apilayer’ın bulut tabanlı ekosistemindeki 20'den fazla API mikro hizmetinden biridir. Bu API'ler birlikte, başlangıçtan işletmeye kadar bir milyondan fazla B2B müşterisine hizmet vermektedir. En dikkate değer müşterilerinden bazıları Amazon, Apple, Slack, LinkedIn ve daha birçok ev ismini içerir. Açıkçası, bu talebi karşılayacak sağlam bir altyapıya sahipler.

Kendi avantajlarına göre, Positionstack soyağacına kadar yaşar ve yazma sırasında 2020 boyunca% 100 inanılmaz bir çalışma süresine sahiptir. API'yi düşündüğünüzde bu daha da etkileyici rutin balina müşterisi başına günde bir milyardan fazla coğrafi kod aramasını işler, KOBİ müşterilerinden gelen istikrarlı eşzamanlı istekler dizisinden bahsetmiyorum bile. Dahası, bu istekler genellikle 10 ile 100 ms arasında yanıt alır.

Kitabımızda bu, özellikle bu SaaS teklifinin ne kadar agresif fiyatlandırıldığını göz önünde bulundurarak teknolojik bir mucize.

Ppozisyonu bu kadar çekici yapan sadece ham güç değildir. Veri kümeleri Nominatim, GeoNames, Pelias ve OpenStreetMap gibi güvenilir isimlerden elde edilen gerçekten sofistike. Positionstack, bu veri zenginliğini günde birkaç kez çapraz kontrol eder, filtreler ve yeniden birleştirir ve düzenli güncellemeleri zorlar Dünyanın her yerinde ve gerçekte her zaman son derece hassas konum verilerine sahip olmanızı sağlayan akıllı algoritmalar sayesinde saati.

Nihai kararımızı bozmaktan nefret ediyoruz, ancak sağlam, ölçeklenebilir bir coğrafi kodlama çözümü arıyorsanız, Positionstack’ın özgeçmişine daha yakından bakmak gerekiyor.

Fiyatlandırma

Apilayer, oldukça pahalı kurumsal düzey coğrafi kodlama yazılımlarına uygun fiyatlı bir alternatif sunmayı başardı ve bu amaçla başarılı oldular.

Pozisyoner beşte gelir fiyatlandırma aylık faturalandırmayı veya yıllık abonelikleri% 20 indirimle destekler ve destekler. Bu katmanlar:

• Bedava - Kişisel kullanım için derecelendirilmiş olarak, JSON biçiminde yayınlanan 25.000 aylık ileri ve geri coğrafi kodlama istekleriyle hala iyi bir kilometre performansı elde ediyorsunuz. Çok fazla gelişmiş özellik veya müşteri desteği almıyorsunuz, ancak Dokümantasyon sayfalarının ne kadar değerli bir kaynak olduğunu size gösterdik. Bu katman ücretsizdir ve herhangi bir yükümlülük getirmez; başlamak için kredi kartı bilgileri bile vermenize gerek yoktur.
• Temel - Giriş seviyesi ticari paket. Temel aboneler aylık kotalarını 100.000 coğrafi kodlama isteğine göre dört katına çıkarır ve ayrıca gelişmiş HTTPS şifreleme, çoklu çıkış seçenekleri (JSON, XML, GeoJSON), gömülebilir haritalar, çoklu dil, ve dahası. Ayda sadece 9,99 ABD doları tutarında bir ticari Positionstack lisansı edinin.
• Profesyonel - Positionstack’in en popüler teklifi olan Professional katmanı, coğrafi kodlama isteklerinde on ayda bir artış sunar - ayda 1.000.000'a kadar. Temel katmandaki tüm ürünler mevcut ve daha sonra, ağır hizmet uygulamaları için toplu istekler de dahil olmak üzere bazıları mevcut. Bu katman ayda 49.99 dolar.
• iş - İşletme ölçeğinde performansa dönüşen İşletme katmanı, aylık kotayı büyük bir 3.000.000 istekle karşılar. Bir kez daha, Positionstack’ın tutkulu müşteri destek ekibi tarafından desteklenerek, en iyi şekilde yararlanmanıza yardımcı olacak her gelişmiş özellik tamamen kullanılabilir. Aylık 99,99 ABD doları.
• kuruluş - Standart tekliflerin pencereden çıktığı ve müşterinin kraldığı katman. Özel çözümler gerektiren kesin ihtiyaçlarınız var ve Positionstack hedeflerinize ulaşmaya hazır. Aylık hacimli isteklerinizi, özellikle değişken olsalar bile, dikte edersiniz. API'dan daha fazla beygir gücüne mi ihtiyacınız var? Özel yapım çözümleri desteklemeye 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, işletme düzeyinde coğrafi kodlamayı, aksi takdirde bütçe dışında fiyat noktalarından çoğu KOBİ'ye getirin. API'leri iyi belgelenmiştir ve kullanımı kolaydır, ancak maksimum fayda için tüm önemli programlama dillerinde güçlü entegrasyona sahiptir. Positionstack'ın rutin olarak işlediği taleplerin sayısı şaşırtıcıdır, veri setleri gerçek zamanlı coğrafi kodlamada gerçekten küresel erişim için akıllıca korunur. Bu tür ürünler için pazardaysanız, Positionstack'ta uyumayın.

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