AMap
AMapPartBase
AMapPartDraggable
Enums
Overlay
Spatial
Utils
ARouterPart
ASearchPart
Index

AGeoPoint

Třída definuje polohu v konkrétním kartografickém systému daném výčtem ACoordinateSystem.  AMapy API podporují tři souřadné systémy.  Pomocí metody AGeoPoint.convertTo lze polohu konvertovat.

Další velmi užitečnou funcionalitou je možnost inicializace polohy z GPS souřadnice zadané v textovém řetězci.

Pozor dejte v případě předávání instance AGeoPoint jinému objektu, předávání objektů v Javascriptu se děje “by reference”.  Pokud dva objekty sdílí jednu instanci, hrozí že si vzájemně mohou přepisovat své hodnoty x a y.  Pokud chcete jednu instanci AGeoPoint předat jinému objektu bezpečně, použíjte metodu AGeoPoint.clone.

Argumenty

xx integer hodnota v konkrétním kartografickém souřadném systému.
yy integer hodnota v konkrétním kartografickém souřadném systému.  Záměrně nepíši vertikální, protože kartografické souřadné systému jsou otočené.
coordinateSystemHodnota z enumerace ACoordinateSystem, v případě, že parametr není zadán - je konkrétní ACoordinateSystem výčet detekován podle hodnot x a y.
geoParametr může být i jen jeden, v tom případě bude považován za textový řetězec obsahující GPS a bude proveden pokus o jeho parsování.

Příklad

var firstPlace = new AGeoPoint(3460690, 5551757, ACoordinateSystem.S42);
var secondPlace = new AGeoPoint("50°04\'45.78\"N; 14°24\'19.58\"E");
Summary
AGeoPoint
Třída definuje polohu v konkrétním kartografickém systému daném výčtem ACoordinateSystem.
Functions
parseGPS
Metoda pro konverzi GPS pozice zadané v textovém řetězci do AGeoPoint.
convertTo
Metoda zkonvertuje souřadnice do požadovaného systému ACoordinateSystem, a vrátí nový objekt.
clone
Metoda vrátí klon aktuální instance AGeoPoint.
getCoordinateSystem
Metoda vrátí ACoordinateSystem.
distanceFrom
Metoda vrátí v metrech vzdálenost mezi body.
distanceFromFormatted
Metoda vrátí naformátovanou vzdálenost v metrech.
formatDistance
Metoda naformátuje vzdálenost v metrech.
toDisplayGPS
Vypíše souřadnice ve formátu WGS84 (GPS) hezky naformátované.
isValid
Ověří, zda-li jsou x, y, a coordinateSystem čísla.
toString
Vypíše souřadnice hezky naformátované, asi takto: x: hodnota y: hodnota coord: hodnota

Functions

parseGPS

AGeoPoint.prototype.parseGPS = function(gpsString)

Metoda pro konverzi GPS pozice zadané v textovém řetězci do AGeoPoint.  Podporuje mnoho ruzných formátů.  Je volána z konstruktoru, nebo může být zavolána přímo.  Aktualizuje pozici bodu, na kterém byla zavolána.  Při použití znaku ° a podobných, je nutné uložit HTML stránku v UNICODE kódování (nebo jiném podporujícím tyto znaky) Oddělovačem zeměpisné šířky a délky (fi, lambda) může být:

  • mezera
  • , čárka
  • ; středník

Podporovány jsou tyto zápisy a libovolné jejich kombinace

  • 15
  • +15.347534
  • +15.347534°
  • 15.3434°N
  • 15d30.344’N
  • 15° 30.344’N
  • 15° 30’ 3.34”N
  • bez mezery i s mezerou
  • za desetinný oddělovač je považována pouze tečka “.”

Kontroluje přítomnost definice šířky/délky a případně koordináty prohodí.

  • fi = N/S(-)
  • lambda = E/W(-)

Příklad

var someUserInput = "50°04\'45.78\"N; 14°24\'19.58\"E";
var point = new AGeoPoint(someUserInput);

