Kurz: Migrace webové služby z Google Maps

Azure i Google Maps poskytují přístup k prostorovým rozhraním API prostřednictvím webových služeb REST. Rozhraní API těchto platforem provádějí podobné funkce. Každý z nich ale používá různé konvence pojmenování a objekty odpovědí.

Tento kurz ukazuje, jak:

• Přímé a zpětné geokódování
• Hledání bodů zájmu
• Výpočet tras a směrů
• Získejte obrázek mapy
• Výpočet matice vzdálenosti
• Získání podrobností o časovém pásmu

Naučíte se také:

• Kterou službu Azure Maps REST zvolit při migraci z webové služby Google Maps?
• Tipy k tomu, jak co nejlépe používat služby Azure Maps
• Přehledy o dalších souvisejících službách Azure Maps

Tabulka zobrazuje rozhraní API služby Azure Maps, která mají podobné funkce jako uvedená rozhraní API služby Google Maps.

Rozhraní API služby Google Maps	Rozhraní API služby Azure Maps
Pokyny	Trasa
Matice vzdáleností	Matice pro směrování pošt
Geokódování	Vyhledat
Hledání míst	Vyhledat
Umístit automatické dokončování	Vyhledat
Přichytit k silnici	Viz část Výpočet tras a navigačních pokynů.
Omezení rychlosti	Viz část Zpětné geokódování souřadnice.
Statická mapa	Vykreslení
Časové pásmo	Časové pásmo

V Azure Maps aktuálně nejsou dostupná následující rozhraní API služeb:

• Geografická poloha – Azure Maps má službu s názvem Geolocation, ale poskytuje IP adresu k informacím o poloze, ale v současné době nepodporuje triangulaci mobilní věže ani Wi-Fi.
• Podrobnosti o místech a fotky – Telefonní čísla a adresa URL webu jsou k dispozici v rozhraní API služby Azure Maps Search.
• Adresy URL map
• Nejbližší cesty – dosažitelné pomocí webové sady SDK, jak je znázorněno v ukázce základní logiky přichycení k silniční logice , ale není aktuálně k dispozici jako služba.
• Statické zobrazení ulice

Požadavky

Pokud ještě nemáte předplatné Azure, vytvořte si napřed bezplatný účet.

• Účet Azure Maps
• Klíč předplatného

Poznámka:

Další informace o ověřování ve službě Azure Maps najdete v tématu Správa ověřování v Azure Maps.

Geokódování adres

Geokódování je proces převodu adresy na souřadnici. Například "1 Microsoft way, Redmond, WA" se převede na zeměpisnou délku: -122,1298, zeměpisná šířka: 47,64005. Souřadnice se pak dají použít pro různé druhy účelů, jako je umístění značky na střed na mapě.

Azure Maps nabízí několik metod pro geokódování adres:

• Získat adresu vyhledávání: Geokódování adresy volného formuláře slouží k určení jednoho řetězce adresy (například "1 Microsoft way, Redmond, WA") a okamžité zpracování požadavku. Tato služba se doporučuje, pokud potřebujete rychle zakódovat jednotlivé adresy.
• Získat adresu vyhledávání strukturovaná: Zadejte části jedné adresy, jako je název ulice, město, země/oblast a PSČ a okamžitě žádost zpracujete. Toto rozhraní API se doporučuje, pokud potřebujete rychle geokódovat jednotlivé adresy a data už byla analyzována do jednotlivých částí adresy.
• Batch adresy post Search: Vytvořte žádost obsahující až 10 000 adres a nechte je zpracovat v určitém časovém období. Všechny adresy jsou na serveru geograficky zakódované paralelně a po dokončení úplné sady výsledků je možné stáhnout. To se doporučuje pro geokódování velkých datových sad.
• Get Search Fuzzy: Rozhraní API přibližného vyhledávání kombinuje geokódování adres s vyhledáváním bodů zájmu. Toto rozhraní API přebírá řetězec volného formátu, který může být adresa, místo, orientační bod, bod zájmu nebo kategorie zájmu a okamžitě zpracovat požadavek. Toto rozhraní API se doporučuje pro aplikace, ve kterých můžou uživatelé hledat adresy nebo body zájmu ze stejného textového pole.
• Služba Post Search Fuzzy Batch: Pomocí přibližného dávkového vyhledávání vytvořte požadavek obsahující až 10 000 adres, míst, orientačních bodů nebo bodů zájmu a nechat je zpracovat v průběhu času. Všechna data se zpracovávají paralelně na serveru a po dokončení úplné sady výsledků je možné stáhnout.

