Dapatkan Geocoding Tingkat Perusahaan Gratis dengan API Positionstack (ULASAN)

Anda tidak harus menjadi Google Maps untuk mendapatkan nilai dari geocoding. Dan, terima kasih kepada Positionstack, Anda juga tidak perlu anggaran teknologi Big G untuk melakukannya. Hari ini, kami meninjau API kuat Positionstack, yang bertujuan untuk membuat tingkat perusahaan maju dan mundur geocoding sangat terjangkau dan bisa digunakan.

Posisi Belakang 101

Jadi, mengapa Anda harus bersusah payah membaca ulasan 2.000 kata di Posisi belakang, dan apa yang ingin Anda dapatkan? Jawabannya terdengar lucu, tetapi akurat: itu seluruh dunia.

Pertimbangkan sejenak berapa banyak tempat yang ada di peta dunia. Sekarang, gandakan angka itu di kepala Anda dengan setiap bagian metadata yang perlu diketahui bisnis Anda tentang tempat-tempat itu. Itulah yang ditawarkan Positionstack, dan kemudian beberapa.

Mari kita lihat beberapa statistik cepat tentang Positionstack:

• Miliaran aktual permintaan pencarian geocoding diproses setiap jam, setiap hari; dengan waktu aktif 100% dan waktu respons <100 ms
• Infrastruktur berbasis cloud, sangat skalabel
instagram viewer
• Data waktu-nyata pada setiap negara di dunia, dikompilasi ke dalam sebuah kumpulan data yang diperbarui setiap beberapa jam
• Paket langganan yang proporsional dan dengan harga bersaing; ditambah kuota bulanan 10.000 permintaan yang tak tertandingi untuk pengguna Gratis
• Dukungan integrasi untuk semua bahasa pemrograman utama
• Dokumentasi yang lengkap dan mudah dibaca lengkap dengan cuplikan kode
• Tim kepuasan pelanggan kelas dunia dengan pengalaman melayani klien seperti Zendesk, Slack, LinkedIn, Lyft, Apple dan Amazon

Positionstack tentu memiliki asal-usulnya, tetapi jika Anda tidak yakin dengan beberapa poin, mari kita selami bagaimana rasanya menggunakan API.

Panduan Quickstart 3-Langkah Positionstack

Jika Anda menghabiskan waktu di situs web mereka, Anda akan melihat bahwa Positionstack sangat menekankan kemudahan penggunaan sebagai titik penjualan utama ke API mereka. Selama proses pendaftaran, Anda akan segera melihat itu cukup benar. Faktanya, hal pertama yang Anda lihat setelah mengetik kredensial akun Anda adalah peta jalan cepat tentang apa yang diperlukan untuk bangun dan berjalan dengan Positionstack dalam tiga langkah mudah. Mari lihat:

1. Setel kunci akses API Anda - Secara default, Anda menyerahkan kunci akses yang siap keluar dari kotak. Namun, Anda dapat dengan mudah mengatur ulang ini di telepon sesuai kebutuhan.
2. Pilih titik akhir API - Kami membahas titik akhir API secara lebih mendalam pada bagian berikutnya, tetapi untuk saat ini cukup pahami bahwa langkah ini mengacu pada mengonfigurasi jenis data apa yang dikembalikan ketika aplikasi Anda membuat permintaan ke Positionstack. Di sinilah Anda pertama-tama akan melihat URL dasar, di mana Anda menargetkan permintaan Anda, tetapi itu juga muncul dalam dokumentasi. Terakhir, kami melihat contoh permintaan API, yang hanya terdiri dari beberapa baris kode yang mudah.
3. Integrasi aplikasi - Langkah terakhir mengacu pada integrasi final API Positionstack ke dalam aplikasi Anda. Ada cukup banyak untuk mengetahui tentang proses ini, dan sebagian besar dicakup dalam dokumentasi. Yang penting di sini adalah: Tim dukungan Positionstack mendukung Anda, dan akan menawarkan sebanyak atau sedikit bantuan yang Anda butuhkan untuk mengonfigurasi dan mengintegrasikan API mereka ke dalam aplikasi Anda.

