Poznaj Google Maps API

Pytania ogólne

• Co to jest Google Maps?
• Co to jest API?
• Co mogę zrobić za pomocą API Google Maps?
• Czy dostęp do API jest darmowy?
• Czy mogę używać API na swojej stronie komercyjnie?
• Skąd wziąć klucz API?
• Gdzie znaleźć więcej materiałów na temat Google Maps API?
• Czy na stronie używającej Google Maps API mogę umieścić reklamy?

Pytania na temat tego kursu

• Co jest potrzebne, by zacząć pracę?
• Czy muszę znać jakiś język programowania, żeby opanować kurs?
• Czy programowanie z użyciem API Google Maps jest trudne?
• Dlaczego niektóre zmienne w przykładach mają angielskie, a niektóre polskie nazwy?
• Jaka przeglądarka internetowa jest najlepsza do debugowania i wyświetlania aplikacji?

Pytania techniczne na temat API

• Czy można "obracać" mapę, tzn. wyświetlać zdjęcia terenu obrócone o pewien kąt?
• Co zrobić, by niektóre markery zaczynały się pojawiać dopiero na pewnej wysokości?
• Czy można to samo zrobić z poliliniami?
• Czy można dodać na mapę własne zdjęcie, które przemieszczałoby się razem z przesuwaniem mapy?
• W Internet Explorer nie działają polilinie!
• Na stronie mojej firmy chciałbym wstawić mapę, ale tak, by użytkownik nie mógł jej przesuwać
• Czy da się jakoś zapamiętać środek i zoom mapy tak, by po ponownej wizycie mapa startowała od tego punktu?
• Jak zmienić język komunikatów, wyświetlanych przez mapę?
• Jak obliczyć odległość, pomiędzy dwoma punktami? Metoda oparta na twierdzeniu Pitagorasa daje nieprawidłowe wyniki!
• Gdzieś w moim skrypcie jest błąd. Jak go znaleźć?

Pytania na temat tej strony

• Czy w mojej aplikacji muszę umieścić informacje o tej stronie, jeśli wzorowałem/am się na przykładach lub na informacjach tu zawartych?
• Mam pomysł na przykład/tutorial, czy wykonasz go?
• Mój skrypt nie działa, poprawisz go?

Pytania na temat płatności Mikro SMS

• Ile kosztuje dostęp do płatnych materiałów i jak zapłacić wymaganą kwotę?
• Jaką mam gwarancję, że po wysłaniu SMSa otrzymam kod i nie zostanę oszukany?
• Jaką mam pewność, że poradnik płatny będzie spełniał moje oczekiwania, skoro przed wysłaniem SMSa nie mogę go sprawdzić?

Odpowiedzi

Pytania ogólne

• Co to jest Google Maps?Google Maps (znane przez pewien czas jako Google Local) to jeden z serwisów wyszukiwarki internetowej Google. Umożliwia wyświetlanie szczegółowych zdjęć powierzchni Ziemi, oraz map kartograficznych dróg i miast. Google Maps udostępnia również opcję planowania trasy, geokodowania adresów, tworzenia i dzielenia się mapami z innymi użytkownikami usługi. Serwis znajduje się w fazie beta. Adres: maps.google.com.
• Co to jest API?API (ang. Application Programming Interface) to interfejs programowania aplikacji – specyfikacja procedur lub funkcji umożliwiających komunikację z systemem zewnętrznym w stosunku do aplikacji korzystającej z API (za wikipedia.pl). Google Maps API umożliwia korzystanie z mapy takiej jak ta na stronie maps.google.com i większości oferowanych przez nią funkcji na Twojej stronie internetowej.
• Co mogę zrobić za pomocą API Google Maps?Mnóstwo rzeczy. Ograniczeniem jest jedynie Twoja wyobraźnia. Najczęściej spotykanymi rozwiązaniami, opartymi o API Google są:wyświetlanie odwiedzonych miejsc, tras wycieczek, tworzenie galerii zdjęć ze wskazaniem lokalizacji ujęcia, prezentowanie ciekawych miejsc geograficznych, interaktywne dodatki do blogów, wyświetlanie map dojazdu do firmy, śledzenie pozycji obiektów, seriwsy informacyjne i lokalizatory internetowe, bazy obiektów przyrodniczych, geograficznych, serwisy typu mash-up i wiele innych.
• Czy dostęp do API jest darmowy?Tak. Google Maps API jest darmowe do użytku, zarówno na stronach komercyjnych jak i niekomercyjnych. O limitacji w dostępie do usługi możesz przeczytać na stronie z warunkami użytkowania Google Maps API
• Czy mogę używać API na swojej stronie komercyjnie?Tak, pod warunkiem, że korzystanie z mapy pozostanie darmowe.
• Skąd wziąć klucz API?Musisz go wygenerować na specjalnej stronie Google Maps API. Jest to czynność wolna od opłat, raz wygenerowany klucz może być używany przez nieokreślony czas w ramach witryny, dla której był zarezerwowany. Jeśli podasz zły klucz, nie podasz go wcale lub podasz klucz innej witryny, API nie załaduje mapy. Weryfikacja klucza nie dotyczy sytuacji, gdy tworzysz stronę na dysku twardym swojego komputera, lub gdy masz konto w domenie googlepages.com
• Gdzie znaleźć więcej materiałów na temat Google Maps API?Pierwszym i najważniejszym źródłem informacji jest oficjalna strona API, na której zebrano kilkanaście przykładów oraz referencję klas i metod. Jej adres to www.google.com/apis/maps. Inne warte uwagi źródła to mapki.com oraz strona Mike Williamsa na temat API.
• Czy na stronie używającej Google Maps API mogę umieścić reklamy?Tak, możesz umieścić zarówno reklamy własne, jak i reklamy z programu AdSense (dostarczane przez Google), możesz też wyświetlać reklamy bezpośrednio w oknie mapy za pomocą wbudowanej funkcji GAdsManager