Následující tabulka křížově odkazuje na parametry rozhraní API Google Maps se srovnatelnými parametry rozhraní API v Azure Maps.

Parametr rozhraní API Google Maps	Srovnatelný parametr rozhraní API služby Azure Maps
address	query
bounds	topLeft a btmRight
components	streetNumber streetName crossStreet postalCode municipality - město / městys municipalitySubdivision – okolí, sub / super město countrySubdivision - stát nebo provincie countrySecondarySubdivision -hrabství countryTertiarySubdivision -okres countryCode - dvoumísmenný kód země/oblasti
key	subscription-key – Další informace najdete v tématu Ověřování pomocí Azure Maps.
language	language – Další informace naleznete v tématu Podpora lokalizace v Azure Maps.
region	countrySet

Další informace o používání vyhledávací služby najdete v tématu Hledání umístění pomocí služby Azure Maps Search s. Nezapomeňte si projít osvědčené postupy pro vyhledávání.

Tip

Rozhraní API pro geografické kódování a přibližné vyhledávání volných formulářů je možné použít v režimu automatického dokončování přidáním &typeahead=true na adresu URL požadavku. Tím serveru sdělíte, že vstupní text je pravděpodobně částečný a hledání přejde do prediktivního režimu.

Zpětné geografické kódování souřadnice

Zpětné geokódování je proces převodu geografických souřadnic na přibližnou adresu. Souřadnice s "zeměpisná délka: -122.1298, zeměpisná šířka: 47,64005" se převedou na "1 Microsoft way, Redmond, WA".

Azure Maps nabízí několik metod zpětného geokódování:

• Získat zpětnou adresu vyhledávání: Zadejte jednu zeměpisnou souřadnici, abyste získali přibližnou adresu odpovídající této souřadnici. Zpracovává požadavek téměř v reálném čase.
• Get Search Address Reverse Cross Street: Zadejte jednu zeměpisnou souřadnici pro získání informací o blízkých křižovatkových ulicích a požadavek okamžitě zpracovat. Můžete například obdržet následující křížové ulice: 1st Ave a Main St.
• Post Search Address Reverse Batch: Vytvořte požadavek obsahující až 10 000 souřadnic a nechte je zpracovat v určitém časovém období. Všechna data se zpracovávají paralelně na serveru. Po dokončení žádosti si můžete stáhnout úplnou sadu výsledků.

Tato tabulka křížově odkazuje na parametry rozhraní API Google Maps se srovnatelnými parametry rozhraní API v Azure Maps.

Parametr rozhraní API Google Maps	Srovnatelný parametr rozhraní API služby Azure Maps
key	subscription-key – Další informace najdete v tématu Ověřování pomocí Azure Maps.
language	language – Další informace naleznete v tématu Podpora lokalizace v Azure Maps.
latlng	query
location_type	Nedostupné
result_type	entityType

Další informace najdete v osvědčených postupech pro vyhledávání.

Rozhraní API zpětného geokódování v Azure Maps má některé další funkce, které nejsou dostupné v Mapách Google. Tyto funkce můžou být užitečné k integraci s vaší aplikací při migraci aplikace:

• Načtení dat o limitu rychlosti
• Získání informací o použití silnice: místní silnice, hlavní silnice, silnice s omezeným přístupem, nájezdová rampa, atd.
• Zjistit, na které straně ulice se nachází souřadnice

Hledání bodů zájmu

Data typu point-of interest je možné prohledávat v Mapách Google pomocí rozhraní API pro vyhledávání míst. Toto rozhraní API nabízí tři různé způsoby hledání bodů zájmu:

• Najít místo z textu: Vyhledá bod zájmu na základě jeho jména, adresy nebo telefonního čísla.
• Hledání poblíž: Vyhledá body zájmu, které jsou v určité vzdálenosti od místa.
• Hledání textu: Vyhledá místa pomocí volného textu, který obsahuje informace o místě zájmu a umístění. Například "pizza v New Yorku" nebo "restaurace poblíž hlavní ulice".

