pengenalan


Daftar kandungan

  • 1 Pengenalan fungsi JavaScript API
  • 2 Pembaca penukaran yang dimaksudkan
  • 4
  • Versi Penerangan dan Aplikasi API ak
  • 5
  • Dapatkan kaedah perkhidmatan API JavaScript
  • 6
  • Membangunkan aplikasi peta pada platform mudah alih
  • 7
    • 7.2
    • Tatarajah .

      Pengenalan Fungsi JavaScript API

      Baidu Map JavaScript API ialah satu set antara muka pengaturcaraan aplikasi yang ditulis dalam bahasa JavaScript Ia boleh membantu anda membina aplikasi peta yang kaya dengan ciri dan sangat interaktif di tapak web anda, termasuk fungsi asas membina peta. Pelbagai antara muka menyediakan perkhidmatan data seperti carian tempatan dan perancangan laluan.

      Fungsi peta asas: Paparan (menyokong imej 2D, imej 3D, imej satelit), sorot, zum, seret, dsb.

      Fungsi paparan kawalan peta: Anda boleh menambah/memadam mata helang, bar alat, skala, hak cipta tersuai, jenis peta dan kawalan kedudukan pada peta, dan anda boleh menetapkan kedudukan paparan pelbagai kawalan.

      Fungsi penutup: Menyokong menambah/memadam titik, garisan, kawasan, kawasan panas, bahagian pentadbiran, perlindungan yang ditentukan pengguna, dll. pada peta pustaka sumber terbuka menyediakan anotasi yang kaya, pengurus anotasi, penanda pengagregatan, dan tersuai Tentukan fungsi seperti tindanan.

      Fungsi alat: Menyediakan fungsi menukar koordinat latitud dan longitud serta koordinat skrin;

      Fungsi kedudukan: Menyokong kedudukan IP dan pelayar (menyokong pelayar ciri html5) fungsi kedudukan.

      Fungsi menu klik kanan: Menyokong menambah menu klik kanan pada peta.

      Fungsi interaksi tetikus: Menyokong fungsi seperti pengubahsuaian dinamik gaya tetikus, penyeretan/zoom tetikus peta dan lukisan tetikus.

      Fungsi lapisan: Menyokong penetapan semula peta asas peta, menindih lapisan trafik masa nyata pada peta atau menyesuaikan fungsi lapisan.

      Fungsi carian setempat: Termasuk carian POI berdasarkan bandar, julat segi empat tepat, julat bulat dan syarat lain; dan menyokong pengambilan semula data milik pengguna.

      Carian pengangkutan awam: Menyokong tiga keadaan carian: koordinat titik permulaan, nama titik permulaan dan contoh LocalSearchPoi, hasil carian menyokong empat pilihan: mudah, boleh dipindahkan, kurang berjalan kaki dan tidak menaiki kereta api bawah tanah.

      Pencarian memandu: Menyokong pengambilan semula tiga syarat carian: koordinat titik permulaan, nama titik mula dan contoh LocalSearchPoi mengembalikan hasil navigasi pemanduan dengan masa terpendek, jarak terpendek dan mengelak lebuh raya dan menyediakan perkhidmatan pengiraan tambang; .

      Navigasi Berjalan: Sediakan penyelesaian navigasi berjalan kaki.

      Terbalik/Geokod: Menyokong perkhidmatan penukaran antara koordinat Baidu dan maklumat perihalan alamat.

      Fungsi paparan data diperibadikan: Selepas data pengguna sendiri disimpan dalam LBS Cloud, API JavaScript boleh menyediakan fungsi memaparkan data sendiri dalam bentuk gambar rajah pockmark.

      Pembaca Bermaksud

      API disediakan kepada pembaca yang mempunyai pengalaman pengaturcaraan JavaScript dan memahami konsep berorientasikan objek. Di samping itu, pembaca harus mempunyai sedikit pengetahuan tentang produk peta.

      Jika anda menghadapi sebarang masalah semasa penggunaan, anda boleh memberi maklum balas kepada kami melalui forum API.

      Penukaran koordinat

      Piawaian koordinat latitud dan longitud antarabangsa ialah WGS-84 China mesti menggunakan sekurang-kurangnya GCJ-02 yang dibangunkan oleh Biro Tinjauan Kebangsaan untuk menyulitkan lokasi geografi buat kali pertama. Atas dasar ini, Baidu Coordinates telah melaksanakan langkah penyulitan sekunder BD-09 untuk terus melindungi privasi peribadi. Sistem koordinat antara muka luaran Baidu bukanlah longitud dan latitud sebenar yang dikumpul oleh GPS, dan perlu ditukar melalui antara muka penukaran koordinat.

      Untuk contoh penukaran koordinat dan penukaran koordinat kelompok, sila lihat contoh API JavaScript [Contoh Peta_Penukaran Koordinat] untuk mendapatkan butiran.

      API Perihalan Versi dan Aplikasi ak

      Untuk menyatukan pengurusan kuota perkhidmatan platform, API JavaScript memperkenalkan mekanisme ak dalam versi baharu. JavaScript API v1.4 dan versi sebelumnya tidak perlu memohon kunci (ak) Bermula dari versi v1.5, anda perlu memohon kunci (ak) sebelum anda boleh menggunakannya kuota, sila klik Mohon untuk Pengguna Perusahaan Disahkan.

      Alamat:

      http://api.map.baidu.com/api?v=1.4 //参数v表示您加载API的版本,使用JavaScript APIv1.4及以前版本可使用此方式引用。
      http://api.map.baidu.com/api?v=2.0&ak=您的密钥  //使用JavaScript APIv2.0请先申请密钥ak,按此方式引用。

      Apabila pengesahan kebenaran (ak) gagal, ralat berikut akan dilaporkan:

      js-ak-failure.jpg

      Mungkin sebab kegagalan pengesahan termasuk:

      belum memohon untuk ak dalam konsol iaitu '... ak=';

      Seting kunci salah, contohnya, E4805d16520de693a3fe707cdc962045 adalah ak yang betul, tetapi ak yang dimasukkan semasa tetapan ialah E4805d16520de693cda3fe

      Kunci tidak melepasi senarai putih , seperti berikut Ak gambar adalah dalam nama domain bukan baidu.com Ralat akan dilaporkan seterusnya.

      js_ak_refer.png

      Konsol API akan melaporkan ralat semasa menutup API JavaScript

      ak_no_click.jpg

      Apabila API dinaik taraf, jika penggunaan, penamaan, dsb. antara muka sedia ada telah berubah, kami akan menambah satu versi baharu kepadanya Tidak, ini tidak akan memberi sebarang kesan pada aplikasi sedia ada anda. Jika peningkatan hanya membetulkan beberapa pepijat atau menambah antara muka dan meningkatkan prestasi tanpa menjejaskan fungsi sedia ada, nombor versi tidak akan berubah. Anda boleh melihat perubahan versi pada halaman log kemas kini.


      Penggunaan "AK sebelah pelayan" yang salah untuk API JavaScript, JS API hanya menyokong jenis pelayar ak (dinaik taraf sejak 15 Januari 2016)

      Disebabkan peningkatan sistem baharu, "AK bahagian pelayan" yang baru dibuat tidak lagi menyokong penggunaan bahagian penyemak imbas, sila pilih "AK bahagian penyemak imbas" sahaja menyokong AK sebelah pelayar.

      Untuk AK pelayan yang digunakan sebelum ini, ia tidak akan terjejas jika ia tidak ditukar, dan ia masih boleh digunakan di bahagian pelayar Jika anda mengemas kini AK pelayan lama dan menyimpannya semula, ia akan diproses sebagai yang baru mencipta AK, dan ia tidak lagi disokong pada bahagian penyemak imbas.

      Dapatkan kaedah perkhidmatan API JavaScript

      Memandangkan JS APIv1.5, versi terkini ialah 2.0, anda perlu memohon kunci (ak) terlebih dahulu sebelum anda berjaya memuatkan fail API JS. Kaedah penggunaan ak adalah seperti berikut:

      <script src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥" type="text/javascript"></script>

      Parameter v ialah nombor versi semasa API, dan versi terkini ialah 2.0. Sebelum versi 1.2, anda juga boleh menetapkan parameter perkhidmatan untuk memberitahu API sama ada untuk memuatkan bahagian perkhidmatan benar bermakna memuatkan, palsu bermaksud tidak memuatkan dan lalai adalah benar.

      API peta ditulis dalam bahasa JavaScript Anda perlu merujuk API ke dalam halaman melalui teg <skrip> sebelum menggunakannya:

      Gunakan kaedah rujukan V1.4 dan versi sebelumnya:

      <script src="http://api.map.baidu.com/api?v=1.4" type="text/javascript"></script>

      Gunakan kaedah Rujukan versi V2.0:

      <script src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥" type="text/javascript"></script>

      Parameter v ialah nombor versi semasa API dan versi terkini ialah 2.0. Sebelum versi 1.2, anda juga boleh menetapkan parameter perkhidmatan untuk memberitahu API sama ada untuk memuatkan bahagian perkhidmatan benar bermakna memuatkan, palsu bermaksud tidak memuatkan dan lalai adalah benar.

      Membangunkan aplikasi peta pada platform mudah alih

      API telah menyokong platform mudah alih seperti iPhone dan Android sejak versi 1.1. Pengguna boleh mengakses aplikasi yang dicipta oleh API peta melalui pelayar mudah alih. Saiz skrin platform mudah alih biasanya lebih kecil daripada PC atau komputer riba, dan kaedah pengendalian juga berbeza. Untuk memaparkan peta dengan lebih baik pada penyemak imbas mudah alih, kami mempunyai cadangan berikut:

      Tetapkan ketinggian bekas peta kepada 100% supaya ia memenuhi keseluruhan skrin, atau anda juga boleh mengira saiz tetingkap penyemak imbas dan tetapkannya.

      Tambah teg meta berikut: <meta name="viewport" content="initial-scale=1.0, user-scalable=no" /> Ini dilakukan untuk membolehkan halaman dipaparkan pada perkadaran biasa dan untuk melumpuhkan pengguna Operasi mengezum halaman.

      Anda boleh merujuk kepada dokumentasi Pembangun Apple dan dokumentasi Android untuk mendapatkan maklumat lanjut.

      js-apiv14-phone.jpg

      Untuk pelaksanaan khusus pembangunan terminal mudah alih, sila rujuk kod sumber Demo yang disediakan oleh kod download_sample yang berkaitan.

      Https Description

      Apply

      JavaScript API adalah yang pertama menyokong Https dan dibuka sepenuhnya Tidak perlu memohon perkhidmatan Https dan anda boleh menggunakannya terus.

      Jika anda memerlukan kuota yang lebih tinggi, sila sahkan maklumat syarikat anda Selepas menjadi pengguna yang disahkan perusahaan, anda akan mendapat kuota perkhidmatan yang lebih tinggi.

      Nota: Hanya versi JavaScript API V2.0 menyokong https, versi API JavaScript lain tidak menyokongnya. Untuk menggunakan perkhidmatan https, sila semak versi anda dahulu.

      Konfigurasi

      1 Jika anda menggunakan API JavaScript, anda perlu menambah medan khas (s=1):

      https://api.map.baidu.com/api?v=2.0&ak=your key &s=1;

      2 Untuk API Web, tidak perlu menambah medan khas, hanya gunakan protokol HTTPS untuk mengaksesnya secara terus, seperti Geocoding:

      https://api.map.baidu.com/geocoder /v2/?ak=yours Secret key&callback=renderReverse&location=39.983424,116.322987&output=xml&pois=1

      3 Jika anda mempunyai keperluan keselamatan data yang tinggi, adalah disyorkan untuk menggunakan permintaan POST untuk mengelakkan daripada meletakkan parameter permintaan dalam URI dan bocor. maklumat sensitif;

      Pemuatan tak segerak

      API JavaScript menyokong pemuatan tak segerak apabila merujuk skrip. Sila rujuk contoh penggunaan di bawah:

      <!DOCTYPE html>
      <html> skrip type="text/javascript">
      function initialize() {
      var mp = new BMap.Map('map'
      mp.centerAndZoom(new BMap.Point(121.491, 31.233),
      } );
      function loadScript() {
      var script = document.createElement("script");
      script.src = "http://api.map.baidu.com/api?v=2.0&ak=your key&callback =initialize"; //Ini ialah kaedah rujukan untuk versi v2.0
      // http://api.map.baidu.com/api?v=1.4&ak=Your key&callback=initialize"; //Ini ialah kaedah Rujukan untuk v1.4 dan versi sebelumnya
      document.body.appendChild(skrip
      }

      window.onload = loadScript
      </script> ="width:500px;height:320px"></div>
      </body>Keserasian

      Dapatkan sokongan teknikal

      Jika anda menghadapi masalah menggunakan API Peta Baidu, sila cuba selesaikannya melalui kaedah berikut:

      Sahkan bahawa anda menggunakan alamat API peta yang betul.

      Lawati Forum API Peta Baidu untuk mencari siaran tentang isu berkaitan, atau hantar soalan anda ke Tieba.

      Lihat Soalan Lazim.

      Sertai kumpulan Baidu HI.