Cgeo: Geocaching.com API

Dibuat pada 12 Agu 2011  ·  46Komentar  ·  Sumber: cgeo/cgeo

Adakah yang pernah mulai mengerjakan implementasi yang menggunakan API baru dari Groundspeak?
Apakah setidaknya ada yang meminta dokumentasi API dan melihat berapa banyak upaya yang mungkin diperlukan untuk beralih ke API baru?
Jika tidak, saya akan menawarkan untuk menghubungi Groundspeak dan melihat dokumentasi untuk mencoba membuat perkiraan kasar tentang jumlah perubahan yang akan tersirat dalam perubahan.

Feature Request

Komentar yang paling membantu

Nah, Groundspeak menunjukkan kesediaan untuk membahas masalah non-teknis ini dan kami sudah memberikan beberapa proposal. Namun untuk membahas ini lebih lanjut, kita mungkin perlu melihat dampak/perbedaan antara penggunaan API dan implementasi saat ini dalam alur penggunaan.

Saya lebih suka tidak memberikan detail apa pun di forum terbuka ini, namun kami pasti akan membawa siapa pun yang bersedia bekerja pada implementasi API ke dalam diskusi ini serta melibatkan pengguna kami sebelum keputusan akhir.

Semua 46 komentar

Ini tentu saja harus dikoordinasikan dengan #9...

mana api barunya?? Saya pikir jika ada API yang mendukung semua fitur, kita harus menggunakan ini. ( tetapi hanya jika groundpeak mengubah API segera jika mereka membuat pembaruan di geocaching.com )

Api keluar untuk aplikasi tertentu saja. Cgeo adalah satu, cgeo opensource tidak

Saya berharap mereka tidak mengubah API dengan setiap perubahan pada Halaman Web...
Jika tidak, kami dapat terus merayapi halaman dan memperbarui kode kami dengan setiap perubahan yang diterapkan GC.com ke halaman Web mereka...
Saya membaca bahwa API sekarang akan tersedia untuk anggota premium dan dasar dengan beberapa batasan untuk anggota dasar.
Jika Anda tidak keberatan, saya akan menghubungi Ryan di Groundspeak dan meminta dokumentasi API darinya.
Florian.

Kami memiliki dokumen, kami tidak memiliki kunci akses api

Saya membaca pemberitahuan tentang Api yang akan datang beberapa minggu yang lalu. Apakah ada yang punya beberapa petunjuk lagi?

