「坐标物体字符串」介绍

:

「诸彼特坐标物体字符串」是一种表述坐标轴上物体信息的格式。

目前在二维空间中定义了 Marker、InfoWindow、Polyline、Line、Polygon、Triangle、Rectangle 与 Circle 等八种物体的字符串表述格式，并且提供了物体绘制(DrawingManager)与呈现函式库，藉由使用函式库中的 JavaScript API，可以在网页中轻易地绘制各个物体并且编码产生出相对应的「诸彼特坐标物体字符串」；也可以轻易地将手上的「诸彼特坐标物体字符串」透过函式库功能将字符串译码，让字符串所要表述的坐标上之各物体重新呈现出来。

目前所支持的二维空间平台有： Google 地图 和 HTML 5 二维画布 (Canvas)。

换句话说，要在 地图/画布 上产生出各物体，可以:

  • 用 API 在页面中产生 DrawingManager，以所见即所得的方式实时绘制各物体；或
  • 用各物体对应的 API 在 地图/画布 上以 JavaScript 程序绘制各物体。
然后，透过呼叫函式库之 地图/画布 的 getCostring() 函式产生「诸彼特坐标物体字符串」；或呼叫 setCostring() 函式将「诸彼特坐标物体字符串」译码后呈现到 地图/画布 上。

  • 「诸彼特坐标物体字符串」格式概观

    • 诸彼特坐标物体字符串格式概观

    上图呈现出「诸彼特坐标物体字符串」格式的概观，由图可知「诸彼特坐标物体字符串」是由一个或多个「设定」或「物体」的次级字符串表述格式所构成；「设定」或「物体」则是再由「设定或物体代码」加上一个或多个再次级的「属性」字符串表述格式所构成。

以下分别介绍

「地图/画布设定」 以及「各物体」的字符串表述格式

：

从上面示例可知，同一个设定或物体中，物体代码、各属性是以「,」逗号做区隔。

  • 多个「设定」及「物体」串在同一个「诸彼特坐标物体字符串」

    • 将多个「地图/画布设定」及多个「物体」串在同一个「诸彼特坐标物体字符串」，是以「&」符号做区隔，其格式如下：

    设定或物体1&设定或物体2&...&设定或物体N

    地图示例: o,24.88065,121.065427&z,12&c,2,ef1568,1,61ed04,0.3,24.902922352868245,121.0441019087184,733.1808524466962

    画布示例: o,109.72328593151204,214.0909703111111&z,12&c,2,ef1568,1,61ed04,0.3,37.72328593151204,152.0909703111111,21

  • 设定或物体处理顺序 (Ordering)

    • 「诸彼特坐标物体字符串」的译码是从字符串的左到右处理各「设定」或「物体」。

    • 「设定」的 "后令压前令"

      • 特意将相同「设定」(亦即具相同「设定代码」的「设定」)放在同一个「诸彼特坐标物体字符串」中，其执行设定效果会有 "后令压前令" 的结果，亦即: 在右边的 "后令" 设定会压过在左边的 "前令" 设定。

    • 「物体」呈现的迭层

      • 「物体」在「诸彼特坐标物体字符串」中的顺序对应各物体于呈现时的迭层顺序。在字符串越左边的「物体」会呈现于迭层的越下方；在字符串越右边的「物体」会呈现于迭层的越上方，

  • 特别属性说明

    • 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 连结)格式
    oMap/Canvas Center (地图/画布中心点)o,Y-轴坐标,X-轴坐标
    zZoom (缩放等级)z,缩放等级数字
    mMarker (标记)m,Y-轴坐标,X-轴坐标 [,标题字数,标题]
    iInfoWindow (信息窗口)i,Y-轴坐标,X-轴坐标,保留,保留,窗口开启状态,讯息字数,讯息 [,标题字数,标题]
    ePolyline (多线段) (或, 中空多边形)e,线条粗细,线条颜色,线条透明度,线段数,Y-轴坐标1,X-轴坐标1,Y-轴坐标2,X-轴坐标2,...,Y-轴坐标N,X-轴坐标N
    lLine (线)l,线条粗细,线条颜色,线条透明度,Y-轴坐标1,X-轴坐标1,Y-轴坐标2,X-轴坐标2
    gPolygon (多边形)g,线条粗细,线条颜色,线条透明度,填满颜色,填满透明度,边段数,Y-轴坐标1,X-轴坐标1,Y-轴坐标2,X-轴坐标2,...,Y-轴坐标N,X-轴坐标N
    aTriangle (等腰三角形)a,线条粗细,线条颜色,线条透明度,填满颜色,填满透明度,Y-轴坐标1,X-轴坐标1,Y-轴坐标2,X-轴坐标2,Y-轴坐标3,X-轴坐标3
    rRectangle (矩形)r,线条粗细,线条颜色,线条透明度,填满颜色,填满透明度,西南角Y-轴坐标,西南角X-轴坐标,东北角Y-轴坐标,东北角X-轴坐标
    cCircle (圆形)c,Y-轴坐标,X-轴坐标,半径
facebook twitter plurk

坐标物语 | 赞助比特币: 1LX5KC19tXCPK8y72Z6LVoZjoSaCp9P6K