Azure Maps poskytuje několik rozhraní API vyhledávání pro body zájmu:

• Vyhledat POI: Vyhledejte body zájmu podle názvu. Například "Starbucks".
• Get Search POI Category: Vyhledat body zájmu podle kategorie. Například "restaurace".
• Vyhledat v okolí: Hledá body zájmu, které se nacházejí v určité vzdálenosti od daného místa.
• Get Search Fuzzy: Rozhraní API přibližného vyhledávání kombinuje geokódování adres s vyhledáváním bodů zájmu. Toto rozhraní API přebírá řetězec volného formátu, který může být adresa, místo, orientační bod, bod zájmu nebo kategorie zájmu a okamžitě zpracovat požadavek. Toto rozhraní API se doporučuje pro aplikace, ve kterých můžou uživatelé hledat adresy nebo body zájmu ze stejného textového pole.
• Post Search Inside Geometry: Vyhledejte body zájmů, které jsou v zadané geometrii. Například vyhledejte bod zájmu v rámci mnohoúhelníku.
• Post Search Along Route: Vyhledejte místa zájmu, která jsou podél zadané trasy.
• Post Search Fuzzy Batch: Použijte fuzzy dávkové vyhledávání k vytvoření požadavku obsahujícího až 10 000 adres, míst, orientačních bodů nebo bodů zájmu, které budou zpracovány v průběhu určité doby. Všechna data se zpracovávají paralelně na serveru a po dokončení úplné sady výsledků je možné stáhnout.

Azure Maps v současné době nemá srovnatelné rozhraní API pro vyhledávání textu v Mapách Google.

Tip

Rozhraní API pro vyhledávání POI, vyhledávání kategorií POI a neurčité vyhledávání lze použít v režimu automatického dokončování přidáním &typeahead=true k adrese URL požadavku. Tím serveru sdělíte, že vstupní text je pravděpodobně částečný. Rozhraní API provede vyhledávání v prediktivním režimu.

Další informace najdete v osvědčených postupech pro vyhledávání.

Najít místo z textu

Pomocí rozhraní AZURE Maps Get Search POI a Get Search Fuzzy vyhledejte body zájmů podle jména nebo adresy.

Tabulka křížově odkazuje na parametry rozhraní API Google Maps se srovnatelnými parametry rozhraní API služby Azure Maps.

Parametr rozhraní API Google Maps	Srovnatelný parametr rozhraní API služby Azure Maps
fields	Neuvedeno
input	query
inputtype	N/A
key	subscription-key – Další informace najdete v tématu Ověřování pomocí Azure Maps.
language	language – Další informace naleznete v tématu Podpora lokalizace v Azure Maps.
locationbias	lat, lon a radius topLeft a btmRight countrySet

Hledání v okolí

Pomocí rozhraní GET Search Nearby API načtěte v Azure Maps nejbližší body zájmů.

V tabulce jsou uvedeny parametry rozhraní API Google Maps se srovnatelnými parametry rozhraní API služby Azure Maps.

Parametr rozhraní API Google Maps	Srovnatelný parametr rozhraní API služby Azure Maps
key	subscription-key – Další informace najdete v tématu Ověřování pomocí Azure Maps.
keyword	categorySet a brandSet
language	language – Další informace naleznete v tématu Podpora lokalizace v Azure Maps.
location	lat a lon
maxprice	neplatí
minprice	N/A
name	categorySet a brandSet
opennow	není k dispozici
pagetoken	ofs a limit
radius	radius
rankby	–
type	categorySet – Další informace najdete v podporovaných kategoriích hledání.

Výpočet tras a směrů

Spočítejte trasy a navigační pokyny pomocí Azure Maps. Azure Maps má mnoho stejných funkcí jako služba směrování Google Maps, například:

• Časy příjezdu a odjezdu.
• Trasy dopravy v reálném čase a na základě predikce.
• Různé druhy dopravy. Například řízení, chůze a jízdní kola.

Poznámka:

Azure Maps vyžaduje, aby všechny waypointy byly souřadnice. Adresy musí být nejprve geokódované.

