「坐标物体字符串」介绍
:「诸彼特坐标物体字符串」是一种表述坐标轴上物体信息的格式。
目前在二维空间中定义了 Marker、InfoWindow、Polyline、Line、Polygon、Triangle、Rectangle 与 Circle 等八种物体的字符串表述格式,并且提供了物体绘制(DrawingManager)与呈现函式库,藉由使用函式库中的 JavaScript API,可以在网页中轻易地绘制各个物体并且编码产生出相对应的「诸彼特坐标物体字符串」;也可以轻易地将手上的「诸彼特坐标物体字符串」透过函式库功能将字符串译码,让字符串所要表述的坐标上之各物体重新呈现出来。
目前所支持的二维空间平台有: Google 地图 和 HTML 5 二维画布 (Canvas)。
换句话说,要在 地图/画布 上产生出各物体,可以:
- 用 API 在页面中产生 DrawingManager,以所见即所得的方式实时绘制各物体;或
- 用各物体对应的 API 在 地图/画布 上以 JavaScript 程序绘制各物体。
「诸彼特坐标物体字符串」格式概观
上图呈现出「诸彼特坐标物体字符串」格式的概观,由图可知「诸彼特坐标物体字符串」是由一个或多个「设定」或「物体」的次级字符串表述格式所构成;「设定」或「物体」则是再由「设定或物体代码」加上一个或多个再次级的「属性」字符串表述格式所构成。
「地图/画布设定」 以及「各物体」的字符串表述格式
:- 「地图/画布设定」之字符串表述格式
- Map/Canvas Center (地图/画布中心点)
- Zoom (缩放等级)
- 「各物体」之字符串表述格式
- Marker (标记)
- InfoWindow (信息窗口)
- Polyline (多线段) (或, 中空多边形)
- Line (线)
- Polygon (多边形)
- Triangle (等腰三角形)
- Rectangle (矩形)
- Circle (圆形)
格式:
o,Y-轴坐标,X-轴坐标
地图示例: o,24.88065,121.065427
画布示例: o,109.72328593151204,214.0909703111111
格式:
z,缩放等级数字
示例: z,16
格式:
m,Y-轴坐标,X-轴坐标 [,标题字数,标题]
其中:
中括号 [] 内的属性是选项字段,可以不给予。
「标题」有设定时则须为 urlencode 之后的字符串。
地图示例: m,24.88065,121.065427
画布示例: m,109.72328593151204,214.0909703111111
格式:
i,Y-轴坐标,X-轴坐标,保留,保留,窗口开启状态,讯息字数,讯息 [,标题字数,标题]
其中:
中括号 [] 内的属性是选项字段,可以不给予。
「保留」字段请填数值 0 。
「窗口开启状态」 = 1 表示信息窗口呈现开启状态;「窗口开启状态」 = 0 则反之。
「讯息」为 urlencode 之后的字符串。
「标题」有设定时则须为 urlencode 之后的字符串。
地图示例: i,24.8768105,121.05556490000004,0,0,1,16,HuKou%20Old%20Street
画布示例: i,121.72328593151204,185.0909703111111,0,0,1,16,HuKou%20Old%20Street
格式:
e,线条粗细,线条颜色,线条透明度,线段数,Y-轴坐标1,X-轴坐标1,Y-轴坐标2,X-轴坐标2,...,Y-轴坐标N,X-轴坐标N
「线」是「多线段」中的一种特化物体,是一个仅具有两个端点的线段。如果在 Google 地图上的「线」被拉成超过两个端点时,则产生出的「诸彼特坐标物体字符串」会变成以「多线段」名义来表述该物件。
格式:
l,线条粗细,线条颜色,线条透明度,Y-轴坐标1,X-轴坐标1,Y-轴坐标2,X-轴坐标2
地图示例: l,8,ef1568,0.8,24.87673271183448,121.05517387390137,24.90289078044739,121.04405879974365
画布示例: l,8,ef1568,0.8,121.72328593151204,184.0909703111111,37.72328593151204,151.0909703111111
格式:
g,线条粗细,线条颜色,线条透明度,填满颜色,填满透明度,边段数,Y-轴坐标1,X-轴坐标1,Y-轴坐标2,X-轴坐标2,...,Y-轴坐标N,X-轴坐标N
「等腰三角形」是「多边形」中的一种特化物体,当然也可以用「多边形」物体画出「三角形」。如果在 Google 地图上的「等腰三角形」被拉成超过三个端点或是变成不是等腰三角形时,则产生出的「诸彼特坐标物体字符串」会变成以「多边形」名义来表述该物件。
格式:
a,线条粗细,线条颜色,线条透明度,填满颜色,填满透明度,Y-轴坐标1,X-轴坐标1,Y-轴坐标2,X-轴坐标2,Y-轴坐标3,X-轴坐标3
格式:
r,线条粗细,线条颜色,线条透明度,填满颜色,填满透明度,西南角Y-轴坐标,西南角X-轴坐标,东北角Y-轴坐标,东北角X-轴坐标
地图示例: r,2,ef1568,1,61ed04,0.3,24.88227086962545,121.05922937393188,24.883789196412685,121.06319904327393
画布示例: r,2,ef1568,1,61ed04,0.3,67.72328593151204,70.0909703111111,28.723285931512038,162.0909703111111
格式:
c,Y-轴坐标,X-轴坐标,半径
地图示例: c,2,ef1568,1,61ed04,0.3,24.902922352868245,121.0441019087184,733.1808524466962
画布示例: c,2,ef1568,1,61ed04,0.3,37.72328593151204,152.0909703111111,21
从上面示例可知,同一个设定或物体中,物体代码、各属性是以「,」逗号做区隔。
- 多个「设定」及「物体」串在同一个「诸彼特坐标物体字符串」
- 设定或物体处理顺序 (Ordering)
- 「设定」的 "后令压前令"
- 「物体」呈现的迭层
将多个「地图/画布设定」及多个「物体」串在同一个「诸彼特坐标物体字符串」,是以「&」符号做区隔,其格式如下:
设定或物体1&设定或物体2&...&设定或物体N
「诸彼特坐标物体字符串」的译码是从字符串的左到右处理各「设定」或「物体」。
特意将相同「设定」(亦即具相同「设定代码」的「设定」)放在同一个「诸彼特坐标物体字符串」中,其执行设定效果会有 "后令压前令" 的结果,亦即: 在右边的 "后令" 设定会压过在左边的 "前令" 设定。
「物体」在「诸彼特坐标物体字符串」中的顺序对应各物体于呈现时的迭层顺序。在字符串越左边的「物体」会呈现于迭层的越下方;在字符串越右边的「物体」会呈现于迭层的越上方,
特别属性说明
- Y-轴坐标:在「Google 地图」模式下指的是 GPS 纬度坐标;在「HTML 5 二维画布」模式下则是 Y-轴坐标,且往下是 "正加" 往上是 "负减" 状态 (同于 HTML5 Canvas 设定)。
- X-轴坐标:在「Google 地图」模式下指的是 GPS 经度坐标;在「HTML 5 二维画布」模式下则是 x-轴坐标。
- 「窗口开启状态」:1 表示信息窗口呈现开启状态;0 则反之。
- 「标题」或「讯息」:是 urlencode 之后的字符串。
- 「线条粗细」:为数字数值,单位是像素(pixel, px) 数。
- 「线条颜色」或「填满颜色」:为六个 16 进位的数值组成,最前面没有「#」符号。每两个一组分别表示 R、G、B 三原色。
- 「线条透明度」或「填满透明度」:为 0.0 ~ 1.0 之间的浮点数值。
格式简表
码 | 设定/物体 (具 API 连结) | 格式 |
---|---|---|
o | Map/Canvas Center (地图/画布中心点) | o,Y-轴坐标,X-轴坐标 |
z | Zoom (缩放等级) | z,缩放等级数字 |
m | Marker (标记) | m,Y-轴坐标,X-轴坐标 [,标题字数,标题] |
i | InfoWindow (信息窗口) | i,Y-轴坐标,X-轴坐标,保留,保留,窗口开启状态,讯息字数,讯息 [,标题字数,标题] |
e | Polyline (多线段) (或, 中空多边形) | e,线条粗细,线条颜色,线条透明度,线段数,Y-轴坐标1,X-轴坐标1,Y-轴坐标2,X-轴坐标2,...,Y-轴坐标N,X-轴坐标N |
l | Line (线) | l,线条粗细,线条颜色,线条透明度,Y-轴坐标1,X-轴坐标1,Y-轴坐标2,X-轴坐标2 |
g | Polygon (多边形) | g,线条粗细,线条颜色,线条透明度,填满颜色,填满透明度,边段数,Y-轴坐标1,X-轴坐标1,Y-轴坐标2,X-轴坐标2,...,Y-轴坐标N,X-轴坐标N |
a | Triangle (等腰三角形) | a,线条粗细,线条颜色,线条透明度,填满颜色,填满透明度,Y-轴坐标1,X-轴坐标1,Y-轴坐标2,X-轴坐标2,Y-轴坐标3,X-轴坐标3 |
r | Rectangle (矩形) | r,线条粗细,线条颜色,线条透明度,填满颜色,填满透明度,西南角Y-轴坐标,西南角X-轴坐标,东北角Y-轴坐标,东北角X-轴坐标 |
c | Circle (圆形) | c,Y-轴坐标,X-轴坐标,半径 |
坐标物语 | 赞助比特币: 1LX5KC19tXCPK8y72Z6LVoZjoSaCp9P6K