Dokumentasi

• Perubahan reka bentuk
• Pengiraan harga oleh formula
• Units
• Mata wang
• Titik laluan
• Kalkulator bahan bakar
• Had kelajuan
• Hasil pengiraan
• Had hasil oleh senarai negara
• Kira laluan secara automatik pada muatan halaman
• Bolehkah saya memadam hiperlink dengan pengarang?

Perubahan reka bentuk

Gunakan konfigurator kod html untuk menyesuaikan reka bentuk widget dengan cepat.

Anda boleh link CSS anda menggunakan atribut data-css untuk menguruskan setiap aspek reka bentuk.

Keluarga font dan saiz font dalam widget menyesuaikan diri secara automatik dengan gaya laman web anda. Font hiperlink dengan pengarang digunakan sebagai font sampel. Untuk menyahdayakan penyesuaian font secara automatik, tambah atribut data-disable-font-auto-tuning atau hubungkan CSS anda.

Pengiraan harga oleh formula

Untuk sebarang laluan, anda boleh mengira harga dengan formula anda. Anda boleh set harga ini seperti yang anda inginkan, sebagai contoh "Kos Pengangkutan", "Kos Penghantaran" ataupun "Perbelanjaan perjalanan"/ Lihat contoh ini.

Untuk membolehkan paparan harga dikira oleh formula anda, tambahkan atribut data-show-result-customized-cost. Nyatakan formula pengiraan dalam atribut data-customized-cost-formula dan nama dalam data-customized-cost-label.

Apabila menyusun formula, anda boleh menggunakan pembolehubah berikut:

• Length - Jarak laluan
• DrivingTime - Masa memandu dalam beberapa minit
• FuelConsumption - Penggunaan bahan bakar
• FuelAmount - Jumlah bahan bakar yang diperlukan untuk keseluruhan perjalanan
• FuelPrice - Harga unit bahan bakar
• FuelCost - Kos bahan bakar untuk keseluruhan perjalanan

Anda juga boleh menggunakan fungsi matematik: min, max.

Unit ukuran untuk semua pembolehubah ditentukan oleh nilai data-measure dan atribut data-currency.

Units

Terdapat 3 sistem langkah yang tersedia:

• metric - sistem pengukuran metrik: liter, kilometer
• us_cust - sistem pengukuran AS: AS galon, batu
• imperial - sistem pengukuran empayar: UK galon, batu

Mata wang

Mata wang berikut disokong:

• ARS - Peso Argentina
• AUD - Dolar Australia
• BRL - Real Brazil
• CAD - Dolar Kanada
• CHF - Franc Switzerland
• CLP - Peso Chile
• CNY - Yuan China
• COP - Peso Colombia
• CZK - Koruna Czech Republik
• DKK - Krone Denmark
• DOP - Peso Dominican
• EUR - Euro
• GBP - Pound Sterling British
• INR - Rupee India
• IRR - Rial Iran
• MXN - Peso Mexico
• MYR - Ringgit Malaysia
• NGN - Naira Nigeria
• PEN - Sol Peru
• PHP - Peso Filipina
• PLN - Zloty Poland
• RUB - Ruble Russia
• SEK - Krona Sweden
• TRY - Lira Turki
• USD - Dolar Amerika Syarikat
• UZS - Jumlah Uzbekistan
• VEF - Bolivar Venezuela
• ZAR - Rand Afrika Selatan

Titik laluan

Atribut data-default-from dan data-default-to menentukan nilai lalai untuk medan "Dari" dan "Ke". Lihat bagaimana ia berfungsi dengan atribut data-default-to pada contoh ini.

Untuk menambah medan "Mata perantaraan", tambahkan atribut data-show-via. Nilai lalai untuk medan ini boleh ditetapkan menggunakan atribut data-default-via.

Kalkulator bahan bakar

Untuk menambah medan kalkulator bahan bakar, tambahkan atribut data-show-fuel-calc.

Atribut data-default-fuel-consumption dan data-default-fuel-price menentukan nilai lalai untuk medan "Penggunaan bahan bakar" dan "Harga bahan bakar".

Jika tiada nilai lalai diberikan, maka "Penggunaan bahan bakar" dianggap sama dengan 8 l/100 km, dan "Harga bahan bakar" dianggap sebagai harga petrol.