Služba směrování Azure Maps poskytuje následující rozhraní API pro výpočet tras:

• Získat pokyny pro trasu: Vypočítat trasu a zajistit okamžité zpracování požadavku. Toto rozhraní API podporuje jak GET, tak POST žádosti. POST Požadavky se doporučují při zadávání velkého počtu směrovacích bodů nebo při použití velkého množství možností trasy, aby se zajistilo, že požadavek na adresu URL nebude příliš dlouhý a nezpůsoboval problémy. Směr POST trasy v Azure Maps nabízí možnost přijmout tisíce podpůrných bodů a použít je k opětovnému vytvoření logické trasy mezi nimi (přichycení k silnici).
• Dávka směrů po trasách: Vytvořte požadavek obsahující až 1 000 žádostí o trasu a nechte je zpracovat v určitém časovém období. Všechna data se zpracovávají paralelně na serveru a po dokončení úplné sady výsledků je možné stáhnout.

Tabulka křížově odkazuje na parametry rozhraní API Google Maps se srovnatelnými parametry rozhraní API v Azure Maps.

Parametr rozhraní API Google Maps	Srovnatelný parametr rozhraní API služby Azure Maps
alternatives	maxAlternatives
arrival_time	arriveAt
avoid	avoid
departure_time	departAt
destination	query – souřadnice ve formátu "lat0,lon0:lat1,lon1…."
key	subscription-key – Další informace najdete v tématu Ověřování pomocí Azure Maps.
language	language – Další informace naleznete v tématu Podpora lokalizace v Azure Maps.
mode	travelMode
optimize	computeBestOrder
origin	query
region	Není k dispozici – tato funkce souvisí s geokódováním. Při použití rozhraní API geografického kódování Azure Maps použijte parametr countrySet.
traffic_model	Není k dispozici – Může určit pouze to, jestli se mají použít data provozu s parametrem provozu .
units	Není k dispozici – Azure Maps používá pouze systém metrik.
waypoints	query

Tip

Rozhraní API pro plánování tras Azure Maps ve výchozím nastavení vrací pouze souhrn. Vrátí vzdálenost a časy a souřadnice trasy. Pomocí parametru instructionsType můžete načíst pokyny krok za krokem. A pomocí parametru routeRepresentation vyfiltrujte souhrnnou a směrovací cestu.

Rozhraní API pro směrování Azure Maps má další funkce, které nejsou dostupné v Google Maps. Při migraci aplikace zvažte použití těchto funkcí:

• Podpora pro typy tras: nejkratší, nejrychlejší, odvážné a nejúspornější.
• Podpora pro jiné režimy dopravy: autobus, motocykl, taxi, nákladní vůz a dodávka.
• Podpora pro 150 waypointů
• Vypočítejte více časů cestování v rámci jedné žádosti: historický provoz, živý provoz, žádný provoz.
• Vyhněte se jiným typům silnic: silnice pro spolujízdu, nezpevněné silnice, využité silnice.
• Zadejte vlastní oblasti, kterým se chcete vyhnout.
• Omezte nadmořskou výšku, kterou může trasa stoupat.
• Trasa založená na specifikacích motoru. Vypočítejte trasy pro spalovací nebo elektrická vozidla na základě specifikací motoru a zbývajícího paliva nebo poplatku.
• Podpora parametrů trasy pro komerční vozidla Například rozměry vozidla, hmotnost, počet axelů a typ nákladu.
• Zadejte maximální rychlost vozidla.

Kromě toho služba trasování ve službě Azure Maps podporuje funkci Get Route Range. Výpočet směrovatelných rozsahů se také označuje jako izochrony. To zahrnuje generování mnohoúhelníku pokrývající oblast, do které lze cestovat v libovolném směru od počátečního bodu. Vše v zadaném množství času nebo množství paliva nebo poplatku.

Další informace najdete v osvědčených postupech pro směrování.

Získat obrázek mapy

Azure Maps poskytuje rozhraní API pro vykreslování obrázků statických map s překryvnými daty. Rozhraní API Pro získání statického obrázku v Azure Maps je srovnatelné s rozhraním API statické mapy v Mapách Google.

Poznámka:

Azure Maps vyžaduje, aby střed, všechny značky a umístění cest byly ve formátu souřadnic „zeměpisná délka, zeměpisná šířka“. Zatímco Google Maps používá formát "zeměpisná šířka,zeměpisná délka". Adresy musí být nejprve geokódované.

Tabulka křížově odkazuje na parametry rozhraní API Google Maps se srovnatelnými parametry rozhraní API v Azure Maps.

Parametr rozhraní API Google Maps	Srovnatelný parametr rozhraní API služby Azure Maps
center	center
format	format – zadané jako součást cesty URL. V současné době se podporuje jenom formát PNG.
key	subscription-key – Další informace najdete v tématu Ověřování pomocí Azure Maps.
language	language – Další informace naleznete v tématu Podpora lokalizace v Azure Maps.
maptype	layer a style – Další informace naleznete v tématu Podporované styly mapy.
markers	pins
path	path
region	Není k dispozici – funkce související s geokódováním. countrySet Tento parametr použijte při použití rozhraní API geokódování služby Azure Maps.
scale	nedostupné
size	width a height – Maximální velikost je 8192 x 8192.
style	Není k dispozici
visible	Nepoužitelné
zoom	zoom

Poznámka:

V systému dlaždic Azure Maps jsou dlaždice dvakrát větší než dlaždice mapy používané v Mapách Google. Hodnota přiblížení v Azure Maps se bude v porovnání s Google Maps jevit o jednu úroveň přiblížení blíže. Chcete-li tento rozdíl kompenzovat, snižte úroveň přiblížení v migrovaných požadavcích.

Další informace naleznete v tématu Vykreslení vlastních dat na rastrové mapě.

Kromě možnosti vygenerovat statický obrázek mapy umožňuje služba Azure Maps Render přímý přístup k dlaždicím map v rastrovém formátu (PNG) a vektorovém formátu:

• Získat mapový statický obrázek: Získat rastrové (PNG) a vektorové dlaždice pro základní mapy (silnice, hranice, pozadí).
• Získat dlaždici mapy: Načtěte letecké a satelitní dlaždice snímků.

Tip

Mnoho aplikací Google Maps bylo před několika lety převedeno z interaktivních mapových prostředí na obrázky statických map. To bylo provedeno jako metoda úspory nákladů. V Azure Maps je obvykle nákladově efektivnější používat interaktivní ovládací prvek mapy ve webové sadě SDK. Interaktivní ovládací prvek mapy účtuje na základě počtu načtených dlaždic. Dlaždice map v Azure Maps jsou velké. Často stačí jen několik dlaždic k vytvoření stejného zobrazení mapy jako u statické mapy. Prohlížeč automaticky ukládá dlaždice mapy do mezipaměti. Proto interaktivní ovládací prvek mapy často generuje zlomek transakce při reprodukování statického zobrazení mapy. Posouvání a přiblížení bude načítat více dlaždic, v ovládacím prvku mapy však existují možnosti, které toto chování umožňují vypnout. Interaktivní ovládací prvek mapy také nabízí mnohem více možností vizualizace než služby statických map.

Porovnání formátu parametrů adresy URL značky

Před: Mapy Google

Přidejte značky pomocí parametru markers v adrese URL. Tento markers parametr přebírá styl a seznam umístění, která se mají vykreslit na mapě s tímto stylem, jak je znázorněno níže:

&markers=markerStyles|markerLocation1|markerLocation2|...

Pokud chcete přidat další styly, použijte markers parametry na adresu URL s jiným stylem a sadou umístění.

Zadejte umístění značek ve formátu zeměpisná šířka a zeměpisná délka.

Přidejte styly značek s optionName:value formátem s více styly oddělenými znaky svislé znaky (|) jako "optionName1:value1|optionName2:value2". Všimněte si, že názvy možností a hodnoty jsou oddělené dvojtečky (:). Pro značky stylů v Mapách Google použijte následující názvy stylů:

• color – Barva výchozí ikony značky. Může se jednat o 24bitovou šestnáctkovou barvu (0xrrggbb) nebo jednu z následujících hodnot; black, , brown, green, purple, yellow, blue, grayorange, red. white
• label – Jedno velké alfanumerické znaménko, které se zobrazí nad ikonou.
• size - Velikost značky. Může být tiny, midnebo small.