Pytania na temat tego kursu

• Co jest potrzebne, by zacząć pracę?Co do wymogów programowych, wybierz swój ulubiony edytor tekstowy (polecam Notepad++, sam używam), potrzebna będzie również przeglądarka internetowa, która obsługuje Google Maps API (na 99.9% masz taką, z API radzą sobie przeglądarki z rodziny Mozilla (w tym Firefox, Seamonkey), Opera, Internet Explorer, Safari itp.). Jeśli zamierzasz udostępnić mapę w internecie, będziesz potrzebował dodatkowo konta FTP oraz klienta, służącego do wysyłania danych na to konto (polecam Total Commander).
• Czy muszę znać jakiś język programowania, żeby opanować kurs?Bardzo wskazana jest znajomość JavaScript i HTML. Znajomość dowolnego obiektowego języka programowania również może być pomocna. Oczywiście, możesz zwyczajnie skopiować kod któregoś z przykładów, a następnie na wzorze istniejącego dopisać własne dane. Bez znajomości języka nie będziesz mógł jednak rozbudować aplikacji czy wdrażać bardziej zaawansowanych rzeczy.
• Czy programowanie z użyciem API Google Maps jest trudne?Jeśli znasz strukturę i składnię języka JavaScript, pisanie aplikacji nie powinno sprawić Ci problemu - ten kurs bezboleśnie przeprowadzi Cię przez proces tworzenia całej aplikacji. Jeśli nie znasz JavaScript, to na początku tworzenie aplikacji może wydać Ci się trudne, lecz i tu z drobną pomocą dowolnego tutoriala JavaScript powinieneś sobie poradzić.
• Dlaczego niektóre zmienne w przykładach mają angielskie, a niektóre polskie nazwy?Kurs jest polskojęzyczny - uważam, że polska nazwa zmiennej ułatwia czytelnikowi, nieznającemu języka angielskiego na odpowiednim poziomie błyskawiczne zorientowanie się o jej działaniu. W przykładach użycie polskiej nazwy funkcji/zmiennej oznacza, że została ona napisana we własnym zakresie i nie jest udostępniana przez API, podczas gdy nazwy angielskie oznaczają funkcję, które API udostępnia standardowo.
• Jaka przeglądarka internetowa jest najlepsza do debugowania i wyświetlania aplikacji?Polecam przeglądarkę Mozilla Firefox - jest szybka, darmowa i dobrze obsługuje standardy wyświetlania, dzięki czemu API działa sprawniej i szybciej niż na przykład na Internet Explorer. Do Firefoxa polecam dodatkowo rozszerzenia Firebug i WebDeveloper Tools, które pozwalają sprawnie i celnie debugować błędy w skryptach (nie tylko tych API, są nieodłączne dla każdego webmastera). Firefoxa wraz z użytecznym toolbarem Google, porszerzającym jego możliwości możesz pobrać z poniższego linka:
  

Pytania techniczne na temat API