Cukup mudah bukan? API mungkin tampak menakutkan bagi orang-orang tanpa pengetahuan IT yang luas pada awalnya. Tapi segera, Positionstack menghibur Anda dengan pengetahuan bahwa tidak hanya itu mudah, mereka akan membantu Anda sepanjang jalan dengan dokumentasi luar biasa dari desain cerdas mereka. Ini membantu mereka memiliki tim ahli yang bersemangat yang siap membantu Anda juga.

Dashboard Positionstack Anda

Menggandakan nilai inti dari keramahan pengguna, Positionstack menawarkan Dashboard yang ramping dan rapi tempat Anda dapat mengakses semua yang perlu Anda ketahui tentang API Anda. Mari kita lihat opsi bilah samping:

• Dasbor - Di sini Anda akan menemukan notifikasi (biasanya memberi tahu Anda saat Anda melewati ambang penggunaan tertentu), lalu menautkan ke Panduan Langkah Cepat 3-Langkah dan halaman Dokumentasi mereka. Ada juga ikhtisar kunci API Anda, langganan Anda saat ini, detail akun, dan metode pembayaran.
• Tingkatkan / Berlangganan - Anda dapat mengubah langganan Anda di salah satu dari dua opsi ini. Tingkatkan versi kapan saja, meskipun jika Anda ingin beralih antara paket bulanan atau tahunan di kedua arah, Anda harus terlebih dahulu menurunkan versi ke akun Gratis, lalu pilih opsi yang diinginkan. Dukungan Positionstack bersedia membantu Anda jika Anda perlu bantuan dalam melakukan ini.
• Akun / Pembayaran - Ini cukup jelas; salah satu tab akan memungkinkan Anda untuk memperbarui kredensial Anda kapan saja. Harus dikatakan bahwa kami menghargai bahwa mereka tidak mengubur kontrol dasar ini dalam antarmuka yang dirancang berlebihan dan mencolok. WYSIWYG.
• Penggunaan API - Kemungkinan tab yang paling sering Anda kunjungi lagi, di sini Anda dapat menemukan berapa banyak kuota permintaan bulanan yang telah Anda makan sejauh ini. Ada juga bagian praktis yang menunjukkan statistik penggunaan Anda dari waktu ke waktu, sehingga Anda dapat menyesuaikan strategi Anda.

Dokumentasi API

Sekarang kita sampai ke jantung dan jiwa dari penawaran Positionstack: the Dokumentasi API. Pertimbangkan halaman ini sebagai manual pengguna masuk, yang merinci setiap titik akhir API, parameternya, dan jenis informasi apa yang akan mereka kembalikan.

Halaman ini dipecah menjadi lima bagian yang berbeda. Kami akan membahasnya masing-masing, meluangkan waktu dan bertele-tele untuk memberikan beberapa konteks agar Anda lebih memahami apa yang akan Anda temukan.

Mulai

Di sini, Anda akan temukan fungsi dasar yang berlaku untuk setiap permintaan yang Anda lakukan dengan Positionstack. Ini adalah:

• kunci API - Kunci API Anda seperti paspor digital yang akan Anda gunakan untuk mengakses dataset Positionstack. Tanpa itu, API tidak berguna bagi Anda. Jika Anda yakin itu telah dikompromikan, Anda dapat dengan mudah memutar kunci lama Anda untuk yang baru.
• Enkripsi - Enkripsi SSL 256-bit digunakan di seluruh Internet, dan merupakan standar industri untuk alasan keamanan. Meskipun Anda akan memerlukan paket Dasar atau lebih baik untuk mengenkripsi komunikasi aplikasi Anda dengan server Positionstack, itu layak untuk investasi sendiri. Untuk membangkitkan enkripsi, cukup ubah HTTP ke HTTPS di URL basis API. Sederhana!
• Callback JSON - Kami tidak akan membahas terlalu banyak detail teknis tentang cara kerjanya, tetapi jika permintaan API Anda terhalang oleh kebijakan yang sama-asal, Anda menggunakan panggilan balik JSON untuk memengaruhi penyelesaian masalah. Pada dasarnya, Anda meminta data dari skrip eksternal, yang tidak terhambat oleh masalah lintas-domain.
• Kesalahan API - Seperti apa pun, terkadang permintaan API Anda akan mengalami kesalahan. Positionstack memahami hal ini, dan telah membuat fungsionalitas pelaporan kesalahan di dalam aplikasi mereka untuk membantu Anda mengidentifikasi apa yang salah. Kegagalan permintaan API akan secara otomatis mengembalikan objek kesalahan dalam format JSON, ditambah kode, pesan, dan sub-objek konteks untuk memberikan konteks untuk kesalahan tersebut.

