Dapatkan Geocoding Tingkat Perusahaan Gratis dengan Positionstack API (TINJAUAN)

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

Tumpukan posisi 101

Jadi, mengapa Anda harus repot-repot membaca ulasan 2.000+ kata di Positionstack , dan apa yang Anda dapatkan? Jawabannya terdengar lucu, tapi itu akurat: yang seluruh dunia .

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

Mari kita lihat beberapa statistik singkat tentang Positionstack:

• Miliaran permintaan pencarian geocoding aktual diproses setiap jam, setiap hari; dengan waktu aktif 100% dan <100ms="" response="">
• Infrastruktur berbasis cloud yang sangat skalabel
• Data real-time di setiap negara di dunia, dikompilasi menjadi kumpulan data besar yang diperbarui setiap beberapa jam
• Paket berlangganan yang dibagikan dengan murah hati dengan harga bersaing; ditambah kuota bulanan 10.000 permintaan yang tak tertandingi untuk pengguna Gratis
• Dukungan integrasi untuk semua bahasa pemrograman utama
• Dokumentasi yang komprehensif 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 silsilahnya, tetapi jika Anda tidak yakin dengan beberapa poin, mari selami lebih dalam seperti apa sebenarnya menggunakan API.

Panduan Memulai Cepat 3-Langkah Positionstack

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

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

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

Dasbor Positionstack Anda

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

• Dasbor – Di sini Anda akan menemukan pemberitahuan (biasanya mengingatkan Anda saat Anda melewati ambang batas penggunaan tertentu), lalu menautkan ke Panduan Memulai Cepat 3-Langkah dan halaman Dokumentasinya. Ada juga ikhtisar kunci API Anda, langganan Anda saat ini, detail akun, dan metode pembayaran.
• Tingkatkan/Berlangganan – Anda dapat mengubah langganan 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 membutuhkan bantuan untuk melakukan ini.
• Akun/Pembayaran – Ini sudah cukup jelas; salah satu tab akan memungkinkan Anda 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, di sini Anda dapat menemukan berapa banyak kuota permintaan bulanan yang telah Anda habiskan 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 masuk ke inti dan jiwa dari penawaran Positionstack: dokumentasi API . Pertimbangkan halaman ini sebagai panduan pengguna masuk Anda, 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 membahas masing-masing, meluangkan waktu dan bertele-tele untuk memberikan beberapa konteks bagi Anda untuk lebih memahami apa yang akan Anda temukan.

Mulai

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

• Kunci API – Kunci API Anda seperti paspor digital yang akan Anda gunakan untuk mengakses kumpulan data Positionstack. Tanpa itu, API tidak berguna bagi Anda. Jika Anda yakin itu telah disusupi, 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 keamanan karena alasan yang baik. Meskipun Anda memerlukan paket Dasar atau yang lebih baik untuk mengenkripsi komunikasi aplikasi Anda dengan server Positionstack, itu sepadan dengan investasinya sendiri. Untuk membangkitkan enkripsi, cukup ubah HTTP ke HTTPS di URL dasar API. Sederhana!
• Panggilan Balik JSON – Kami tidak akan membahas terlalu banyak detail teknis tentang cara kerjanya, tetapi jika permintaan API Anda terhalang oleh kebijakan asal yang sama, Anda menggunakan panggilan balik JSON untuk memengaruhi solusi. Pada dasarnya, Anda meminta data dari skrip eksternal, yang tidak terjebak dengan masalah lintas domain.
• Kesalahan API – Seperti apa pun, terkadang permintaan API Anda akan mengalami kesalahan. Positionstack memahami hal ini, dan telah membangun fungsionalitas pelaporan kesalahan ke dalam aplikasi mereka untuk membantu Anda mengidentifikasi apa yang salah. Kegagalan permintaan API akan secara otomatis mengembalikan objek kesalahan dalam format JSON, plus kode, pesan, dan sub-objek konteks untuk memberikan konteks kesalahan.

Titik Akhir API

Bagian ini mendokumentasikan fungsionalitas daging dan kentang dari Positionstack, yaitu geocoding maju dan mundur. Jika Anda tidak 100% yakin apa perbedaannya, pikirkan geocoding sebagai jalan dua arah di mana Anda dapat menerjemahkan tempat dan alamat yang ditulis dalam bahasa Inggris sederhana ke data lokasi seperti koordinat dan alamat IP, dan 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, setelah semua!