• Czy można "obracać" mapę, tzn. wyświetlać zdjęcia terenu obrócone o pewien kąt?Niestety, API nie umożliwia obracania zdjęć, ani też wyświetlania ich pod pewnym ustalonym kątem.
• Co zrobić, by niektóre markery zaczynały się pojawiać dopiero na pewnej wysokości?Użyj managera markerów (GMarkerManager). Jego działanie opisałem na tej stronie: Optymalizacja wyświetlania dużej ilości znaczników
• Czy można to samo zrobić z poliliniami?Należy napisać w tym celu własną, prostą funkcję - jest ona opisana w Wyświetlanie polilinii na pewnym zoomie
• Czy można dodać na mapę własne zdjęcie, które przemieszczałoby się razem z przesuwaniem mapy?Jest to możliwe, w API istnieje klasa GOverlay(), która znacząco ułatwia realizację zadania. Szczegóły w tym kursie
• W Internet Explorer nie działają polilinie!Ze względu na przestarzałą architekturę i zacofanie techniczne, Internet Explorer nie potrafi poradzić sobie z wyświetlaniem polilinii. Istnieje sposób na obejście tego problemu, który został przedstawiony w tym poradniku. Polega on na użyciu VMLa przy rysowaniu polilinii - jest to rozwiązanie wolniejsze niż domyślny sposób, ale na chwilę obecną nic lepszego nie powstało, by Internet Explorer wyświetlał w sposób normalny polilinie.
• Na stronie mojej firmy chciałbym wstawić mapę, ale tak, by użytkownik nie mógł jej przesuwaćMożliwe jest ograniczenie interakcji celem stworzenia złudzenia, że mapa jest statyczna. Lista i wyjaśnienie potrzebnych kroków dostępna jest w tym tutorialu
• Czy da się jakoś zapamiętać środek i zoom mapy tak, by po ponownej wizycie mapa startowała od tego punktu?Tak, zostało to pokazane w tym poradniku: Pamiętanie danych między sesjami
• Jak zmienić język komunikatów, wyświetlanych przez mapę?Wystarczy dodać parametr &hl=XX do adresu URL skryptu z API, gdzie XX to odpowiadający kod języka. Dostępne języki to: baskijski (eu), kataloński (ca), duński (da), holenderski (nl), fiński (fi), francuski (fr), galicyjski (gl), niemiecki (de), włoski (it), japoński (ja), norweski (no), polski (pl), rosyjski (ru), hiszpański (es) i szwedzki (sv).
• Jak obliczyć odległość, pomiędzy dwoma punktami? Metoda oparta na twierdzeniu Pitagorasa daje nieprawidłowe wyniki!Przy liczeniu odległości między dwoma punktami należy uwzględnić również kulistość Ziemii. W metodzie Pitagorasa operujemy na płaszczyźnie, więc odległości punktów koło biegunów mogą być znacznie przekłamane. Poprawnie działająca metoda, służąca do obliczania dystansu opisana została tutaj: Wczytywanie lokalizacji w określonym promieniu
• Gdzieś w moim skrypcie jest błąd. Jak go znaleźć?Użyj konsoli błędów / Firebuga / Webdeveloper Tools. Krótkie omówienie podstaw wraz z przykładami debugowanych aplikacji znajdziesz w dziale Debugowanie skryptów dla początkujących

Pytania na temat tej strony

• Czy w mojej aplikacji muszę umieścić informacje o tej stronie, jeśli wzorowałem/am się na przykładach lub na informacjach tu zawartych?Nie jest to wymagane, aczkolwiek będę wdzięczny za promocję strony tak, by więcej osób mogło poznać dobrodziejstwa API. Gotowe banery znajdziesz w dziale "wsparcie".
• Mam pomysł na przykład/tutorial, czy wykonasz go?Skontaktuj się ze mną - jeśli przykład będzie dotyczył ciekawej rzeczy, której nie poruszyłem dotychczas, oraz będzie miał potencjalnie dość szeroki zakres użycia, to istnieje duże prawdopodobieństwo, że się nim zajmę. Pamiętaj jednak, że najlepsze efekty w zakresie pełnego dostowania skryptu do potrzeb Twojej aplikacji daje zatrudnienie profesjonalisty, który napisze aplikację dokładnie według Twoich wymogów.
• Mój skrypt nie działa, poprawisz go?Skontaktuj się ze mną - w przypadku prostych poprawek mogę wskazać źródło błędu.

Pytania na temat płatności Mikro SMS

• Ile kosztuje dostęp do płatnych materiałów i jak zapłacić wymaganą kwotę?Dostęp na czas 9 dni do wszystkich materiałów kosztuje 9 zł + VAT - oznacza to, że płacisz raz, a z kodu korzystasz przez tydzień na wszystkich poradnikach, także tych, które pojawią się w tym okresie. Płatność odbywa się za pomocą wysłania SMS o specjalnej treści pod określony numer - wszystkie dane podane są na stronie płatnego poradnika.
• Jaką mam gwarancję, że po wysłaniu SMSa otrzymam kod i nie zostanę oszukany?O bezpieczeństwo transakcji dba uznana firma - Wapacz. O solidność i poprawne działanie kodu dba serwis Poznaj Google Maps API, który ma już na swoim koncie setki transakcji, płatnych za pomocą kodu SMS. W razie jakichkolwiek pytań, pisz na adres kontakt (at) gmapsapi.com.
• Jaką mam pewność, że poradnik płatny będzie spełniał moje oczekiwania, skoro przed wysłaniem SMSa nie mogę go sprawdzić?Każdy poradnik płatny posiada orientacyjny licznik znaków - na tej podstawie przed kupnem możesz oszacować jego długość. W opisach poradnika możesz przeczytać, jakie zagadnienia są w nim poruszone. Jakość i styl pisania płatnych poradników są takie same, jak wszystkich innych bezpłatnych, które dominują na stronie.

Mam własne pytanie

Jeśli masz pytanie dotyczące API, możesz zadać mi je:

• pisząc na maila: kontakt( na )gmapsapi.com (z adresu e-mail usuń ciąg ( na ) - zabezpieczenie przed spamem)
• jeśli masz pytanie dot. któregoś z gotowych poradników, wypełnij formularz na dole strony pod tekstem, podając swój e-mail do korespondencji.