Titik Akhir API

Bagian ini mendokumentasikan fungsionalitas meat-and-potato Positionstack, yang artinya maju dan mundur geocoding. Jika Anda tidak 100% yakin apa perbedaannya, anggap geocoding sebagai jalan dua arah tempat Anda dapat menerjemahkan tempat dan alamat yang ditulis dalam Bahasa Inggris sederhana ke data lokasi seperti koordinat dan alamat IP, dan visa-sebaliknya.

Jadi, Anda akan menggunakan geocoding maju untuk mengubah lokasi Menara Eiffel menjadi koordinat. Demikian pula, Anda dapat mengetahui alamat jalan yang terkait dengan alamat IP dengan menggunakan geocoding terbalik. Cukup sederhana!

Teruskan / balikkan permintaan geocoding

Untuk membuat permintaan dasar untuk kedua jenis geocoding, Anda harus menambahkan titik akhir yang sesuai (/forward atau /reverse) ke URL dasar API. Selanjutnya, Anda akan memberikan kunci akses Anda, lalu buat a pertanyaan baik menggunakan alamat lokasi Plain-English atau data lokasi terkait – dan, voila! Ini akan terlihat seperti ini:

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

atau

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

Tentu saja, dataset Positionstack mengandung lebih banyak, lebih dari sekadar alamat dan koordinat. Anda dapat menguraikan kategorisasi lain ini melalui penggunaan berbagai parameter. Berikut ini contoh apa a meneruskan geocoding permintaan, menanyakan Gedung Putih, terlihat seperti:

{"data": {"hasil": [{"latitude": 38.897675, "bujur": -77.036547, "label": "1600 Pennsylvania Avenue NW, Washington, DC, AS", "name": "1600 Pennsylvania Avenue NW "," type ":" address "," number ":" 1600 "," street ":" Pennsylvania Avenue NW "," postal_code ":" 20500 "," confidence ": 1," region ":" Distrik dari Columbia "," region_code ":" DC "," administrative_area ": null," neighborhood ":" White House Grounds "," country ":" Amerika Serikat "," country_code ":" US ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Menariknya, jika Anda melakukan membalikkan geocoding meminta menggunakan perkiraan perkiraan Gedung Putih, hasil yang dikembalikan akan terlihat hampir sama, kecuali Anda juga akan melihat perbedaannya jarak antara koordinat Anda dan koordinat resmi Gedung Putih seperti yang muncul dalam dataset Positionstack.

Alasan untuk kesamaan ini adalah bahwa kedua titik akhir menggunakan array yang sama dari parameter GET, dan dengan demikian mampu mengembalikan (hampir) objek respons yang sama. Itu berarti bahwa apa pun data awal yang harus Anda lewati, Anda dapat memperoleh pelengkap lengkap data lokasi sebagai imbalan. (Dimungkinkan untuk mempersempit hasil ini menggunakan API bidang parameter, tapi kami akan menyentuhnya nanti.)

Catatan: Halaman dokumentasi Positionstack sepenuhnya merinci setiap parameter dan objek respons, jadi pastikan untuk memeriksanya!

Permintaan batch

Judul utama terakhir dalam pengaturan dokumentasi ini berkaitan dengan permintaan batch. Yang harus Anda lakukan hanyalah memohon batch parameter, lalu beberapa sarang pertanyaan instance (bersama dengan parameter yang Anda inginkan) di bawahnya dalam satu permintaan, dan API Positionstack menangani sisanya. Sangat sederhana, dan terlihat seperti ini:

{"batch": [{"query": "Main Street", "country": "US", "region": "Minnesota"}, {"query": "Main Street", "negara": "AS", "wilayah": "Illinois"}, {"kueri": "Jalan Utama", "negara": "AS", "wilayah": "Missouri"} ] }

Data Lanjutan

Selain parameter lokasi dasar, Anda selanjutnya dapat menyesuaikan permintaan API Anda untuk mengembalikan lebih banyak data lanjutan. Ini termasuk:

• Peta yang Dapat Disematkan - Mengembalikan objek map_url yang tertaut ke hasil geocoding Anda, yang dapat Anda gunakan untuk membuat representasi peta visual yang menarik di situs web atau aplikasi Anda.
• Modul Negara - Tidak seperti parameter lain yang mengembalikan hingga beberapa objek respons, country_module mengembalikan array data yang luar biasa tentang negara Anda yang ditanyakan. Bukan hanya koordinat dan alamat, baik; ini adalah ibu kota, bendera, nama resmi, status sebagai negara (atau tidak) yang terkurung daratan, mata uang yang digunakan, bahasa yang diucapkan, kode panggilan, dan banyak lagi.
• Modul Sun - Humor, dokumentasi Positionstack menggambarkan ini sebagai data "Astrologi". Anda tidak akan mendapatkan horoskop Anda dengan parameter ini, tetapi Anda akan melihat data tentang kapan matahari terbit dan terbenam, menurut kronologi astronomi, sipil, dan bahari.
• Modul Zona Waktu - Menambahkan timezone_module untuk mengembalikan offset lokasi GMT dalam detik atau sebagai string bahasa alami.
• Modul Kotak Berlari - Jika satu pasangan x / y koordinat tidak tepat untuk tugas Anda, coba kotak pembatas, yang melingkupi area dengan nilai minimum dan maksimum untuk bujur dan lintang.

Opsi tambahan

API Positionstack memiliki banyak data untuk Anda, tetapi untungnya itu memberi Anda alat tambahan untuk mengelola kumpulan informasi ini.

• Tentukan Bidang Respons - Kami telah membahas secara mendalam berapa banyak data yang dapat dikembalikan Positionstack, tetapi perlu diingat bahwa semua data tersebut dikenakan biaya. Jika Anda ingin membatasi permintaan bulanan, Anda dapat melakukannya dengan bidang Menambahkan bidang = hasil.flag, misalnya, akan menyebabkan API hanya menampilkan bendera negara yang Anda tanyakan. Anda bisa memohon bidang sebanyak yang Anda butuhkan untuk mendapatkan dataset spesifik yang Anda butuhkan.
• Tentukan Format Output - Pelanggan gratis terbatas pada format JSON untuk hasil geocoding mereka yang dikembalikan. Namun, pelanggan yang membayar dapat menambahkan keluaran atas permintaan mereka untuk menentukan JSON, XML, atau GeoJSON sebagaimana diperlukan.

Contoh Kode

Ketika Positionstack mengatakan mereka di sini untuk membantu Anda, mereka bersungguh-sungguh. Kami telah melihat betapa teliti dokumentasi mereka, tetapi mereka menambahkannya dengan praktis contoh kode dalam semua bahasa yang didukung API mereka. Kami tidak akan menyalin / menempelkan kode itu di sini, tetapi untuk referensi cepat, bahasa-bahasa itu adalah:

• Python
• Nodejs
• jQuery
• Pergilah
• Rubi

Bukti dan kinerja

Pada titik ini, harus jelas bahwa Positionstack mampu melakukan cukup banyak. Tapi, seberapa baik apakah ini melakukan hal-hal ini?

Pertama, mari kita pertimbangkan beberapa konteks. Positionstack adalah salah satu dari 20+ layanan microsoft API di ekosistem berbasis cloud Apilayer. Bersama-sama, API ini melayani lebih dari sejuta klien B2B dari startup hingga perusahaan. Beberapa pelanggan mereka yang paling terkenal termasuk Amazon, Apple, Slack, LinkedIn, dan banyak lagi nama rumah tangga. Jelas, mereka memiliki beberapa infrastruktur yang kuat untuk menangani skala permintaan ini.

Dengan kelebihannya sendiri, Positionstack memenuhi hingga setingkatnya, dengan uptime 100% yang luar biasa sepanjang 2020 pada saat penulisan. Ini bahkan lebih mengesankan ketika Anda mempertimbangkan API secara rutin memproses lebih dari satu miliar pencarian geocode per hari per klien ikan paus, belum lagi deretan permintaan simultan yang datang dari kandang pelanggan SMB mereka. Terlebih lagi, permintaan ini biasanya mengumpulkan respons antara 10 dan 100 ms.

Dalam buku kami, itu adalah keajaiban teknologi, terutama mengingat seberapa agresif harga penawaran SaaS ini.

Dan bukan hanya kekuatan mentah yang membuat Positionstack begitu menarik. Dataset mereka benar-benar canggih, bersumber dari nama yang dapat diandalkan seperti Nominatim, GeoNames, Pelias, dan OpenStreetMap. Positionstack memeriksa silang, memfilter, dan menggabungkan kembali kekayaan data ini beberapa kali sehari, mendorong pembaruan rutin melalui algoritma pintar yang memastikan Anda selalu memiliki data lokasi yang sangat akurat, di mana saja di dunia, dan secara nyata waktu.

Kami benci merusak putusan akhir kami, tetapi jika Anda mencari solusi geocoding yang kuat dan dapat diskalakan, resume Positionstack menuntut tampilan yang lebih dekat.

Harga

Apilayer berangkat untuk memberikan alternatif yang terjangkau untuk perangkat lunak geocoding tingkat perusahaan yang sangat mahal, dan untuk itu mereka berhasil.

Positionstack datang dalam lima harga tingkatan, dan mendukung penagihan bulanan, atau langganan tahunan dengan diskon 20%. Tingkatan tersebut adalah:

• Gratis - Dinilai untuk penggunaan pribadi, Anda masih mendapatkan jarak tempuh yang bagus dengan 25.000 permintaan bulanan untuk geocoding maju dan mundur, yang dihasilkan dalam format JSON. Anda tidak mendapatkan banyak fitur canggih atau dukungan pelanggan, tetapi kami telah menunjukkan kepada Anda betapa sumber daya yang berharga dari halaman Dokumentasi mereka. Tingkat ini tidak dikenai biaya, dan bebas dari kewajiban - Anda bahkan tidak perlu memberikan detail kartu kredit untuk memulai.
• Dasar - Paket komersial entry-level. Pelanggan dasar empat kali lipat kuota bulanan mereka menjadi 100.000 permintaan geocoding, plus dapatkan akses ke tingkat lanjut fitur seperti enkripsi HTTPS, beberapa opsi keluaran (JSON, XML, GeoJSON), peta yang dapat disematkan, banyak bahasa, dan lainnya. Dapatkan lisensi Positionstack komersial hanya dengan $ 9,99 per bulan.
• Profesional - Penawaran Positionstack yang paling populer, tier Profesional menawarkan peningkatan sepuluh kali lipat dalam permintaan geocoding – hingga 1.000.000 per bulan. Semua barang dari tingkat Dasar hadir dan kemudian beberapa, terutama termasuk permintaan batch untuk aplikasi tugas berat. Tingkat ini jam di $ 49,99 per bulan.
• Bisnis - Pindah ke kinerja skala perusahaan, tingkat Bisnis menggelembungkan kuota bulanan ke 3.000.000 permintaan kekalahan. Sekali lagi, setiap fitur canggih sepenuhnya tersedia, didukung oleh tim dukungan pelanggan yang bersemangat dari Positionstack untuk membantu Anda mendapatkan yang terbaik dari mereka. $ 99,99 per bulan.
• Perusahaan - Ini adalah tingkatan di mana penawaran standar keluar jendela, dan pelanggan adalah raja. Anda memiliki kebutuhan tepat yang menuntut solusi khusus, dan Positionstack siap untuk mencapai tujuan Anda. Anda mendikte permintaan volume bulanan Anda, bahkan (terutama) jika itu variabel. Perlu lebih banyak tenaga kuda dari API? Jangkau dukungan untuk solusi yang dibuat khusus. Hubungi Positionstack untuk penawaran.

Putusan

Positionstack melakukan dengan tepat apa yang ditetapkan untuk dilakukan: membawa geocoding tingkat perusahaan turun dari titik harga keluar dari anggaran ke sebagian besar UKM, tanpa mengorbankan kinerja. API mereka didokumentasikan dengan baik dan mudah digunakan, tetapi memiliki integrasi yang kuat di semua bahasa pemrograman utama untuk utilitas maksimum. Jumlah permintaan yang ditangani Positionstack secara mengejutkan sangat mengejutkan, sementara dataset mereka dipelihara dengan cerdas untuk jangkauan global sesungguhnya dalam geocoding waktu-nyata. Jika Anda berada di pasar untuk jenis produk ini, jangan tidur di Positionstack.

Integrasi seperti apa yang Anda rencanakan? Bagaimana Anda memanfaatkan geocoding dalam bisnis Anda? Apakah Anda memiliki pertanyaan atau komentar tentang Positionstack? Tinggalkan kami catatan di komentar di bawah ini.