Geografická API od Google

Geografická API od Google
Erik Šivic, SIV021
Obsah
• Webové služby
– Google Geocoding API
– Google Directions API
– Google Elevation API
– Google Places API
• Google Latitude API
Práce s API /obecně/
• Požadavek musí mít následující formát
http://maps.googleapis.com/maps/api/apiName/outputFormat?parameters
• Api name (název API)
– Geocoding
– Directions
– Elevation
– Places
• OutputFormat
– JSON
– XML
• Parameters
– různé pro každé API
Google Geocoding API
• Geocoding = proces převodu adresy (jako „ 1600
Amphitheatre Parkway, Mountain View, CA“) na
geografické souřadnice (jako 37,423021 z.š. 122,083739 z.d.)
• Reverse geocoding = opačný proces (převod
souřadnic na adresu)
• API poskytuje přímou cestu pro přístup ke
geokóderu přes HTTP
• Omezení na 2.500 požadavků na den na IP adresu
Geocoding API - parametry
• Geocoding
– Address (řetězec s adresou)
• Reverse geocoding
–
–
–
–
–
Latlng (souřadnice)
Bounds
Region (místo aplikace)
Language
Sensor
Výstupní formát JSON
Vrací 2 základní elementy
Status = metadata požadavku
Results = pole s informacemi o adrese
a geometrickými informacemi
Výstupní formát JSON
Parsování výsledku
Výstupní formát XML
Skládá se z jednoho hlavního elementu
<GeocodeResponse> a 2 dalších
elementů <status> a <result>
Parsování výstupu pomocí XPath
Typy adres (adress_component)
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
street_address
route
intersection
political
country
administrative_area_level_1
administrative_area_level_2
administrative_area_level_3
colloquial_area
locality
sublocality
neighborhood
premise
subpremise
postal_code
natural_feature
airport
park
point_of_interest
Google Directions API
• API pro výpočet trasy
• Odkud -> Kam + další body na trase (8 max)
• Body mohou být zadány textově nebo
souřadnicema
• Omezení na 2.500 požadavků na den
Directions API – parametry požadavku
•
•
•
•
•
•
origin (odkud)
Destination (kam)
mode (autem, pěšky, na kole))
waypoints (body na trase)
alternatives (zobrazit alternativní cesty)
avoid (vyhnout se)
– tolls (mýta)
– highways (dálnice)
•
•
•
•
units (jednotky výstupu – míle, kilometry)
region (místo zdroje požadavku)
language
sensor (má dotazovací zařízení senzor pro zjíšťování polohy)
Directions API – výstup
Google Elevation API
• Poskytuje údaje o nadmořské výšce
• Včetně hloubky moří a oceánu
• Chybějící údaje dopočítávány ze 4 nejbližších
okolních bodů
• Umožňuje vývoj aplikací, kde je převýšení
podstatným faktorem, např. tréninkové či
běžkařské aplikace
Elevation API – parametry požadavku
• Locations (souřadnice pro zjístění n.v.)
nebo
• Path (set několika lokací)
• Samples (počet bodů na cestě)
• Sensor (má aplikace senzor pro určování
polohy?)
Elevation API – výstup
Elevation API – výstup pro uživatele s
grafem nadmořské výšky
Google Places API
• Vrací informace o místě
– Místo = významné či specifické místo obsažené v API (např.
cesta)
• 4 základní typy požadavků
–
–
–
–
Place Search (nalezení míst v okolí)
Place Check-in (oznámení, že uživatel dorazil na místo)
Place Details (vrací bližší informace o místě)
Place Report (umožňuje přeposílání informací od uživatele
do služby = nová místa či události)
• Navrženo především pro aplikace, které potřebují zjistit
místo, kde se právě uživatel nachází
Google Latitude API
• Umožňuje sdílet svou polohu s přáteli nebo zobrazit na
mapě tu jejich.
• Nutné přihlášení a povolení služby
Funkce Google Latitude umožňuje:
- Sdílet svou aktuální polohu a stav s vybranými přáteli
- Zobrazit své přátele na mapě a zjistit, co právě dělají
- Rychle přátelům zavolat nebo je kontaktovat pomocí
textových zpráv či chatu
- Vybrat, se kterými uživateli chcete sdílet informace o
poloze a jak mnoho informací s nimi chcete sdílet.
Google Latitude API
Zdroje
• code.google.com
• www.google.com
Žádné dotazy??? V tom případě…
DĚKUJI ZA POZORNOST