Dapatkan Geocoding Peringkat Perusahaan secara Percuma dengan Positionsstack API (ULASAN)

Anda tidak perlu menjadi Peta Google untuk mendapatkan nilai daripada pengekodan geo. Dan, terima kasih kepada Positionsstack, anda juga tidak memerlukan belanjawan teknologi Big G untuk berbuat demikian. Hari ini, kami menyemak API Positionsstack yang mantap, yang bertujuan untuk menjadikan geokod ke hadapan dan terbalik peringkat perusahaan sangat berpatutan dan boleh digunakan.

Timbunan kedudukan 101

Jadi, mengapa anda perlu bersusah payah membaca ulasan 2,000+ perkataan di Positionsstack , dan apakah yang anda perolehi? Jawapannya bunyi comel, tetapi ia tepat: yang seluruh dunia .

Pertimbangkan seketika berapa banyak tempat yang terdapat pada peta dunia. Kini, gandakan nombor itu dalam kepala anda dengan setiap bahagian metadata yang perlu diketahui oleh perniagaan anda tentang tempat tersebut. Itulah yang ditawarkan Positionsstack, dan kemudian beberapa.

Mari lihat beberapa statistik pantas tentang Positionsstack:

• Berbilion-bilion permintaan carian geokod sebenar diproses setiap jam, setiap hari; dengan 100% masa beroperasi dan < 100ms="" response="">
• Infrastruktur berasaskan awan dan berskala tinggi
• Data masa nyata pada setiap negara di dunia, disusun menjadi set data yang luas yang dikemas kini setiap beberapa jam
• Pelan langganan yang dibahagi-bahagikan dengan harga yang kompetitif; ditambah dengan 10,000 permintaan kuota bulanan yang tiada tandingan untuk pengguna Percuma
• Sokongan integrasi untuk semua bahasa pengaturcaraan utama
• Dokumentasi yang komprehensif dan mudah dibaca lengkap dengan coretan kod
• Pasukan kepuasan pelanggan bertaraf dunia dengan pengalaman melayani pelanggan seperti Zendesk, Slack, LinkedIn, Lyft, Apple dan Amazon

Positionsstack sememangnya mempunyai silsilahnya, tetapi sekiranya anda tidak yakin dengan segelintir mata peluru, mari kita mendalami bagaimana sebenarnya menggunakan API.

Panduan Mula Pantas 3 Langkah Positionsstack

Jika anda meluangkan masa di tapak web mereka, anda akan melihat bahawa Positionsstack benar-benar menekankan kemudahan penggunaan sebagai titik jualan utama kepada API mereka. Semasa proses pendaftaran, anda akan segera melihat bahawa ia agak benar. Malah, perkara pertama yang anda lihat selepas menaip dalam bukti kelayakan akaun anda ialah peta jalan pantas tentang perkara yang diperlukan untuk bangun dan berjalan dengan Positionsstack dalam tiga langkah mudah. Mari kita lihat:

1. Tetapkan kunci akses API anda – Secara lalai, anda diberikan kunci akses yang sedia untuk keluar dari kotak. Walau bagaimanapun, anda boleh menetapkan semula ini dengan mudah mengikut keperluan.
2. Pilih titik akhir API – Kami merangkumi titik akhir API dengan lebih mendalam bahagian seterusnya, tetapi buat masa ini cuma faham bahawa langkah ini merujuk kepada mengkonfigurasi jenis data yang dikembalikan apabila apl anda membuat permintaan kepada Positionsstack. Di sini anda akan mula-mula melihat URL asas, yang merupakan tempat anda menyasarkan permintaan anda, tetapi ia juga muncul dalam dokumentasi. Akhir sekali, kami melihat contoh permintaan API, yang terdiri daripada hanya beberapa baris kod yang mudah.
3. Penyepaduan aplikasi – Langkah terakhir merujuk kepada penyepaduan akhir API Positionstack ke dalam aplikasi anda. Terdapat jumlah yang adil untuk mengetahui tentang proses ini, dan kebanyakannya diliputi dalam dokumentasi. Perkara penting di sini ialah: Pasukan sokongan Positionsstack menyokong anda dan akan menawarkan seberapa banyak atau sedikit bantuan yang anda perlukan untuk mengkonfigurasi dan menyepadukan API mereka ke dalam apl anda.