Pro vlastní ikony v Mapách Google použijte následující názvy možností stylu:

• anchor – Určuje, jak zarovnat obrázek ikony ke souřadnici. Může to být hodnota pixelu (x,y) nebo jedna z následujících hodnot; top, bottom, left, , right, centertopleft, , topright, bottomleft, nebo bottomright.
• icon – Adresa URL odkazující na obrázek ikony.

Pojďme například k mapě přidat červenou střední značku v délce: -110, zeměpisnou šířku: 45:

&markers=color:red|size:mid|45,-110

Po: Azure Maps

Přidejte značky do obrázku statické mapy zadáním parametru pins v adrese URL. Podobně jako Google Maps zadejte styl a seznam umístění v parametru. Parametr pins lze zadat vícekrát, aby podporoval značky s různými styly.

&pins=iconType|pinStyles||pinLocation1|pinLocation2|...

Pokud chcete použít jiné styly, přidejte do adresy URL další pins parametry s jiným stylem a sadou umístění.

V Azure Maps musí být umístění špendlíku ve formátu zeměpisná délka a zeměpisná šířka. Google Maps používá formát "zeměpisná šířka,zeměpisná délka". Mezera, nikoli čárka, odděluje zeměpisnou délku a zeměpisnou šířku ve formátu Azure Maps.

Určuje iconType typ připínáčku, který se má vytvořit. Může mít následující hodnoty:

• default – Výchozí ikona připínáčku.
• none – Nezobrazuje se žádná ikona, vykreslují se jenom popisky.
• custom – Určuje vlastní ikonu, která se má použít. Adresu URL odkazující na obrázek ikony lze přidat na konec parametru pins za informace o umístění pinu.

Přidejte styly pinů s formátem optionNameValue. Oddělte více stylů svislítky (|). Například: iconType|optionName1Value1|optionName2Value2. Názvy možností a hodnoty nejsou oddělené. Použijte následující názvy možností stylu pro úpravu značek:

• al – Určuje neprůhlednost (alfa) značky. Zvolte číslo mezi 0 a 1.
• an – Určuje ukotvení kolíku. Zadejte hodnoty X a y pixelů ve formátu x y.
• co – Barva špendlíku. Zadejte 24bitovou šestnáctkovou barvu: 000000 do FFFFFF.
• la – Určuje ukotvení štítku. Zadejte hodnoty X a y pixelů ve formátu x y.
• lc – Barva štítku. Zadejte 24bitovou šestnáctkovou barvu: 000000 do FFFFFF.
• ls – Velikost popisku v pixelech. Zvolte číslo větší než 0.
• ro – Hodnota ve stupních pro otočení ikony. Zvolte číslo mezi -360 a 360.
• sc – Hodnota měřítka ikony připínáčku. Zvolte číslo větší než 0.

Zadejte hodnoty popisků pro každé umístění pinu. Tento přístup je efektivnější než použití jedné hodnoty popisku u všech značek v seznamu umístění. Hodnota popisku může být řetězcem více znaků. Zabalte řetězec jednoduchými uvozovkami, aby se nepletl se stylem nebo hodnotou umístění.

Pojďme přidat červenou (FF0000) výchozí ikonu s popiskem "Mezerník" umístěným pod (15 50). Ikona je v délce: -122,349300, zeměpisná šířka: 47.620180:

&pins=default|coFF0000|la15 50||'Space Needle' -122.349300 47.620180

Přidejte tři špendlíky s hodnotami popisku 1, 2 a 3:

&pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

Porovnání formátu parametrů adresy URL cesty

Před: Mapy Google

Přidejte čáry a mnohoúhelník na obrázek statické mapy pomocí parametru path v adrese URL. Parametr path přebírá styl a seznam umístění, která se mají vykreslit na mapě:

&path=pathStyles|pathLocation1|pathLocation2|...

Další styly použijte přidáním dalších path parametrů na adresu URL s jiným stylem a sadou umístění.

Umístění cest se zadají ve latitude1,longitude1|latitude2,longitude2|… formátu. Cesty můžou být kódované nebo mohou obsahovat adresy pro body.

Přidejte styly cesty ve formátu optionName:value, oddělte více stylů znakem svislé čáry (|). Názvy a hodnoty možností také oddělte dvojtečkami (:)). Například: optionName1:value1|optionName2:value2. Následující názvy stylů lze použít ke stylizaci cest v Mapách Google:

• color – Barva obrysu cesty nebo mnohoúhelníku. Může se jednat o 24bitovou šestnáctkovou barvu (0xrrggbb), 32bitovou šestnáctkovou barvu (0xrrggbbbaa) nebo jednu z následujících hodnot: černá, hnědá, zelená, fialová, žlutá, modrá, šedá, oranžová, červená, bílá.
• fillColor – Barva k vyplnění oblasti cesty (mnohoúhelník). Může se jednat o 24bitovou šestnáctkovou barvu (0xrrggbb), 32bitovou šestnáctkovou barvu (0xrrggbbbaa) nebo jednu z následujících hodnot: černá, hnědá, zelená, fialová, žlutá, modrá, šedá, oranžová, červená, bílá.
• geodesic – Označuje, zda cesta by měla být čára, která následuje zakřivení země.
• weight – Tloušťka čáry cesty v pixelech.

Přidejte do mapy mezi souřadnice v parametru URL červenou neprůhlednost a tloušťku pixelů. V následujícím příkladu má čára 50% neprůhlednost a tloušťku čtyř pixelů. Souřadnice jsou zeměpisná délka: -110, zeměpisná šířka: 45 a délka: -100, zeměpisná šířka: 50.

&path=color:0xFF000088|weight:4|45,-110|50,-100

Následuje: Azure Maps

Přidejte řádky a mnohoúhelníky do statického obrázku mapy zadáním parametru path v adrese URL. Podobně jako Google Maps zadejte styl a seznam umístění v tomto parametru. path Zadejte parametr několikrát pro vykreslení více kruhů, čar a mnohoúhelníků s různými styly.

&path=pathStyles||pathLocation1|pathLocation2|...

Pokud jde o umístění cest, služba Azure Maps vyžaduje, aby souřadnice byly ve formátu zeměpisná délka a zeměpisná šířka. Google Maps používá formát "zeměpisná šířka,zeměpisná délka". Mezera, nikoli čárka, odděluje zeměpisnou délku a zeměpisnou šířku ve formátu Azure Maps. Azure Maps nepodporuje kódované cesty ani adresy bodů.

Přidejte styly cest s formátem optionNameValue . Oddělte více stylů znaky svislé znaky (|), jako je tento optionName1Value1|optionName2Value2. Názvy možností a hodnoty nejsou oddělené. Pro stylování cest ve službě Azure Maps použijte následující názvy možností stylu:

• fa - Průhlednost barvy výplně (alfa) použitá při vykreslování mnohoúhelníků. Zvolte číslo mezi 0 a 1.
• fc - Barva výplně použitá k vykreslení oblasti mnohoúhelníku.
• la – Průhlednost barvy čáry (alfa) použitá při vykreslování čar a obrysů mnohoúhelníků. Zvolte číslo mezi 0 a 1.
• lc – Barva čáry používaná k vykreslení čar a obrysu mnohoúhelníku.
• lw – Šířka čáry v pixelech.
• ra – Určuje poloměr kruhů v metrech.

Přidejte mezi souřadnice v parametru URL červenou neprůhlednost a tloušťku pixelů. V následujícím příkladu má čára 50% neprůhlednost a tloušťku čtyř pixelů. Souřadnice mají následující hodnoty: zeměpisná délka: -110, zeměpisná šířka: 45 a délka: -100, zeměpisná šířka: 50.

&path=lcFF0000|la.5|lw4||-110 45|-100 50

Výpočet matice vzdálenosti

Azure Maps poskytuje rozhraní API matice vzdálenosti. K výpočtu času cestování a vzdáleností mezi sadou míst použijte toto rozhraní API s maticí vzdáleností. Je srovnatelné s rozhraním API matice vzdálenosti v Google Maps.

• Matice směrování: Asynchronně vypočítá časy cesty a vzdálenosti pro sadu výchozích bodů a cílů. Podporuje až 700 buněk na požadavek. To je počet původů vynásobený počtem cílů. S tímto omezením jsou příklady možných dimenzí matice: 700x1, 50x10, 10x10, 28x25, 10x70.

