Ten dokument nie wyjaśnia wszystkich wątpliwości? Szczegółowa dokumentacja techniczna API DoCelu.pl
Sprawdź toczące się dyskusje na Forum API DoCelu.pl
Ten dokument nie wyjaśnia wszystkich wątpliwości? Szczegółowa dokumentacja techniczna API DoCelu.pl
Sprawdź toczące się dyskusje na Forum API DoCelu.pl
Umieszczenie mapy na swojej stronie WWW jest czynnością bardzo prostą. Konieczne jest posiadanie własnej strony WWW, oraz pobranie klucza API DoCelu.pl. Klucz możemy uzyskać po zarejestrowaniu się w serwisie.
Niezbędna jest podstawowa znajomość HTML'a, jednak nawet osoby bez jego znajomości powinny sobie poradzić. Wystarczy wspomóc się jednym z dostępnych w sieci kursów.
W sekcji head naszej strony WWW dodajemy zewnętrzny javascript. W tym miejscu ciąg znaków abcdef, przy parametrze _key zastępujemy naszym, wcześniej wygenerowanym, kluczem API.
<script src="http://api.docelu.pl/api.js?_key=abcdef" type="text/javascript"></script>
W sekcji body definiujemy element div, ustawiamy jego atrybuty width i height oraz atrybut id. Poniżej elementu div umieszczamy skrypt, w którym umieszczamy wywołanie funkcji DoCelu.loadMap przekazując jako jej pierwszy parametr element div w którym umieszczona będzie mapa. Jako drugi, opcjonalny parametr metody przekazujemy obiekt z konfiguracją mapy - w tym przykładzie skorzystamy z domyślnej konfiguracji i przekazujemy wartość 'null'.
Należy zwrócić uwagę na to, że dalsze wykorzystanie komponentu mapowego powinno nastąpić dopiero po prawidłowym załadowaniu mapy. W tym celu został udostępniony trzeci parametr funkcji DoCelu.loadMap. Przekazujemy w nim funkcję javascriptową, która zostanie wykonana po załadowaniu mapy.
Przykładowy kod i efekt jego zastosowania:
<html>
<head>
<script src="http://api.docelu.pl/api.js?_key=abcdef" type="text/javascript"></script>
</head>
<body>
<div id="map" style="width:800px; height:600px; "></div>
<script type="text/javascript">
//<![CDATA[
jQuery(document).ready(function() {
DoCelu.loadMap(document.getElementById('map'), null, function() {
// Kod z dalszymi operacjami z wykorzystaniem
// komponentu mapowego.
});
});
//]]>
</script>
</body>
</html>
Przy odwołaniu do API w sekcji HEAD ważne jest, aby jako parametr _key podać swój wygenerowany klucz do API. Umożliwi to późniejsze przeglądanie statystyk wykorzystania mapki na twojej stronie. Próba korzystania z cudzego klucza będzie blokowana i w uzasadnionych przypadkach wyciągane będą konsekwencje prawne.
API DoCelu.pl oparte jest o bibliotekę jQuery i wymaga jej do poprawnego działania. Najprostszym sposobem jest wykorzystanie wersji biblioteki wbudowanej w API DoCelu.pl. Jest ona dołączana automatycznie. Jeżeli na swojej witrynie korzystasz już z biblioteki jQuery, to API DoCelu.pl może z niej skorzystać. W tym celu ustawiamy parametr jquery=0 :
<script src="http://api.docelu.pl/api.js?_key=abcdef&jquery=0" type="text/javascript"></script>
Domyślnie API DoCelu.pl korzysta z najnowszej dostępnej wersji API. Możemy jednak jawnie zadeklarować korzystanie z jakiejkolwiek innej, konkretnej wersji API. W tym celu należy podać wersję API, z której chcemy korzystać, jako parametr v przy imporcie biblioteki:
<script src="http://api.docelu.pl/api.js?_key=abcdef&v=0.1.0" type="text/javascript"></script>
Ten dokument nie wyjaśnia wszystkich wątpliwości? Szczegółowa dokumentacja techniczna API DoCelu.pl
Sprawdź toczące się dyskusje na Forum API DoCelu.pl
Style width height
Uwaga!
Trzeba pamiętać o ustawieniu style z height i width diva, bo bez tego mapa się nie załaduje. Dwie godziny na tym zmarnowałem
Proste
Świetna robota !!! API DoCelu jest super!!!!
Pzdr,
Źródło danych: 
Mapy: 
Integracja i technologia:
