跳转到主要内容

船数据Fleetmon API包装器

项目描述

Fleetmonger

Python包装器,用于fleetmon.com的船舶跟踪API。

API调用

在Fleetmonger中阅读API的详细信息。 * fleetmonger.myfleet * fleetmonger.vessel * fleetmonger.vesselparticulars * fleetmonger.vesselurl * fleetmonger.porturl * fleetmonger.weather * fleetmonger.containerschedule

请注意,某些API调用需要在Fleetmon购买积分。本软件包与Fleetmon无关,使用时请自行承担风险。

用法

from fleetmonger import Fleetmonger

fm = Fleetmonger('username', 'your key')

fleet = fm.myfleet()

for ship in fleet:
    print ship.name, ship.destination

船舶

my_vessel = fleet[0]
# or
my_vessel = fm.vessel(mmsi='239725000')
# or
my_vessel = fm.vessel(imo='9197545')
# or
my_vessel = fm.vessel(name='MINNOW')

# Passing incomplete information will raise an error
my_vessel = fm.vessel()
# ValueError

my_vessel.name
# <SS MINNOW>

my_vessel.navigationstatus
# 'On a three hour tour'

my_vessel.etatime
# datetime.datetime(1964, 9, 26, 12, 0, tzinfo=<UTC>)

my_vessel.coords
# (3.469557, -167.255859)

# Missing attributes return None
my_vessel.location
# None

my_vessel.flag
# 'United States'

my_vessel.flag_so
# 'US'

# Some vessels have photos
myvessel.photos
# ["//img1.fleetmon.com/thumbnails/MINNOW_1.220x146.jpg", "//img1.fleetmon.com/thumbnails/MINNOW_2.570x1140.jpg"]

最小列表的Vessel属性

coords (lat, lon), course, destination, draught, etatime, flag, heading, imo, last_port, latitude, location, longitude, mmsi, name, navigationstatus, photos, positionreceived, publicurl, speed, type

港口

my_vessel.last_port
# <fleetmonger.port.Port object>

port = my_vessel.last_port

port.name
# 'Honolulu, HI'

port.duration
# datetime.timedelta(...)

港口URL和船舶URL

将mmsi、imo或name传递给船舶方法。将locode或name传递给港口方法。

fm.vesselurl(name='MINNOW')

fm.porturl(locode='USLAX')

# Porturl also takes an optional country isocode parameter
fm.porturl(name='new', country='US')
# [<Newark (New York)>, <Newburgh>, <Newburyport>, <Newport (OR)>]

位置的天气

fm.weather(lat=3.469557, lon=-167.255859)

# You can also pass a vessel object to the weather call
fm.weather(vessel=my_vessel)

参数

通常,Fleetmonger期望的参数与Fleetmon API的参数相匹配,以下除外

instead of mmsinumber, use mmsi
...        imonumber   ... imo
...        q           ... name

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪一个,请了解更多关于安装包的信息。

源代码分发

fleetmonger-0.0.4.tar.gz (5.8 kB 查看哈希值)

上传时间 源代码

构建分发

fleetmonger-0.0.4-py3-none-any.whl (9.0 kB 查看哈希值)

上传时间 Python 3

fleetmonger-0.0.4-py2-none-any.whl (9.0 kB 查看哈希值)

上传时间 Python 2