Dokumentacja

• Zmiana projektu
• Obliczanie ceny według wzoru
• Jednostki
• Waluta
• Punkty trasy
• Kalkulator spalania
• Ograniczenie prędkości
• Wyniki obliczeń
• Ogranicz wyniki według listy krajów
• Oblicz trasę automatycznie przy ładowaniu strony
• Czy mogę usunąć hiperłącze z atrybutem?

Zmiana projektu

Użyj konfiguratora kodu HTML aby szybko dostosować swój widżet.

Możesz podłączyć swój CSS używając atrybutu data-css aby zarządzać każdym aspektem projektu.

Rodzina i rozmiar czcionek w widżecie automatycznie dopasowuje się do stylu Twojej strony. Czcionka hiperłącza z atrybutem jest używana jako przykładowa. Aby zablokować automatyczne dostosowywanie czcionek, dodaj atrybut data-disable-font-auto-tuning lub podłącz swój CSS.

Obliczanie ceny według wzoru

Dla dowolnej trasy możesz obliczyć cenę według wzoru. Możesz nazwać tę cenę według własnego uznania, na przykład "Koszt przejazdu", "Koszt dostawy" lub "Koszty podróży". Spójrz na en przykład.

Aby włączyć wyświetlanie ceny obliczonej według formuły, dodaj atrybut data-show-result-customized-cost. Określ formułę obliczeniową w atrybucie data-customized-cost-formula i nazwę w data-customized-cost-label.

Podczas tworzenia formuły można użyć następujących zmiennych:

• Length - Długość trasy
• DrivingTime - Czas jazdy w minutach
• FuelConsumption - Zużycie paliwa
• FuelAmount - Ilość paliwa wymagana na całą trasę
• FuelPrice - Cena jednostkowa paliwa
• FuelCost - Koszt paliwa dla całej trasy

Możesz także użyć funkcji matematycznych: min, max.

Jednostki miary dla wszystkich zmiennych są określone przez wartości atrybutów data-measure i data-currency.

Jednostki

Dostępne są 3 systemy pomiarów:

• metric - metryczny system pomiarowy: litry, kilometr
• us_cust - amerykański system pomiarowy: galon amerykański, mila
• imperial - imperialny system pomiarowy: galon imperialny, mila

Waluta

Obsługiwane są następujące waluty:

• ARS - Peso argentyńskie
• AUD - Dolar australijski
• BRL - Real brazylijski
• CAD - Dolar kanadyjski
• CHF - Frank szwajcarski
• CLP - Peso chilijskie
• CNY - Juan chiński
• COP - Peso kolumbijskie
• CZK - Korona czeska
• DKK - Korona duńska
• DOP - Peso dominikańskie
• EUR - Euro
• GBP - Funt szterling
• INR - Rupia indyjska
• IRR - Rial irański
• MXN - Peso meksykańskie
• MYR - Ringgit
• NGN - Naira
• PEN - Sol peruwiański
• PHP - Peso filipińskie
• PLN - Złoty
• RUB - Rubel rosyjski
• SEK - Korona szwedzka
• TRY - Lira turecka
• USD - Dolar amerykański
• UZS - Sum uzbecki
• VEF - Boliwar wenezuelski
• ZAR - Rand południowoafrykański

Punkty trasy

Atrybuty data-default-from i data-default-to określają wartości domyślne dla pól "Wyjazd z" i "Cel". Zobacz, jak to działa z atrybutem data-default-to na tym przykładzie.

Aby dodać pole "Punkty pośrednie", dodaj atrybut data-show-via. Wartość domyślną dla tego pola można ustawić za pomocą atrybutu data-default-via.

Kalkulator spalania

Aby dodać pola kalkulatora paliwa, dodaj atrybut data-show-fuel-calc.

Atrybuty data-default-fuel-consumption i data-default-fuel-price określają wartości domyślne dla pól "Zużycie paliwa" i "Cena paliwa".

Jeśli nie podano wartości domyślnych, "Zużycie paliwa" jest przyjęte za równe 8 L/100 km, a "Cena paliwa" jest przyjęte za cenę paliwa.

Ograniczenie prędkości

Aby dodać pola ograniczenia prędkości, dodaj atrybut data-show-speed-profile.

Atrybuty data-default-speed-limit-motorway i data-default-speed-limit-other określają wartości domyślne dla pól "Prędkość maksymalna na autostradzie" i "Prędkość maksymalna na innych drogach".

Jeśli nie podano wartości domyślnych, stosowane są limity określone w przepisach ruchu drogowego.

Podczas obliczeń prędkość dozwolona przepisami ruchu drogowego dla danej drogi będzie używana automatycznie. Jeśli prędkość 110 km/h jest możliwa na autostradzie i określono 90 km/h, wówczas 90 km/h zostanie użyty do obliczeń. A jeśli określisz limit 150 km/h, zostanie użyta prędkość 110 km/h dozwolona przez przepisy ruchu drogowego.

Wyniki obliczeń

Możesz dodać potrzebne bloki wyników za pomocą atrybutów:

• data-show-result-length - Długość trasy
• data-show-result-driving-time - Czas jazdy
• data-show-result-fuel-amount - Ilość paliwa
• data-show-result-fuel-cost - Koszt paliwa
• data-show-result-map - Mapa trasy
• data-show-result-scheme - Plan trasy

Ogranicz wyniki według listy krajów

Domyślnie używany jest globalny routing.

Możesz ściśle ograniczyć wyniki według wybranych krajów z atrybutem: data-only-countries. Wyświetlane będą tylko wyniki z wybranych krajów.

Możesz dodać preferencje miękkie dla krajów z atrybutem: data-prefer-countries. Określone kraje będą miały pierwszeństwo przed innymi.

Można używać jednocześnie ścisłego limitu i preferencji miękkich.

Obsługiwane są następujące kody ISO kraju: 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.

Oblicz trasę automatycznie przy ładowaniu strony

Za pomocą atrybutu data-calculate-instantly można rozpocząć obliczanie trasy natychmiast po załadowaniu strony bez oczekiwania na naciśnięcie przycisku "Oblicz". W takim przypadku nie zapomnij ustawić wartości domyślnych dla wymaganych pól "Wyjazd z" i "Cel". Spójrz na en przykład.

Uzyskaj dostęp do metryk trasy za pomocą 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;
}

Czy mogę usunąć hiperłącze z atrybutem?

Nie, nie możesz. Zapisz zastrzeżoną informację zgodnie z licencją Creative Commons 4.0.