Module: ol/proj

函数s

addCoordinateTransforms(source, destination, forward, inverse)

proj.js, line 413

import {addCoordinateTransforms} from 'ol/proj';

注册坐标变换函数，用于在源投影和目标投影之间转换坐标。正向和反向函数转换单个坐标对；此函数将这些转换为内部使用的函数，后者还处理范围和坐标数组。

Name	Type	Description
source	ProjectionLike	源投影。
destination	ProjectionLike	目标投影。
forward	function	正向变换函数（即从源投影到目标投影），接受 Coordinate 作为参数并返回变换后的 Coordinate。
inverse	function	反向变换函数（即从目标投影到源投影），接受 Coordinate 作为参数并返回变换后的 Coordinate。如果变换函数只能变换比输入坐标更少的维度，它应返回仅包含可变换长度的坐标。其他维度将从源中取不变。

addEquivalentProjections(projections)

proj.js, line 297

import {addEquivalentProjections} from 'ol/proj';

注册不改变坐标的变换函数。这些函数允许在含义相同的投影之间进行变换。

Name	Type	Description
projections	Array<Projection>	投影。

addProjection(projection)

proj.js, line 177

import {addProjection} from 'ol/proj';

将 Projection 对象添加到支持的可按其代码查找的投影列表中。

Name	Type	Description
projection	Projection	投影实例。

clearUserProjection()

proj.js, line 677

import {clearUserProjection} from 'ol/proj';

清除已设置的用户投影。

equivalent(projection1, projection2){boolean}

proj.js, line 478

import {equivalent} from 'ol/proj';

检查两个投影是否相同，即一个投影中的每个坐标是否与另一个投影中的相同坐标表示相同的地理点。

Name	Type	Description
projection1	Projection	投影 1。
projection2	Projection	投影 2。

返回值：

Equivalent.

fromLonLat(coordinate, projection){Coordinate}

proj.js, line 437

import {fromLonLat} from 'ol/proj';

将坐标从经纬度转换为其他投影。

Name	Type	Description
coordinate	Coordinate	经纬度坐标，即以经度为第一个元素、纬度为第二个元素的数组。
projection	ProjectionLike | undefined	目标投影。默认为 Web Mercator，即 'EPSG:3857'。

返回值：

Coordinate projected to the target projection.

get(projectionLike){Projection | null}

proj.js, line 198

import {get} from 'ol/proj';

获取指定代码的 Projection 对象。

Name	Type	Description
projectionLike	ProjectionLike	代码字符串（如 "EPSG:4326"，为授权机构和标识符的组合）、现有投影对象或 undefined。

返回值：

Projection object, or null if not in list.

getPointResolution(projection, resolution, point, units){number}

proj.js, line 235

import {getPointResolution} from 'ol/proj';

获取以度或距离单位表示的点的分辨率。 对于以度为单位的投影，这将直接返回提供的分辨率。对于其他投影，点的分辨率默认通过将 point 像素转换到 EPSG:4326， 测量其在标准球体上的宽度和高度， 并取宽度和高度的平均值来估算。 可以为特定投影提供自定义函数，可以通过在 Projection 构造函数中设置 getPointResolution 选项，或使用 setGetPointResolution 更改现有 投影对象。

Name	Type	Description
projection	ProjectionLike	投影。
resolution	number	以投影单位表示的标称分辨率。
point	Coordinate	要查找调整后分辨率的点。
units	Units | undefined	获取点分辨率的单位。默认为投影的单位。

返回值：

Point resolution.

getTransform(source, destination){Transform函数}

proj.js, line 586

import {getTransform} from 'ol/proj';

给定类投影对象，搜索将坐标数组从源投影转换到目标投影的变换函数。

Name	Type	Description
source	ProjectionLike	数据源。
destination	ProjectionLike	目标。

返回值：

Transform function.

getUserProjection(){Projection | null}

proj.js, line 686

import {getUserProjection} from 'ol/proj';

获取 API 方法接收和返回坐标所使用的投影。

返回值：

The user projection (or null if not set).

setUserProjection(projection)

proj.js, line 669

import {setUserProjection} from 'ol/proj';

设置 API 方法接收和返回坐标所使用的投影。这包括所有 API 方法，除了与瓦片网格交互的方法，以及 FrameState 和 State。

Name	Type	Description
projection	ProjectionLike	用户投影。

toLonLat(coordinate, projection){Coordinate}

proj.js, line 455

import {toLonLat} from 'ol/proj';

将坐标转换为经纬度。

Name	Type	Description
coordinate	Coordinate	投影坐标。
projection	ProjectionLike | undefined	坐标的投影。默认为 Web Mercator，即 'EPSG:3857'。

返回值：

Coordinate as longitude and latitude, i.e. an array with longitude as 1st and latitude as 2nd element.

transform(coordinate, source, destination){Coordinate}

proj.js, line 608

import {transform} from 'ol/proj';

将坐标从源投影转换为目标投影。这返回一个新坐标（不修改原始坐标）。如果两个投影之间没有可用的变换，函数将抛出错误。

范围变换参见 transformExtent。几何图形变换参见 Geometry 及其子类的 transform 方法。

Name	Type	Description
coordinate	Coordinate	坐标。
source	ProjectionLike	源类投影。
destination	ProjectionLike	目标类投影。

返回值：

坐标。

transformExtent(extent, source, destination, stops){Extent}

proj.js, line 632

import {transformExtent} from 'ol/proj';

将范围从源投影转换为目标投影。这返回一个新范围（不修改原始范围）。

Name	Type	Description
extent	Extent	要变换的范围。
source	ProjectionLike	源类投影。
destination	ProjectionLike	目标类投影。
stops	number | undefined	变换每边使用的停靠点数。默认仅使用角点。

返回值：

The transformed extent.

useGeographic()

proj.js, line 696

import {useGeographic} from 'ol/proj';

在 API 方法中使用地理坐标（WGS-84 基准）。这包括除与瓦片网格交互的方法之外的所有 API 方法，以及 FrameState 和 State。

Type Definitions

ProjectionLike{Projection} {string} {undefined}

Projection 形式的投影、SRS 标识符字符串或 undefined。

Transform函数(input, output, dimension, stride){Array.<number>}

proj.js, line 107

变换函数接受输入坐标值数组、可选的输出数组和可选的维度（默认应为 2）。该函数变换输入坐标值，填充输出数组，并返回输出数组。

Name	Type	Description
input	Array.<number>
output	Array.<number> | undefined
dimension	number | undefined
stride	number | undefined

Transforms{Object}

Properties:

Name	Type	Description
forward	Transform函数	正向变换（从地理坐标）。
inverse	Transform函数	反向变换（到地理坐标）。