Poznámka:

Požadavek na rozhraní API matice vzdálenosti lze provést pouze pomocí POST požadavku s informacemi o původu a cíli v textu požadavku. Kromě toho služba Azure Maps vyžaduje, aby všechny zdroje a cíle byly souřadnice. Adresy musí být nejprve geokódované.

Tato tabulka křížově odkazuje na parametry rozhraní API Google Maps se srovnatelnými parametry rozhraní API služby Azure Maps.

Parametr rozhraní API Google Maps	Srovnatelný parametr rozhraní API služby Azure Maps
arrival_time	arriveAt
avoid	avoid
departure_time	departAt
destinations	destination – uveďte v těle žádosti jako GeoJSON.
key	subscription-key – Další informace najdete v tématu Ověřování pomocí Azure Maps.
language	language – Další informace naleznete v tématu Podpora lokalizace v Azure Maps.
mode	travelMode
origins	origins – uveďte v textu požadavku jako GeoJSON.
region	Není k dispozici – tato funkce souvisí s geokódováním. countrySet Tento parametr použijte při použití rozhraní API geokódování služby Azure Maps.
traffic_model	Není k dispozici – Může určit pouze to, jestli se mají s parametrem traffic použít data provozu.
transit_mode	Není k dispozici – matice vzdálenosti založené na tranzitu se v současné době nepodporují.
transit_routing_preference	Není k dispozici – matice vzdálenosti založené na tranzitu se v současné době nepodporují.
units	Není k dispozici – Azure Maps používá pouze systém metrik.

Tip

Všechny pokročilé možnosti směrování dostupné v rozhraní API směrování Azure Maps jsou podporovány v rozhraní API pro matici vzdálenosti Azure Maps. Mezi pokročilé možnosti směrování patří směrování nákladního vozu, specifikace motoru atd.

Další informace najdete v osvědčených postupech pro směrování.

Získání časového pásma

Azure Maps poskytuje rozhraní API pro načtení časového pásma souřadnice. Rozhraní API časového pásma Azure Maps je srovnatelné s rozhraním API časového pásma v Google Maps:

• Získat časové pásmo podle souřadnic: Zadejte souřadnici a získejte podrobnosti časového pásma souřadnice.

Tato tabulka křížově odkazuje na parametry rozhraní API Google Maps se srovnatelnými parametry rozhraní API v Azure Maps.

Parametr rozhraní API Google Maps	Srovnatelný parametr rozhraní API služby Azure Maps
key	subscription-key – Další informace najdete v tématu Ověřování pomocí Azure Maps.
language	language – Další informace naleznete v tématu Podpora lokalizace v Azure Maps.
location	query
timestamp	timeStamp

Kromě tohoto rozhraní API poskytuje Azure Maps mnoho rozhraní API časového pásma. Tato rozhraní API převádějí čas na základě názvů nebo ID časového pásma:

• Získání časového pásma podle ID: Vrátí současné, historické a budoucí informace o časovém pásmu pro zadané ID časového pásma IANA.
• Získat timezone enum IANA: Vrátí úplný seznam ID časových pásem IANA. Aktualizace služby IANA se projeví v systému do jednoho dne.
• Získat Výčet časových pásem Windows: Vrátí úplný seznam ID časových pásem Windows.
• Získat verzi IANA časového pásma: Vrátí aktuální číslo verze IANA, které používá služba Azure Maps.
• Převedení časového pásma Windows na IANA: Vrátí odpovídající ID IANA s ohledem na platné ID časového pásma systému Windows. Pro jedno ID systému Windows může být vráceno více ID IANA.

Klientské knihovny

Azure Maps poskytuje klientské knihovny pro následující programovací jazyky:

• JavaScript, TypeScript, Node.js – balíček npm modulu | služby Azure Maps

Tyto opensourcové klientské knihovny jsou určené pro jiné programovací jazyky:

• .NET Standard 2.0 – projekt GitHub | balíček NuGet

Vyčištění prostředků

Žádné prostředky k vyčištění.

Další kroky

Další informace o službách REST služby Azure Maps:

Osvědčené postupy pro vyhledávání