:( Maksud saya mereka memperbarui perpustakaan setelah perubahan di gc.com :D

Jadi jika Anda tidak keberatan, saya akan meminta Groundspeak untuk kunci akses api untuk c-geo (dan juga mengklarifikasi dengan Groundspeak bahwa c-geo-opensource pada dasarnya sama dengan c-geo hanya dengan klarifikasi tentang lisensi opensource ).
Bisakah Anda mengirimi saya salinan dokumentasinya atau - jika ada di web di suatu tempat - beri saya tautan ke sana?
Florian.

Sammy memang berkomunikasi. Mari kita tunggu dia

Saya menghubungi mereka beberapa minggu yang lalu. Tanggapannya adalah satu baris yang memberi tahu saya untuk mengirimi mereka aplikasi untuk mengakses API. Tampaknya tidak ada dokumentasi publik, Anda memerlukan kunci API untuk akhir aplikasi, setiap pengguna harus mendapatkan kunci melalui prosedur OAuth. Dan mereka menyebutnya "API publik"...

Saya pikir kita tidak harus melakukan hardcode. Akan lebih mudah dengan interface konektor sehingga tidak ada bedanya jika kita mengimpor dari spidering, API, OC, gpx, web2cgeo...

Sangat. Saya tidak memikirkan otentikasi OAuth ketika saya berpikir untuk beralih ke API baru secara berturut-turut.

@SammysHP : Alice di Groundsheep Wonderland:

"Ketika saya menggunakan sebuah kata," kata Humpty Dumpty dengan nada yang agak mencemooh, "itu berarti apa yang saya pilih - tidak lebih dan tidak kurang."
"Pertanyaannya adalah," kata Alice, "apakah kamu bisa membuat kata-kata memiliki banyak arti yang berbeda."
"Pertanyaannya adalah," kata Humpty Dumpty, "yang mana yang harus dikuasai -- itu saja."

Kemarin saya mendapat email dari Groundspeak:

Sven yang terhormat,

Terima kasih atas kesabaran Anda saat kami melangkah maju dengan Program API Geocaching.com. Terlampir adalah dua dokumen untuk Anda tinjau. Harap kembalikan Formulir Pendaftaran API yang telah diisi kepada saya dan kami akan mengirimkan Anda Kunci Uji API.

Tujuan dari program API publik ini adalah untuk memungkinkan pihak ketiga yang tepercaya mengembangkan aplikasi dan layanan menggunakan kumpulan data geocaching.com yang terutama akan melayani Anggota Premium Groundspeak, sementara juga memungkinkan sejumlah besar layanan disediakan untuk Anggota Dasar. API akan diberikan bebas royalti, sehingga pengembang dapat menghasilkan pendapatan (atau tidak) sesuai keinginan mereka, tanpa harus membayar royalti ke Groundspeak untuk akses data.

Kami percaya bahwa ini akan memberi Anda kemampuan terbaik untuk melayani komunitas yang lebih luas, termasuk pengguna baru, sambil memberikan peluang tambahan bagi Anggota Dasar untuk meningkatkan layanan Premium penuh. Idealnya, kami ingin anggota yang menikmati pengalaman perkenalan untuk meningkatkan ke Keanggotaan Premium untuk akses aplikasi/layanan penuh. Rincian spesifik mengenai struktur ini terdapat dalam Jadwal A Perjanjian. Perjanjian dengan Persyaratan dan Formulir Pendaftaran API yang telah diisi akan diperlukan sebelum akses basis data Produksi dan peluncuran resmi.

Harap dicatat bahwa, sebagai pengembang tepercaya, kami berharap Anda tidak menyalahgunakan API, baik dalam pementasan maupun produksi. Menggores situs web untuk data geocaching.com tidak diizinkan dalam aplikasi atau layanan apa pun untuk anggota dasar atau premium. Daripada mengizinkan pengikisan, kami lebih memilih untuk mengembangkan panggilan API agar sesuai dengan kebutuhan pengembang tertentu. Jika Anda memiliki pertanyaan tentang tindakan potensial yang Anda rencanakan untuk dilakukan dengan API, harap posting di forum API dan kami akan melakukan yang terbaik untuk mengklarifikasi aturan.

Login melalui Oauth akan diperlukan untuk semua pengguna aplikasi/layanan yang mendukung API. Setelah menerima Formulir Pendaftaran API yang telah diisi, kami akan mengirimkan Anda Kunci Uji untuk Anda mengakses server pementasan. Kemudian, setelah meninjau produk dan fungsionalitas Anda, kami akan melanjutkan dengan Production API Key.

Terima kasih lagi. Kami sangat menantikan untuk bekerja sama dengan Anda.

Salam,

Christy

Christy Luther
Manajer Pengembangan Bisnis
Groundspeak, Inc.
Groundspeak - Bahasa Lokasi
www.groundspeak.com
www.geocching.com

Berikut adalah perjanjian lisensi API: http://www.file-upload.net/download-3675937/Groundspeak-API-License-Agreement-17-08-2011.pdf.html

Masalahnya adalah bahwa kuncinya harus publik karena setiap pengembang mengkompilasi bangunannya sendiri (untuk pengujian dan penggunaan). Dan dari apa yang saya dengar itu adalah masalah bagi Groundspeak.
Jadi saran saya: Tunggu hingga antarmuka konektor terwujud dan kemudian kembangkan penggunaan API sebagai aplikasi terpisah.

Hai, saya segera membaca sekilas perjanjian lisensi. Meskipun saya tidak melihat permintaan eksplisit untuk kerahasiaan sehubungan dengan kunci API yang mungkin berasal dari 4.17 atau 4.18.
Apa yang membunuh konsep konektor eksternal mungkin adalah 4.16 (pekerjaan turunan) dan 5.3 (pengguna akhir - bukan aplikasi lain).
Mengintegrasikannya di c:geo akan melanggar 4.14.
Batas anggota dasar adalah lelucon.
Saya memilih untuk mengabaikannya sampai mereka menemukan model lisensi yang masuk akal.

Saya pikir, tidak apa-apa untuk menempelkan email yang didapat seseorang dari Bryan:

Hai _________,

Kami bersedia memberikan akses API ke CGeo Opensource. Namun, karena kunci lisensi hanya boleh digunakan untuk aplikasi individu, kami khawatir bahwa itu mungkin dibagikan secara publik. Jika dibagikan secara publik, itu dapat digunakan oleh aplikasi lain dan itu akan mengakibatkan Groundspeak terpaksa membatalkan kunci tertentu. Ini tentu saja akan merusak aplikasi karena tidak dapat mengakses data.

Jadi, bisakah Anda membantu saya memahami bagaimana Anda berencana membatasi akses ke kunci Otentikasi? Itu tidak dapat dirilis ke publik dalam keadaan apa pun. Karena ada sejumlah pengembang yang mengerjakan proyek Opensource, kami tahu bahwa hanya dibutuhkan satu pengembang untuk menyediakan kode secara eksternal dan kemudian kami semua akan mengalami masalah. Harap berikan informasi apa pun yang Anda bisa dan kami akan dengan senang hati bekerja secara langsung dengan Anda, atau perwakilan utama proyek, untuk membuat ini berhasil.

Saya telah menyertakan Christy Luther di email ini karena dia mengelola proses pengembangan untuk pengembang pihak ketiga.

Terima kasih!

Sungguh-sungguh,

Bryan

Jadi mereka bersedia membantu kami, tetapi juga pendapat saya adalah menunggu sampai (untuk integrasi yang lebih baik, lisensi yang kurang ketat, mungkin API yang tidak memerlukan kunci, tetapi hanya kunci OAuth).

apa yang mempesona saya: Google dapat mengelola model pengembangan seperti itu untuk api peta mereka. Tapi groundsheep tidak bisa? Aneh.

Ada dua hal dengan Google:

  • Google API memeriksa sertifikat, dengan itu aplikasi ditandatangani. Kunci dari Groundspeak harus bekerja dengan setiap platform dan bahasa pemrograman.
  • Kunci Google API gratis, jadi setiap pengembang bisa mendapatkannya.

Aku tahu. Ini adalah proses groundsheep api yang menyebabkan masalah di sini karena budaya yang berbeda bertabrakan: kaku, seperti apel "keluar dari pengadilan saya" dari St Jeremy dan pasar terbuka seperti, di mana google kuat masuk Itu tidak bisa lebih kontras. Adapun bagian yang bergantung pada Android: jika saya ingat dengan benar, maka Anda juga dapat menggunakan peta google dari aplikasi web javascript, sehingga mereka tampaknya memiliki metode platform-independen di tempat. Pola pikir yang berbeda antara google dan groundsheep yang menyebabkan hickups, google tidak jahat, tetapi apa itu groundsheep?

Kunci AFAIK untuk JavaScript memeriksa domain.

Perhatikan lagi, kali ini pada infrastruktur OSM: mereka perlu mengoperasikan lingkungan terbuka, namun memproyeksikan database mereka dari penyalahgunaan. Mereka tidak memeriksa aplikasi untuk mengedit data OSM: bagaimana cara kerjanya? Dengan setiap rilis baru, patch, dan lain-lain ... apakah St Jeremy ingin memeriksa setiap aplikasi lagi? Kendalikan neurosis, siapa saja? Jadi, OSM memeriksa pengguna. Tampaknya tidak menjadi masalah. Mungkin saya melewatkan sesuatu, tetapi mengapa model OSM tidak berfungsi untuk data geocaching?

Ini adalah pemikiran saya ketika saya mendengar tentang API publik yang baru.

Masalah dengan kunci API mungkin dapat diselesaikan jika setiap pengembang mendapatkan kuncinya sendiri - tetapi melihat batasan untuk Anggota Dasar, saya memilih untuk tidak menggunakan api.

BFKC berhubungan dengan Groundspeak, jadi mari kita tunggu. Juga satu-satunya kemungkinan untuk mengimplementasikan API adalah konektor seperti yang dari GeOrg: http://android.ranitos.de/files/connector-sample.zip Saya suka cara yang digunakan untuk komunikasi antara aplikasi dan konektor.

Sementara itu, Anda dapat PM saya jika Anda menginginkan tautan ke dokumentasi API.

Menutup ini untuk saat ini, kami akan mengingat hal ini dan membicarakannya lagi ketika antarmuka konektor diimplementasikan. Lihat #10

Pengguna akhir dapat bertanggung jawab untuk memasukkan kunci pengguna yang valid ke dalam c:geo. Dev dapat mengembangkan masing-masing dengan kunci pengguna sendiri.

Tidak, OAuth memerlukan kunci rahasia untuk aplikasi.

Ya kunci rahasia untuk menghasilkan kunci pengguna. Kemudian kunci pengguna digunakan untuk berkomunikasi ke server API. Bagaimana / di mana pengguna sampai di sana, kuncinya terserah mereka.

Anda bilang, kita harus menggunakan akun aplikasi lain untuk tujuan kita?!

Apa Masalahnya jika hanya satu Pengembang yang mendapatkan kuncinya?
Harus ada seseorang yang bertanggung jawab untuk merilis rilis "resmi" ke toko google.
Jadi pengembang ini akan menambahkan kunci API ke dalam beberapa file konfigurasi yang dikemas ke dalam apk.
Jika pengembang lain ingin mengerjakan bagian API dari kode, mereka dapat mengajukan sendiri akses API!
Orang yang ingin menggunakan versi kustom c:geo jelas membutuhkan kunci API mereka sendiri, tetapi saya pikir sebagian besar pengguna tidak ingin menggunakan versi kustom. Dalam semua kasus, ini akan lebih baik daripada tidak ada dukungan API sama sekali!

Soal kuncinya hanya masalah kecil. Masalah utamanya adalah, menurut persyaratan lisensi dasar, Anda tidak boleh memasukkan cache ke dalam aplikasi Anda dengan cara lain selain API.
Itu berarti kami harus membangun semua fungsionalitas di sekitar API, menjadikan c:geo secara efektif sebagai Aplikasi khusus Premium.

Nah, pembaruan singkat tentang masalah ini.

Pengguna yang terhormat,

Seperti yang Anda ketahui, kami mencoba menyediakan layanan untuk anggota dasar dan premium dengan batasan yang sama. Jadi kami melanggar Perjanjian Lisensi API Geocaching untuk anggota dasar. Sayangnya, Groundspeak, Inc. (perusahaan yang menangani situs Geocaching.com) mendeteksi tindakan kami dan kami terpaksa menangguhkan sementara distribusi aplikasi kami di Google Play dan App store lainnya. Beberapa dari Anda mungkin mengalami masalah dengan proses masuk dalam beberapa hari terakhir yang mungkin terkait dengannya.

Setelah berpikir lama kami memutuskan untuk melegalkan aplikasi kami, tetapi sayangnya itu mempengaruhi anggota dasar. Karena anggota dasar dibatasi untuk mengunduh tiga Geocaches penuh per hari oleh perjanjian lisensi ini. Ini adalah alasan mengapa kami melakukan apa yang kami lakukan sebelumnya. Untuk anggota premium akan dibatasi sama seperti sebelumnya, 6 000 Geocaches per hari.

Adaptasi untuk aturan baru akan memakan waktu beberapa hari karena penambahan dialog konfirmasi untuk anggota dasar yang diwajibkan oleh perjanjian lisensi ini. Saya berharap kami akan merilis versi baru sesegera mungkin bahkan dengan biaya terjemahan yang tidak lengkap.

Tim pengembang Geocaching4Locus

Dengan asumsi bahwa c:geo akan bisa mendapatkan akses API dari Groundspeak:

  1. Poin mana dari perjanjian lisensi API yang ada yang perlu didiskusikan dan/atau dimodifikasi agar sesuai dengan persyaratan kami?
  2. Bisakah kita mempertahankan semua fungsi yang ada jika kita mengubah ke API atau modifikasi teknis apa yang diperlukan API untuk mencapai ini? Saya menemukan halaman bantuan ini melalui Google, tetapi tidak tahu apakah ini mencerminkan API saat ini.

Lihat juga log IRC 18.05.2015

Status:
Surat untuk Bryan telah dikirim (tersedia untuk tim pengembangan di milis Googlegroups).
Menunggu umpan balik.

Hanya untuk referensi lebih lanjut dan jika seseorang ingin melihat bagaimana itu cocok dengan mode kerja c:geo:
https://api.groundspeak.com/LiveV6/geocaching.svc/help

@Lineflyer Saya tidak mempercayai API yang memiliki ukuran font berbeda dalam dokumentasinya.

Ini bukan dokumentasi nyata yang akan saya katakan, tetapi sesuatu yang dibuat secara otomatis dari komentar kode.
Mengklik tautan mengungkapkan lebih banyak hal yang membuat saya sedikit bergidik (Tucson.Geocaching.WCF.API.Geocaching.Types).
Sepertinya mereka tidak benar-benar mendesain API mereka seperti itu tetapi menggunakan kerangka kerja untuk menghasilkan dan mengekspos sesuatu ...

Halo,

API ini tidak akan digunakan lagi pada 1 Mei 2019 tetapi REST API baru sedang diproduksi sejak beberapa bulan sekarang, dan URL panggilan balik perlu disahkan oleh Groundspeak. Jadi, meskipun kuncinya diketahui, tidak ada yang bisa menggunakannya karena GS akan mengarahkan ulang ke URL panggilan balik.

(Saya memiliki akses ke API ini).

Saya takut, masalah ini tidak up to date. Sementara itu, pengembang tim inti c:geo memiliki kemungkinan untuk mengakses API (lingkungan pementasan) terbaru dan dokumentasi juga tersedia.
Jika Anda tertarik untuk membantu, kami perlu mengklarifikasi apa yang Anda perlukan untuk itu dan menyediakan akses yang sesuai

Saya ingin membantu Anda tetapi saya adalah pengembang web (php/go), bukan Android Dev..

Untuk memperbarui masalah ini: Kami telah lama berhubungan dengan Groundspeak, mengevaluasi bagaimana kami dapat menggunakan API. Masih ada beberapa masalah terbuka (non-teknis) yang harus diselesaikan, tetapi kami telah menerima kunci pengembangan untuk API baru. Sebagai langkah selanjutnya kita harus mendesain integrasi ke dalam c:geo (misalnya jika hanya konektor baru atau jika diperlukan perubahan lain). Untuk itu dan fase implementasi berikutnya bantuan apa pun dihargai.

Beberapa persyaratan penggunaan Groundspeak API bermasalah di masa lalu (tidak mungkin atau sulit untuk mendapatkan kunci untuk tujuan pengembangan bagi siapa pun yang bertanya, batasan harian yang drastis dalam jumlah cache yang diambil dan peringkat D/T mereka untuk anggota dasar, tidak mungkin untuk menampilkan cache dari situs web bersamaan seperti opencaching…), apakah masalah ini diselesaikan atau apakah ini masalah nonteknis yang tersisa yang Anda sebutkan?
Saya tidak melihat Groundspeak berubah pikiran tentang model bisnis mereka dan (kurangnya) keterbukaan mereka, melihat pembatasan API mereka saat ini.

Nah, Groundspeak menunjukkan kesediaan untuk membahas masalah non-teknis ini dan kami sudah memberikan beberapa proposal. Namun untuk membahas ini lebih lanjut, kita mungkin perlu melihat dampak/perbedaan antara penggunaan API dan implementasi saat ini dalam alur penggunaan.

Saya lebih suka tidak memberikan detail apa pun di forum terbuka ini, namun kami pasti akan membawa siapa pun yang bersedia bekerja pada implementasi API ke dalam diskusi ini serta melibatkan pengguna kami sebelum keputusan akhir.

Ada yang baru di sini? Saya mencoba-coba API sebelumnya dan tidak terlalu buruk untuk diterapkan. Juga melihat versi baru yang mereka miliki sekarang.
Pertanyaannya adalah: apakah ada yang memimpin topik ini?
Saya merasa ini bisa menjadi dorongan besar bagi c:geo untuk menyelesaikan ini.
Apa teknisnya?

Apa teknisnya?

Pada dasarnya tenaga kerja.

Tetapi masih ada beberapa masalah terbuka mengenai persyaratan penggunaan. Jadi sangat mungkin bahwa implementasi teknis tidak akan digunakan dalam bentuk saat ini atau sama sekali jika tidak ada kesepakatan dengan Groundspeak.

Saya pikir kita harus mulai dengan semacam analisis persyaratan abstrak, kemudian melanjutkan dengan daftar area yang terpengaruh di c:geo dan perubahan yang diperlukan.

Tidak ada penundaan teknis. Apakah Api mampu menanggung semua fungsi yang kita miliki sekarang harus diperiksa secara detail.
Dari sisi pribadi saya, ada kekurangan sumber daya dan kurangnya kesepakatan yang dapat diterima mengenai penggunaan Api untuk anggota dasar.
BTW: Di mana Anda melihat dorongan untuk c:geo dalam topik ini? Ini akan menjadi sedikit 'lebih murah' dari segi pengembangan sumber daya dan akan lebih murah untuk groundpeak untuk melayani pengguna c:geo, tetapi sebaliknya? Saya tidak melihat keuntungan besar di c:geo menggunakan Api untuk 'rata-rata Joe'. Pengguna listrik tentu memiliki alur kerja lain yang melibatkan GSAK dan alat seluler yang terhubung ke rantai itu.

Apakah halaman ini membantu?
0 / 5 - 0 peringkat

Masalah terkait

pstorch picture pstorch  ·  4Komentar

Lineflyer picture Lineflyer  ·  7Komentar

Lineflyer picture Lineflyer  ·  3Komentar

Lineflyer picture Lineflyer  ·  7Komentar

chstdu picture chstdu  ·  3Komentar