Maju/mundurkan permintaan geocoding

Untuk membuat permintaan dasar untuk salah satu jenis geocoding, Anda harus menambahkan titik akhir yang sesuai ( /forward  atau /reverse ) ke URL dasar API. Selanjutnya, Anda akan memberikan kunci akses Anda, lalu membuat kueri menggunakan alamat lokasi Bahasa Inggris Biasa atau data lokasi terkait–dan, voila! Ini akan terlihat seperti ini:

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

atau

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

Tentu saja, dataset Positionstack berisi lebih dari sekadar alamat dan koordinat. Anda dapat mengurai kategorisasi lain ini melalui penggunaan berbagai parameter. Berikut adalah contoh permintaan geocoding maju , yang menanyakan Gedung Putih, seperti:

{
   "data": {
      "hasil": [
         {
            "lintang": 38.897675,
            "bujur": -77.036547,
            "label": "1600 Pennsylvania Avenue NW, Washington, DC, AS",
            "nama": "1600 Pennsylvania Avenue NW",
            "tipe": "alamat",
            "angka": "1600",
            "jalan": "Pennsylvania Avenue NW",
            "kode_pos": "20500",
            "kepercayaan diri": 1,
            "wilayah": "Distrik Kolombia",
            "region_code": "DC",
            "administratif_area": ​​nol,
            "lingkungan": "Lapangan Gedung Putih",
            "negara": "Amerika Serikat",
            "kode_negara": "AS",
            "map_url": "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

Menariknya, jika Anda melakukan permintaan geocoding terbalik menggunakan perkiraan koordinat Gedung Putih, hasil yang dikembalikan akan terlihat hampir sama, kecuali Anda juga akan melihat perbedaan jarak antara koordinat Anda dan koordinat resmi Gedung Putih seperti yang muncul di Positionstack. Himpunan data.

Alasan kesamaan ini adalah karena kedua titik akhir menggunakan larik parameter GET yang sama, dan dengan demikian mampu mengembalikan (hampir) objek respons yang sama. Artinya, apa pun data awal yang harus Anda gunakan, Anda bisa mendapatkan data lokasi yang lengkap sebagai balasannya. (Dimungkinkan untuk mempersempit hasil ini menggunakan parameter bidang  API , tetapi kami akan membahasnya lebih lanjut 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 adalah memanggil parameter batch  , lalu membuat beberapa instance kueri (bersama dengan parameter yang Anda inginkan) di bawahnya dalam satu permintaan, dan API Positionstack menangani sisanya. Ini sangat sederhana, dan terlihat 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 dasar, Anda dapat menyesuaikan lebih lanjut permintaan API Anda untuk mengembalikan data yang lebih canggih . Ini termasuk:

• Peta yang Dapat Disematkan – Mengembalikan objek map_url yang ditautkan 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 menampilkan beberapa objek respons, country_module mengembalikan larik data yang luar biasa tentang negara yang Anda tanyakan. Bukan hanya koordinat dan alamat; itu ibu kota, bendera, nama resmi, status sebagai negara yang terkurung daratan (atau tidak), mata uang yang digunakan, bahasa yang digunakan, kode panggilan, dan banyak lagi.
• Sun Module – Secara lucu, 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 – Tambahkan timezone_module untuk mengembalikan offset GMT lokasi dalam hitungan detik atau sebagai string bahasa alami.
• Modul Kotak Batas – Jika sepasang koordinat x/y tidak tepat untuk tugas Anda, coba kotak pembatas, yang membungkus area dengan nilai minimum dan maksimum untuk garis bujur dan garis lintang.

Opsi Tambahan

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

• Specify Response Fields – Kami telah membahas secara mendalam berapa banyak data yang dapat dikembalikan oleh Positionstack, namun perlu diingat bahwa semua data tersebut memerlukan 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 dimintai keterangan. Anda dapat memanggil bidang sebanyak yang Anda butuhkan untuk mendapatkan kumpulan data spesifik yang Anda butuhkan.
• Tentukan Format Output – Pelanggan gratis terbatas pada format JSON untuk hasil geocoding yang mereka kembalikan. Pelanggan yang membayar, bagaimanapun, dapat menambahkan output pada permintaan mereka untuk menentukan JSON, XML, atau GeoJSON seperlunya. 

Contoh Kode 

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

• Python
• Nodejs
• jQuery
• Pergi
• Rubi

Bukti dan kinerja

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

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

Berdasarkan kemampuannya sendiri, Positionstack memenuhi silsilahnya, dengan waktu aktif 100% yang luar biasa sepanjang tahun 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 paus, belum lagi deretan memusingkan permintaan simultan yang datang dari pelanggan UKM mereka yang stabil. Terlebih lagi, permintaan ini biasanya mengumpulkan tanggapan antara 10 dan 100 md.

Dalam buku kami, itu adalah keajaiban teknologi, terutama mengingat betapa agresifnya harga penawaran SaaS ini.

Dan bukan hanya kekuatan mentah yang membuat Positionstack begitu menarik. Dataset mereka benar-benar canggih, bersumber dari nama-nama terpercaya seperti Nominatim, GeoNames, Pelias, dan OpenStreetMap. Positionstack cross-check, memfilter, dan menggabungkan kembali kekayaan data ini beberapa kali sehari, mendorong pembaruan rutin melalui algoritme cerdas yang memastikan Anda selalu memiliki data lokasi yang sangat akurat, di mana pun di dunia, dan dalam waktu nyata.

Kami tidak ingin merusak keputusan akhir kami, tetapi jika Anda mencari solusi geocoding yang kuat dan dapat diskalakan, resume Positionstack menuntut untuk dilihat lebih dekat.

harga 

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

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

• Gratis – Dinilai untuk penggunaan pribadi, Anda masih mendapatkan sedikit jarak tempuh dengan 25.000 permintaan bulanan untuk geocoding maju dan mundur, yang dihasilkan dalam format JSON. Anda tidak mendapatkan banyak fitur lanjutan atau dukungan pelanggan, tetapi kami telah menunjukkan kepada Anda betapa berharganya halaman Dokumentasi mereka. Tingkat ini gratis, dan bebas kewajiban–Anda bahkan tidak perlu memberikan detail kartu kredit untuk memulai.
• Basic – Paket komersial tingkat pemula. Pelanggan dasar melipatgandakan kuota bulanan mereka menjadi 100.000 permintaan geocoding, plus mendapatkan akses ke fitur lanjutan seperti enkripsi HTTPS, beberapa opsi keluaran (JSON, XML, GeoJSON), peta yang dapat disematkan, banyak bahasa, dan banyak lagi. Dapatkan lisensi Positionstack komersial hanya dengan $9,99 per bulan.
• Professional – Penawaran paling populer dari Positionstack, tingkat 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. Jam tingkat ini di $ 49,99 per bulan.
• Bisnis – Beralih ke kinerja skala perusahaan, tingkat Bisnis meningkatkan kuota bulanan menjadi 3.000.000 permintaan. Sekali lagi, setiap fitur lanjutan tersedia sepenuhnya, didukung oleh tim dukungan pelanggan yang bersemangat dari Positionstack untuk membantu Anda memaksimalkannya. $99,99 per bulan.
• Perusahaan – Ini adalah tingkat di mana penawaran standar keluar jendela, dan pelanggan adalah raja. Anda memiliki kebutuhan yang 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? Hubungi dukungan untuk solusi yang dibuat khusus. Hubungi Positionstack untuk mendapatkan penawaran.

Putusan

Positionstack melakukan persis seperti yang ditetapkan untuk dilakukan: menurunkan geocoding tingkat perusahaan dari titik harga jika tidak anggaran untuk sebagian besar UKM, tanpa mengorbankan kinerja. API mereka terdokumentasi dengan baik dan mudah digunakan, tetapi memiliki integrasi yang kuat di semua bahasa pemrograman utama untuk utilitas maksimum. Jumlah permintaan yang secara rutin ditangani oleh Positionstack sangat mengejutkan, sementara kumpulan datanya dikelola dengan cerdas untuk jangkauan global yang 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 akan menggunakan geocoding dalam bisnis Anda? Apakah Anda memiliki pertanyaan atau komentar tentang Positionstack? Tinggalkan kami catatan di komentar di bawah.