Agak mudah bukan? API mungkin kelihatan menakutkan orang tanpa pengetahuan IT yang luas pada mulanya. Tetapi sejurus selepas itu, Positionsstack menghiburkan anda dengan pengetahuan bahawa bukan sahaja ia mudah, ia akan membantu anda sepanjang perjalanan dengan dokumentasi yang luar biasa bagi reka bentuk pintar mereka. Ia membantu mereka mempunyai pasukan pakar yang bersemangat yang bersedia untuk membantu anda juga.

Papan Pemuka Positionsstack anda

Menggandakan nilai teras mereka iaitu kemesraan pengguna, Positionsstack menawarkan Papan Pemuka yang diperkemas dan tidak bersepah yang mana anda boleh mengakses semua yang anda perlu tahu tentang API anda. Mari kita lihat pada pilihan bar sisi:

• Papan Pemuka – Di sini anda akan menemui pemberitahuan (biasanya memaklumkan anda apabila anda melepasi ambang penggunaan tertentu), kemudian memaut ke kedua-dua Panduan Mula Pantas 3 Langkah dan halaman Dokumentasi mereka. Terdapat juga gambaran keseluruhan kunci API anda, langganan semasa anda, butiran akaun dan kaedah pembayaran.
• Naik taraf/Langganan – Anda boleh menukar langganan anda pada salah satu daripada dua pilihan ini. Naik taraf pada bila-bila masa, walaupun jika anda ingin menukar antara pelan bulanan atau tahunan ke mana-mana arah, anda perlu menurunkan taraf dahulu kepada akaun Percuma, kemudian pilih pilihan yang diingini. Sokongan Positionsstack bersedia membantu anda jika anda memerlukan bantuan untuk melakukan ini.
• Akaun/Pembayaran – Ini adalah penjelasan sendiri; mana-mana tab akan membenarkan anda mengemas kini kelayakan anda pada bila-bila masa. Harus dikatakan bahawa kami menghargai bahawa mereka tidak menyembunyikan kawalan asas ini dalam antara muka yang direka bentuk dan mencolok. WYSIWYG.
• Penggunaan API – Kemungkinan tab yang paling kerap anda lawati semula, di sini anda boleh mengetahui jumlah kuota permintaan bulanan anda yang telah anda habiskan setakat ini. Terdapat juga bahagian berguna yang menunjukkan statistik penggunaan anda dari semasa ke semasa, supaya anda boleh melaraskan strategi anda dengan sewajarnya.

Dokumentasi API

Sekarang kita sampai ke inti dan jiwa tawaran Positionstack: dokumentasi API . Pertimbangkan halaman ini sebagai manual pengguna anda, yang memperincikan setiap titik akhir API, parameter mereka dan jenis maklumat yang akan mereka kembalikan.

Halaman ini dipecahkan kepada lima bahagian yang berbeza. Kami akan meneliti setiap satu, meluangkan sedikit masa dan kata-kata untuk menyediakan beberapa konteks untuk anda memahami dengan lebih baik perkara yang anda akan temui.

Bermula

Di sini, anda akan menemui fungsi asas yang digunakan untuk setiap permintaan yang anda buat dengan Positionsstack. Ini adalah:

• Kunci API – Kunci API anda adalah seperti pasport digital yang akan anda gunakan untuk mengakses set data Positionsstack. Tanpa itu, API tidak berguna untuk anda. Jika anda percaya ia telah terjejas, anda boleh memutarkan kunci lama anda dengan mudah untuk yang baharu.
• Penyulitan – Penyulitan SSL 256-bit digunakan di seluruh Internet, dan merupakan piawaian industri untuk keselamatan atas sebab yang baik. Walaupun anda memerlukan pelan Asas atau lebih baik untuk menyulitkan komunikasi apl anda dengan pelayan Positionsstack, pelaburan itu sendiri berbaloi. Untuk membangkitkan penyulitan, cuma tukar HTTP kepada HTTPS dalam URL asas API. Mudah!
• Panggilan Balik JSON – Kami tidak akan membincangkan terlalu banyak butiran teknikal tentang cara ini berfungsi, tetapi jika permintaan API anda semakin dihalang oleh dasar asal yang sama, anda menggunakan panggilan balik JSON untuk menjejaskan penyelesaian. Pada asasnya, anda meminta data daripada skrip luaran, yang tidak tersekat dengan isu merentas domain.
• Ralat API – Seperti mana-mana sahaja, kadangkala permintaan API anda akan mengalami ralat. Positionsstack memahami perkara ini dan telah membina ke dalam apl mereka fungsi pelaporan ralat untuk membantu anda mengenal pasti perkara yang salah. Kegagalan permintaan API akan secara automatik mengembalikan objek ralat dalam format JSON, kod tambah, mesej dan sub-objek konteks untuk menyediakan konteks untuk ralat.

Titik Akhir API

Bahagian ini mendokumentasikan kefungsian daging dan kentang Positionsstack, iaitu geokod hadapan dan belakang. Jika anda tidak pasti 100% perbezaannya, fikirkan geocoding sebagai jalan dua hala di mana anda boleh menterjemah tempat dan alamat yang ditulis dalam bahasa Inggeris biasa kepada data lokasi seperti koordinat dan alamat IP, dan sebaliknya.

Jadi, anda akan menggunakan geokod hadapan untuk menukar lokasi Menara Eiffel kepada koordinat. Begitu juga, anda boleh mengetahui alamat jalan yang dikaitkan dengan alamat IP dengan menggunakan geokod terbalik. Cukup mudah, selepas semua!

Permintaan geokod ke hadapan/terbalikkan

Untuk membuat permintaan asas untuk mana-mana jenis geokod, anda perlu menambahkan titik akhir yang sesuai ( /forward  atau /reverse ) pada URL asas API. Seterusnya, anda akan memberikan kunci akses anda, kemudian buat pertanyaan menggunakan sama ada alamat lokasi Bahasa Inggeris Biasa atau data lokasi yang sepadan–dan, voila! Ia akan kelihatan seperti ini:

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

atau

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

Sudah tentu, set data Positionstack mengandungi banyak, lebih daripada sekadar alamat dan koordinat. Anda boleh menghuraikan pengkategorian lain ini melalui penggunaan pelbagai parameter. Berikut ialah contoh permintaan geokod hadapan , menanyakan Rumah Putih, kelihatan seperti:

{
   "data": {
      "hasil": [
         {
            "latitud": 38.897675,
            "longitud": -77.036547,
            "label": "1600 Pennsylvania Avenue NW, Washington, DC, Amerika Syarikat",
            "nama": "1600 Pennsylvania Avenue NW",
            "type": "alamat",
            "nombor": "1600",
            "jalan": "Pennsylvania Avenue NW",
            "postal_code": "20500",
            "keyakinan": 1,
            "region": "Daerah Columbia",
            "region_code": "DC",
            "kawasan_pentadbiran": null,
            "neighbourhood": "Tapak Rumah Putih",
            "country": "Amerika Syarikat",
            "country_code": "AS",
            "map_url": "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

Menariknya, jika anda melakukan permintaan geokod terbalik menggunakan koordinat anggaran White House, hasil yang dikembalikan akan kelihatan hampir sama, kecuali anda juga akan melihat perbezaan jarak antara koordinat anda dan koordinat rasmi White House kerana ia muncul dalam Positionstack's set data.

Sebab persamaan ini ialah kedua-dua titik akhir menggunakan tatasusunan parameter GET yang sama, dan dengan itu mampu mengembalikan (hampir) objek tindak balas yang sama. Ini bermakna tidak kira apa pun data permulaan yang perlu anda lalui, anda boleh mendapatkan pelengkap lengkap data lokasi sebagai balasan. (Adalah mungkin untuk mengecilkan hasil ini menggunakan parameter medan  API , tetapi kami akan menyentuhnya kemudian.)

Nota: Halaman dokumentasi Positionsstack memperincikan sepenuhnya setiap parameter dan objek tindak balas, jadi pastikan anda menyemaknya!

Permintaan kelompok

Tajuk utama terakhir dalam tetapan dokumentasi ini berkaitan dengan permintaan kelompok . Apa yang anda perlu lakukan ialah menggunakan parameter kelompok  , kemudian sarang berbilang tika pertanyaan (bersama-sama dengan parameter yang anda inginkan) di bawahnya dalam satu permintaan dan API Positionstack menguruskan yang lain. Ia sangat mudah, dan kelihatan seperti ini:

{
   "kelompok":[
      {
         "query": "Jalan Utama",
         "negara": "AS",
         "wilayah": "Minnesota"
      },
      {
         "query": "Jalan Utama",
         "negara": "AS",
         "wilayah": "Illinois"
      },
      {
         "query": "Jalan Utama",
         "negara": "AS",
         "wilayah": "Missouri"
      }
   ]
}

Data Lanjutan

Selain parameter lokasi asas, anda boleh menyesuaikan lagi permintaan API anda untuk mengembalikan data yang lebih maju . Ini termasuk:

• Peta Boleh Benam – Mengembalikan objek map_url yang dipautkan kepada hasil pengekodan geo anda, yang boleh anda gunakan untuk membuat perwakilan peta visual yang menarik pada tapak web atau apl anda.
• Modul Negara – Tidak seperti parameter lain yang kembali kepada beberapa objek tindak balas, country_module mengembalikan tatasusunan data yang luar biasa tentang negara pertanyaan anda. Ia bukan hanya koordinat dan alamat, sama ada; ia ialah ibu kota, bendera, nama rasmi, status sebagai negara terkurung darat (atau tidak), mata wang yang digunakan, bahasa yang dituturkan, kod panggilan dan banyak lagi.
• Modul Matahari – Lucunya, dokumentasi Positionsstack menerangkan ini sebagai data “Astrologi”. Anda tidak akan mendapat horoskop anda dengan parameter ini, tetapi anda akan melihat data tentang masa matahari terbit dan terbenam, mengikut kronologi astronomi, sivil dan nautika.
• Modul Zon Waktu – Tambah timezone_module untuk mengembalikan offset GMT lokasi dalam sama ada saat atau sebagai rentetan bahasa semula jadi.
• Modul Kotak Sempadan – Jika sepasang koordinat x/y tunggal tidak sesuai untuk tugas anda, cuba kotak sempadan, yang melampirkan kawasan dengan nilai minimum dan maksimum untuk longitud dan latitud.

Pilihan Tambahan

The Positionstack API has a ton of data to throw at you, but luckily it provides you with additional tools to manage this trove of information.

• Specify Response Fields – We’ve covered in depth how much data Positionstack can return, but keep in mind that all that data comes at a cost. If you want to limit your monthly requests, you can do that with the fields Appending fields = results.flag, for example, will cause the API to output only your queried country’s flag. You can invoke fields as many times as you need to get the specific dataset you require.
• Specify Output Format – Free subscribers are limited to the JSON format for their returned geocoding results. Paying customers, however, can append output on their requests to specify JSON, XML, or GeoJSON as necessary. 

Code Examples 

When Positionstack says they’re here to help you, they mean it. We’ve already seen how thorough their documentation is, but they top it off with handy code examples in all the languages their API supports. We’re not going to copy/paste that code here, but for quick reference, those languages are:

• Python
• Nodejs
• jQuery
• Go
• Ruby

Proof and performance

At this point, it should be clear that Positionstack is capable of doing quite a lot. But, how well does it do these things?

First, let’s consider some context. Positionstack is one of 20+ API microservices in Apilayer’s cloud-based ecosystem. Together, these APIs serve over a million B2B clients from startups all the way up to enterprise. Some of their most notable customers include Amazon, Apple, Slack, LinkedIn, and many more household names. Clearly, they’ve got some robust infrastructure to handle this scale of demand.

On its own merits, Positionstack lives up to its pedigree, with an incredible 100% uptime throughout 2020 at the time of writing. This is even more impressive when you consider the API routinely processes over a billion geocode lookups per day per whale client, not to mention the dizzying array of simultaneous requests coming from their stable of SMB customers. What’s more, these requests typically garner responses between 10 and 100 ms.

In our book, that’s something of a technological marvel, especially considering how aggressively priced this SaaS offering is.

And it’s not just raw power that makes Positionstack so appealing. Their dataset is truly sophisticated, sourced from reliable names like Nominatim, GeoNames, Pelias, and OpenStreetMap. Positionstack cross-checks, filters and recombines this wealth of data multiple times a day, pushing regular updates via smart algorithms that ensure you always have highly accurate location data, anywhere in the world, and in real time.

We hate to spoil our final verdict, but if you’re looking for a robust, scalable geocoding solution, Positionstack’s resume demands a closer look.

Pricing 

Apilayer set out to provide an affordable alternative to highly expensive enterprise-level geocoding software, and towards that end they have succeeded.

Positionstack comes in five pricing tiers, and supports monthly billing, or yearly subscriptions at a 20% discount. Those tiers are:

• Free – Rated for personal use, you’re still getting a good bit of mileage with 25,000 monthly requests for forward and reverse geocoding, outputted in the JSON format. You don’t get a lot of advanced features or customer support, but we’ve already shown you what a valuable resource their Documentation page is. This tier is free of charge, and free of obligation–you don’t even have to provide credit card details to get started.
• Basic – The entry-level commercial package. Basic subscribers quadruple their monthly quota to 100,000 geocoding requests, plus get access to advanced features like HTTPS encryption, multiple output options (JSON, XML, GeoJSON), embeddable maps, multiple languages, and more. Get a commercial Positionstack license for just $9.99 per month.
• Professional – Positionstack’s most popular offering, the Professional tier offers a tenfold increase in geocoding requests–up to 1,000,000 per month. All the goodies from the Basic tier are present and then some, notably including batch requests for heavy-duty applications. This tier clocks in at $49.99 per month.
• Business – Moving into enterprise-scale performance, the Business tier balloons the monthly quota to a whopping 3,000,000 requests. Once again, every advanced feature is fully available, backed by Positionstack’s passionate customer support team to help you get the most out of them. $99.99 per month.
• Enterprise – This is the tier in which standard offers go out the window, and the customer is king. You have precise needs that demand custom solutions, and Positionstack is at the ready to achieve your goals. You dictate your monthly volume requests, even (especially) if they’re variable. Need more horsepower from the API? Reach out to support for custom-built solutions. Contact Positionstack for a quote.

Verdict

Positionstack does precisely what it set out to do: bring enterprise-level geocoding down from price points otherwise out of budget to most SMBs, without sacrificing performance. Their API is well-documented and easy to use, but features robust integration across all major programming languages for maximum utility. The number of requests Positionstack routinely handles is staggering, while their dataset is smartly maintained for truly global reach in real-time geocoding. If you’re in the market for this type of product, don’t sleep on Positionstack.

What sort of integration do you have planned? How will you make use of geocoding in your business? Do you have any questions or comments on Positionstack? Leave us a note in the comments below.