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({lat: -34, lng: 151}, null, true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151));
new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151), null, true);

v=beta를 사용하는 경우 const {LatLng} = await google.map.importLibrary("core")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
매개변수:
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap: number|boolean optional
  • noClampNoWrapboolean optional
지리적 지점을 나타내는 LatLng 객체를 만듭니다. 위도는 [-90, 90] 범위에서 도 단위로 지정됩니다. 경도는 [-180, 180] 범위에서 도 단위로 지정됩니다. 이 범위를 벗어난 값을 사용 설정하려면 noClampNoWraptrue로 설정합니다. 위도와 경도의 순서를 기록합니다.
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 객체 대신 허용됩니다. 지도 API에서 이러한 객체를 발견하면 LatLng 객체로 변환됩니다.

예:

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

도형 라이브러리에서 LatLng 객체 리터럴이 지원되지 않습니다.

lat
유형: number
위도입니다. 값은 [-90, 90] 범위로 고정됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
lng
유형: number
경도입니다. [-180, 180] 범위를 벗어나는 값은 범위 내에 속하도록 잘립니다. 예를 들어 -190은 170으로 변환됩니다. 190은 -170으로 변환됩니다. 이는 경도가 지구 둘레에서 래핑된다는 사실을 반영합니다.

LatLngBounds 클래스

google.maps.LatLngBounds 클래스

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

v=beta를 사용하는 경우 const {LatLngBounds} = await google.map.importLibrary("core")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
매개변수:
남서쪽과 북동쪽 모서리 지점에서 직사각형을 생성합니다.
contains
contains(latLng)
매개변수:
반환 값: boolean
지정된 lat/lng가 이 경계에 있으면 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()
매개변수: 없음
JSON 표현으로 변환합니다. 이 함수는 JSON.stringify를 통해 사용하기 위한 것입니다.
toSpan
toSpan()
매개변수: 없음
반환 값: LatLng
지정된 지도 경계를 lat/lng 범위로 변환합니다.
toString
toString()
매개변수: 없음
반환 값: string
문자열로 변환합니다.
toUrlValue
toUrlValue([precision])
매개변수:
  • precisionnumber optional
반환 값: string
이 경계에 대해 'lat_lo,lng_lo,lat_hi,lng_hi' 형식의 문자열을 반환합니다. 여기에서 'lo'는 경계 상자의 남서쪽에 해당하고 'hi'는 경계 상자의 북동쪽에 해당합니다.
union
union(other)
매개변수:
반환 값: LatLngBounds
이 범위와 지정된 경계의 합집합이 포함되도록 이 경계를 확장합니다.
MAX_BOUNDS 지구의 최대 경계에 대한 LatLngBounds 이러한 경계는 전체 지구를 포함합니다.

LatLngBoundsLiteral 인터페이스

google.maps.LatLngBoundsLiteral 인터페이스

객체 리터럴은 API 전체에서 LatLngBounds 객체 대신 허용됩니다. 이는 LatLngBounds 객체로 자동 변환됩니다. 모든 south, west, northeast를 설정해야 합니다. 그렇지 않으면 예외가 발생합니다.

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를 구현합니다.

v=beta를 사용하는 경우 const {LatLngAltitude} = await google.map.importLibrary("core")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
매개변수:
  • value: LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral 초기화 값입니다.
  • noClampNoWrapboolean 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 객체 대신 허용됩니다. 지도 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 클래스

v=beta를 사용하는 경우 const {Point} = await google.map.importLibrary("core")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

Point
Point(x, y)
매개변수:
  • x: number
  • ynumber
2차원 평면의 한 점입니다.
x
유형: number
X 좌표
y
유형: number
Y 좌표
equals
equals(other)
매개변수:
반환 값: boolean
두 Point를 비교합니다.
toString
toString()
매개변수: 없음
반환 값: string
이 Point의 문자열 표현을 반환합니다.

Size 클래스

google.maps.Size 클래스

v=beta를 사용하는 경우 const {Size} = await google.map.importLibrary("core")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

Size
Size(width, height[, widthUnit, heightUnit])
매개변수:
  • widthnumber
  • heightnumber
  • 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