Coordinates

LatLng 클래스

google.maps.LatLng 클래스

LatLng는 지리 좌표(위도 및 경도)의 한 지점입니다.

  • 위도는 -90도 이상 90도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 [-90, 90]으로 고정됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
  • 경도는 -180도 이상 180도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 감싸는 사실을 반영합니다.
기본 지도 투영법은 경도를 지도의 x 좌표와 연결하고 위도를 y 좌표와 연결하지만 위도 좌표는 항상 먼저 작성되고 그 뒤에 경도가 작성됩니다.
LatLng의 좌표는 수정할 수 없습니다. 다른 지점을 계산하려면 새 지점을 만들어야 합니다.

LatLng 객체를 허용하는 대부분의 메서드는 LatLngLiteral 객체도 허용하므로 다음은 동일합니다. 

 map.setCenter(new google.maps.LatLng(-34, 151));
 map.setCenter({lat: -34, lng: 151});

생성자는 LatLngLiteral 및 LatLng 객체도 허용합니다. LatLng 인스턴스가 생성자에 전달되면 사본이 생성됩니다.

생성자에 대한 가능한 호출은 다음과 같습니다. 

 new google.maps.LatLng(-34, 151);
 new google.maps.LatLng(-34, 151, true);
 new google.maps.LatLng({lat: -34, lng: 151});
 new google.maps.LatLng({lat: -34, lng: 151}, true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);

const {LatLng} = await google.maps.importLibrary("core")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
매개변수: 
  • latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap:  number|boolean optional
  • noClampNoWrap:  boolean optional
지리적 점을 나타내는 LatLng 객체를 만듭니다. 위도는 [-90, 90] 범위 내에서 도 단위로 지정됩니다. 경도는 [-180, 180) 범위 내의 도 단위로 지정됩니다. 이 범위를 벗어난 값을 사용 설정하려면 noClampNoWrap을 true로 설정하세요. 위도와 경도의 순서를 확인합니다.
equals
equals(other)
매개변수: 
반환 값:  boolean
비교 함수입니다.
lat
lat()
매개변수:  없음
반환 값:  number
위도(도)를 반환합니다.
lng
lng()
매개변수:  없음
반환 값:  number
경도(도)를 반환합니다.
toJSON
toJSON()
매개변수:  없음
반환 값:  LatLngLiteral
JSON 표현으로 변환합니다. 이 함수는 JSON.stringify를 통해 사용하도록 설계되었습니다.
toString
toString()
매개변수:  없음
반환 값:  string
문자열 표현으로 변환합니다.
toUrlValue
toUrlValue([precision])
매개변수: 
  • precision:  number optional
반환 값:  string
이 LatLng에 대한 'lat,lng' 형식의 문자열을 반환합니다. 기본적으로 lat/lng 값을 소수점 6자리로 반올림합니다.

LatLngLiteral 인터페이스

google.maps.LatLngLiteral 인터페이스

객체 리터럴은 편의를 위해 여러 곳에서 LatLng 객체 대신 허용됩니다. 이러한 객체는 Maps API에서 발견되면 LatLng 객체로 변환됩니다.

예: 

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map});

LatLng 객체 리터럴은 Geometry 라이브러리에서 지원되지 않습니다.
lat
유형:  number
위도(도)입니다. 값은 [-90, 90] 범위로 제한됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
lng
유형:  number
경도입니다. 범위 [-180, 180] 을 벗어나는 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 감싸는 사실을 반영합니다.

LatLngBounds 클래스

google.maps.LatLngBounds 클래스

LatLngBounds 인스턴스는 180도 경도 자오선을 교차하는 인스턴스를 포함하여 지리적 좌표의 직사각형을 나타냅니다.

const {LatLngBounds} = await google.maps.importLibrary("core")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
매개변수: 
남서쪽과 북동쪽 모서리 지점에서 직사각형을 생성합니다.
MAX_BOUNDS 지구의 최대 경계에 대한 LatLngBounds입니다. 이 경계는 전 세계를 포함합니다.
contains
contains(latLng)
매개변수: 
반환 값:  boolean
지정된 위도/경도가 이 경계에 있으면 true를 반환합니다.
equals
equals(other)
매개변수: 
반환 값:  boolean
이 경계가 지정된 경계와 대략적으로 같으면 true를 반환합니다.
extend
extend(point)
매개변수: 
반환 값:  LatLngBounds
지정된 점이 포함되도록 이 경계를 확장합니다.
getCenter
getCenter()
매개변수:  없음
반환 값:  LatLng
이 LatLngBounds의 중심을 계산합니다.
getNorthEast
getNorthEast()
매개변수:  없음
반환 값:  LatLng
이 경계의 북동쪽 모서리를 반환합니다.
getSouthWest
getSouthWest()
매개변수:  없음
반환 값:  LatLng
이 경계의 남서쪽 모서리를 반환합니다.
intersects
intersects(other)
매개변수: 
반환 값:  boolean
이 경계가 다른 경계와 점을 공유하면 true를 반환합니다.
isEmpty
isEmpty()
매개변수:  없음
반환 값:  boolean
경계가 비어 있는지 여부를 반환됩니다.
toJSON
toJSON()
매개변수:  없음
반환 값:  LatLngBoundsLiteral
JSON 표현으로 변환합니다. 이 함수는 JSON.stringify를 통해 사용하도록 설계되었습니다.
toSpan
toSpan()
매개변수:  없음
반환 값:  LatLng
지정된 지도 경계를 lat/lng 범위로 변환합니다.
toString
toString()
매개변수:  없음
반환 값:  string
문자열로 변환합니다.
toUrlValue
toUrlValue([precision])
매개변수: 
  • precision:  number optional
반환 값:  string
이 경계의 'lat_lo,lng_lo,lat_hi,lng_hi' 형식의 문자열을 반환합니다. 여기서 'lo'는 경계 상자의 남서쪽 모서리에 해당하고 'hi'는 해당 상자의 북동쪽 모서리에 해당합니다.
union
union(other)
매개변수: 
반환 값:  LatLngBounds
이 범위와 지정된 경계의 합집합이 포함되도록 이 경계를 확장합니다.

LatLngBoundsLiteral 인터페이스

google.maps.LatLngBoundsLiteral 인터페이스

객체 리터럴은 API 전체에서 LatLngBounds 객체 대신 허용됩니다. 이러한 값은 LatLngBounds 객체로 자동 변환됩니다. 모든 south, west, north, east가 설정되어야 합니다. 그렇지 않으면 예외가 발생합니다.
east
유형:  number
동쪽 경도(도)입니다. [-180, 180] 범위를 벗어나는 값은 [-180, 180) 범위로 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 감싸는 사실을 반영합니다.
north
유형:  number
북위(도)입니다. 값은 [-90, 90] 범위로 제한됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
south
유형:  number
남위(도)입니다. 값은 [-90, 90] 범위로 제한됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
west
유형:  number
서경(도)입니다. [-180, 180] 범위를 벗어나는 값은 [-180, 180) 범위로 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 감싸는 사실을 반영합니다.

LatLngAltitude 클래스

google.maps.LatLngAltitude 클래스

LatLngAltitude는 지리 좌표(위도, 경도, 고도)의 3D 지점입니다.

  • 위도는 -90도 이상 90도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 [-90, 90]으로 고정됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
  • 경도는 -180도 이상 180도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 감싸는 사실을 반영합니다.
  • 고도는 미터 단위로 측정됩니다. 양수 값은 지상 높이를 나타내고 음수 값은 지표면 아래 높이를 나타냅니다.

이 클래스는 LatLngAltitudeLiteral를 구현합니다.

이 클래스는 LatLngLiteral를 구현합니다.