convertTo

AGeoPoint.prototype.convertTo = function(coordinateSystem)

Metoda zkonvertuje souřadnice do požadovaného systému ACoordinateSystem, a vrátí nový objekt.

Returns

geopointnově vytvořený objekt v požadovaném souřadnicovém systému

clone

AGeoPoint.prototype.clone = function()

Metoda vrátí klon aktuální instance AGeoPoint.  Pokud chcete pozici před jinému objektu, který ji bude upravovat, předejte mu raději klon instance, je to bezpečnější.

Returns

Klon instance AGeoPoint

getCoordinateSystem

AGeoPoint.prototype.getCoordinateSystem = function()

Metoda vrátí ACoordinateSystem.

Returns

ACoordinateSystem

distanceFrom

AGeoPoint.prototype.distanceFrom = function(geopoint)

Metoda vrátí v metrech vzdálenost mezi body.

Arguments

geopointBod AGeoPoint ohraničující měřenou vzdálenost

Returns

integervzdálenost v metrech

distanceFromFormatted

AGeoPoint.prototype.distanceFromFormatted = function(geopoint)

Metoda vrátí naformátovanou vzdálenost v metrech.  Přidá označení jednotky a zaokrouhlí hodnotu.

Arguments

geopointBod AGeoPoint ohraničující měřenou vzdálenost

Returns

Vzdálenost naformátovaná pro zobrazení i s jednotkami, zaokrouhlena na dvě desetinná místa.

formatDistance

AGeoPoint.prototype.formatDistance = function(distance)

Metoda naformátuje vzdálenost v metrech.  Přidá označení jednotky a zaokrouhlí hodnotu.

Arguments

distancečíslo vzdálenost v metrech

Returns

Vzdálenost naformátovaná pro zobrazení i s jednotkami, zaokrouhlena na dvě desetinná místa.

toDisplayGPS

AGeoPoint.prototype.toDisplayGPS = function(coordinateSystem)

Vypíše souřadnice ve formátu WGS84 (GPS) hezky naformátované.

isValid

AGeoPoint.prototype.isValid = function(coordinateSystem)

Ověří, zda-li jsou x, y, a coordinateSystem čísla.  Neověřuje, jestli se poloha nachází na mapě.

toString

AGeoPoint.prototype.toString = function(coordinateSystem)

Vypíše souřadnice hezky naformátované, asi takto: x: hodnota y: hodnota coord: hodnota
Generated by Natural Docs
Definuje kartografický souřadný systém.
AGeoPoint.prototype.parseGPS = function(gpsString)
Metoda pro konverzi GPS pozice zadané v textovém řetězci do AGeoPoint.
Třída definuje polohu v konkrétním kartografickém systému daném výčtem ACoordinateSystem.
AGeoPoint.prototype.convertTo = function(coordinateSystem)
Metoda zkonvertuje souřadnice do požadovaného systému ACoordinateSystem, a vrátí nový objekt.
AGeoPoint.prototype.clone = function()
Metoda vrátí klon aktuální instance AGeoPoint.
AGeoPoint.prototype.getCoordinateSystem = function()
Metoda vrátí ACoordinateSystem.
AGeoPoint.prototype.distanceFrom = function(geopoint)
Metoda vrátí v metrech vzdálenost mezi body.
AGeoPoint.prototype.distanceFromFormatted = function(geopoint)
Metoda vrátí naformátovanou vzdálenost v metrech.
AGeoPoint.prototype.formatDistance = function(distance)
Metoda naformátuje vzdálenost v metrech.
AGeoPoint.prototype.toDisplayGPS = function(coordinateSystem)
Vypíše souřadnice ve formátu WGS84 (GPS) hezky naformátované.
AGeoPoint.prototype.isValid = function(coordinateSystem)
Ověří, zda-li jsou x, y, a coordinateSystem čísla.
AGeoPoint.prototype.toString = function(coordinateSystem)
Vypíše souřadnice hezky naformátované, asi takto: x: hodnota y: hodnota coord: hodnota