Had kelajuan

Untuk menambah medan had kelajuan, tambahkan atribut data-show-speed-profile.

Atribut data-default-speed-limit-motorway dan data-default-speed-limit-other menentukan nilai lalai untuk medan "Kelajuan maksimum pada lebuhraya" dan "Kelajuan maksimum pada jalan lain".

Jika nilai lalai tidak diberikan, maka had yang ditetapkan oleh peraturan trafik digunakan.

Semasa pengiraan, kelajuan yang dibenarkan oleh peraturan trafik untuk jalan tertentu digunakan secara automatik. Jika kelajuan 110 km/j didayakan di lebuhraya, dan anda menetapkan 90 km/j, maka 90 km/j akan digunakan untuk pengiraan. Dan jika anda menentukan had 150 km/j, maka kelajuan 110 km/j yang dibenarkan oleh peraturan trafik akan digunakan.

Hasil pengiraan

Anda boleh menambah blok hasil yang anda perlukan dengan bantuan atribut:

• data-show-result-length - Jarak laluan
• data-show-result-driving-time - Masa memandu
• data-show-result-fuel-amount - Jumlah bahan bakar
• data-show-result-fuel-cost - Kos bahan bakar
• data-show-result-map - Laluan peta
• data-show-result-scheme - Rancangan laluan

Had hasil oleh senarai negara

Rangkaian seluruh dunia digunakan secara lalai.

Anda boleh menghadkan hasil dengan negara-negara tertentu dengan atribut: data-only-countries. Hanya hasil dari negara yang dipilih akan ditunjukkan.

Anda boleh menambah keutamaan lembut untuk negara yang mempunyai atribut: data-prefer-countries. Negara-negara yang ditentukan akan mempunyai keutamaan berbanding yang lain.

Had ketat dan keutamaan lembut boleh digunakan secara serentak.

Kod ISO negara berikut disokong: AD, AE, AF, AG, AI, AL, AM, AO, AR, AT, AU, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BM, BN, BO, BR, BS, BT, BW, BY, BZ, CA, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GG, GH, GI, GL, GM, GN, GQ, GR, GS, GT, GW, GY, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MG, MH, MK, ML, MM, MN, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PG, PH, PK, PL, PN, PR, PS, PT, PW, PY, QA, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SK, SL, SM, SN, SO, SR, SS, ST, SV, SY, SZ, TC, TD, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, US, UY, UZ, VA, VC, VE, VG, VN, VU, WS, XK, YE, ZA, ZM, ZW.

Kira laluan secara automatik pada muatan halaman

Dengan atribut data-calculate-instantly, anda boleh memulakan pengiraan laluan sebaik sahaja halaman dimuatkan tanpa menunggu butang "Kira" ditekan. Dalam kes ini, jangan lupa untuk menetapkan nilai lalai untuk medan yang diperlukan "Dari" dan "Ke". Lihat contoh ini.

Akses metrik laluan melalui javascript

// your custom function
var routeReadyHandler = function () {
    console.log("length=" + this.totalDistance);
    console.log("minutes=" + this.totalTime);
    console.log("fuelAmount=" + this.fuelAmount);
    console.log("fuelCost=" + this.fuelCost);
    console.log("fuelPrice=" + this.fuelPrice);
    console.log("fuelConsumption=" + this.fuelConsumption);
    console.log("customizedCost=" + this.customizedCost);
};

// assign function to widget
if (typeof RoutePlannerWidget === "undefined") {
    var allScriptTags = document.getElementsByTagName("script");
    for (var i = 0; i < allScriptTags.length; i++) {
        if (
            allScriptTags[i].hasAttribute("src")
            &&
            allScriptTags[i].getAttribute("src").endsWith("/widget/v1/client.js")
        ) {
            allScriptTags[i].addEventListener('load', function(){
                RoutePlannerWidget.prototype.routeReady = routeReadyHandler;
            });
        }
    }
} else {
    RoutePlannerWidget.prototype.routeReady = routeReadyHandler;
}

Bolehkah saya memadam hiperlink dengan pengarang?

Tidak, anda tidak boleh. Sila simpan atributi mengikut lesen Creative Commons 4.0.