const {LatLngAltitude} = await google.maps.importLibrary("core")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
매개변수: 
  • value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral 초기화 값입니다.
  • noClampNoWrap:  boolean optional 초기화 값이 [-90, 90] 범위의 유효한 위도 값이나 [-180, 180] 범위의 유효한 경도 값이 아니더라도 유지할지 여부입니다. 기본값은 false이며, 이 경우 위도 클램핑과 경도 래핑이 사용 설정됩니다.
altitude
유형:  number
고도를 반환합니다.
lat
유형:  number
위도를 반환합니다.
lng
유형:  number
경도를 반환합니다.
equals
equals(other)
매개변수: 
  • other:  LatLngAltitude optional 또 다른 LatLngAltitude 객체입니다.
반환 값:  boolean 두 객체가 동일한지 여부입니다.
비교 함수입니다.
toJSON
toJSON()
매개변수:  없음
반환 값:  LatLngAltitudeLiteral 이 객체의 JSON 표현입니다.

LatLngAltitudeLiteral 인터페이스

google.maps.LatLngAltitudeLiteral 인터페이스

객체 리터럴은 편의를 위해 여러 곳에서 LatLngAltitude 객체 대신 허용됩니다. 이러한 객체는 Maps API에서 발견되면 LatLngAltitude 객체로 변환됩니다.

이 인터페이스는 LatLngLiteral를 확장합니다.

altitude
유형:  number
기본값: 0
지면 위 거리 (미터)입니다. 음수 값은 지표면 아래를 의미합니다.
lat
유형:  number
위도(도)입니다. 값은 [-90, 90] 범위로 제한됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
lng
유형:  number
경도입니다. 범위 [-180, 180] 을 벗어나는 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 감싸는 사실을 반영합니다.

Point 클래스

google.maps.Point 클래스

const {Point} = await google.maps.importLibrary("core")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
Point
Point(x, y)
매개변수: 
  • x:  number
  • y:  number
2차원 평면의 점입니다.
x
유형:  number
X 좌표
y
유형:  number
Y 좌표
equals
equals(other)
매개변수: 
  • other:  Point optional
반환 값:  boolean
두 Point를 비교합니다.
toString
toString()
매개변수:  없음
반환 값:  string
이 Point의 문자열 표현을 반환합니다.

Size 클래스

google.maps.Size 클래스

const {Size} = await google.maps.importLibrary("core")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
Size
Size(width, height[, widthUnit, heightUnit])
매개변수: 
  • width:  number
  • height:  number
  • widthUnit:  string optional
  • heightUnit:  string optional
2차원 크기입니다. 너비는 x축의 거리이고 높이는 y축의 거리입니다.
height
유형:  number
Y축의 높이입니다(픽셀 단위).
width
유형:  number
X축의 너비입니다(픽셀 단위).
equals
equals(other)
매개변수: 
반환 값:  boolean
두 Size를 비교합니다.
toString
toString()
매개변수:  없음
반환 값:  string
이 Size의 문자열 표현을 반환합니다.

패딩 인터페이스

google.maps.Padding 인터페이스

bottom optional
유형:  number optional
하단의 패딩(단위: 픽셀)입니다.
left optional
유형:  number optional
왼쪽 패딩(단위: 픽셀)입니다.
right optional
유형:  number optional
오른쪽 패딩(단위: 픽셀)입니다.
top optional
유형:  number optional
상단 패딩(단위: 픽셀)입니다.

CircleLiteral 인터페이스

google.maps.CircleLiteral 인터페이스

원을 나타내는 객체 리터럴입니다.

이 인터페이스는 CircleOptions를 확장합니다.

center
원의 중심입니다.
radius
유형:  number
지구 표면의 반경(미터)입니다.
상속됨: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex

Orientation3D 클래스

google.maps.Orientation3D 클래스

Orientation3D는 방향, 기울기, 롤을 따라 표준 수학적 회전 변환에 사용되는 3차원 벡터입니다.

  • heading은 [0, 360)도 범위의 각도입니다.
  • tilt는 [0, 360) 범위의 각도입니다.
  • 롤은 [0, 360)도 범위의 각도입니다.

이 클래스는 Orientation3DLiteral를 구현합니다.

const {Orientation3D} = await google.maps.importLibrary("core")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
Orientation3D
Orientation3D(value)
매개변수: 
heading
유형:  number
기본값: 0
z축 (지구 표면에 수직)을 기준으로 한 회전입니다. 0 (기본값)은 북쪽과 같습니다. 양의 회전은 z축을 기준으로 시계 방향이며 0~360도의 각도로 지정됩니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 530 값도 170으로 변환됩니다.
roll
유형:  number
기본값: 0
y축을 중심으로 한 회전입니다. 양수 회전은 y축을 기준으로 시계 방향이며 0~360도 범위로 지정됩니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 530 값도 170으로 변환됩니다.
tilt
유형:  number
기본값: 0
x축을 기준으로 한 회전입니다. 양의 회전은 x축을 중심으로 시계 방향으로 회전하며 0~360도의 각도로 지정됩니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 530 값도 170으로 변환됩니다.
equals
equals(other)
매개변수: 
반환 값:  boolean 두 객체가 동일한지 여부입니다.
비교 함수입니다.
toJSON
toJSON()
매개변수:  없음
반환 값:  Orientation3DLiteral
JSON 표현으로 변환합니다. 이 함수는 JSON.stringify를 통해 사용하기 위한 것입니다.

Orientation3DLiteral 인터페이스

google.maps.Orientation3DLiteral 인터페이스

객체 리터럴은 편의를 위해 여러 곳에서 Orientation3D 객체 대신 허용됩니다. 이러한 객체는 Maps API에서 발견되면 Orientation3D 객체로 변환됩니다.
heading optional
유형:  number optional
z축 (지구 표면에 수직)을 기준으로 한 회전입니다. 0 (기본값)은 북쪽과 같습니다. 양의 회전은 z축을 기준으로 시계 방향이며 0~360도의 각도로 지정됩니다.
roll optional
유형:  number optional
y축을 중심으로 한 회전입니다. 양수 회전은 y축을 기준으로 시계 방향이며 0~360도 범위로 지정됩니다.
tilt optional
유형:  number optional
x축을 기준으로 한 회전입니다. 양의 회전은 x축을 중심으로 시계 방향으로 회전하며 0~360도의 각도로 지정됩니다.

Vector3D 클래스

google.maps.Vector3D 클래스

Vector3D는 로컬 x, y, z축을 따라 3차원 객체의 경계를 조정하는 등의 표준 수학 연산에 사용되는 3차원 벡터입니다.

  • x는 실수입니다.
  • y는 실수입니다.
  • z는 실수입니다.

이 클래스는 Vector3DLiteral를 구현합니다.

const {Vector3D} = await google.maps.importLibrary("core")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
Vector3D
Vector3D(value)
매개변수: 
x
유형:  number
3차원 벡터의 X 구성요소입니다.
y
유형:  number
3차원 벡터의 Y 구성요소입니다.
z
유형:  number
3차원 벡터의 Z 구성요소입니다.
equals
equals(other)
매개변수: 
반환 값:  boolean
비교 함수입니다.
toJSON
toJSON()
매개변수:  없음
반환 값:  Vector3DLiteral
JSON 표현으로 변환합니다. 이 함수는 JSON.stringify를 통해 사용하기 위한 것입니다.

Vector3DLiteral 인터페이스

google.maps.Vector3DLiteral 인터페이스

객체 리터럴은 편의를 위해 여러 곳에서 Vector3D 객체 대신 허용됩니다. 이러한 객체는 Maps API에서 발견되면 Vector3D 객체로 변환됩니다.
x
유형:  number
3차원 벡터의 X 구성요소입니다.
y
유형:  number
3차원 벡터의 Y 구성요소입니다.
z
유형:  number
3차원 벡터의 Z 구성요소입니다.