GeoPoint 클래스는 지구 표면의 한 지점을 위도와 경도 좌표로 나타냅니다.
GeoPoint는 모듈 google.appengine.api.search에 정의됩니다.
소개
GeoPoint 클래스를 사용하여 맵 위치를 검색할 수 있도록 만들 수 있습니다. 먼저 GeoPoint 클래스를 인스턴스화한 다음 해당 객체를 특정 문서 필드에 전달합니다.
from google.appengine.api import search
...
# Construct the GeoPoint class
geopoint = search.GeoPoint(latitude, longitude)
fields = [search.TextField(name='name', value=store_name),
search.TextField(name='address', value=store_address),
# Construct a GeoField passing geopoint as the value of that field
search.GeoField(name='store_location', value=geopoint)
]
위치 기반 검색을 수행하는 방법에 대한 자세한 내용은 Queries on geopoint fields를 참조하세요.
생성자
GeoPoint 클래스의 생성자는 다음과 같이 정의됩니다.
-
GeoPoint(latitude, longitude)
위도와 경도 좌표로 나타나는 지구 표면의 한 지점입니다.
인수
- latitude
적도면과 GeoPoint를 통과하는 선이 이루는 각도(-90도 ~ 90도 사이)입니다.
- longitude
기준 자오선부터 GeoPoint를 통과하는 다른 자오선까지의 동쪽 또는 서쪽 각도(-180도 ~ 180도 사이)입니다.
예외
- TypeError
매개변수에 잘못된 유형이 있거나 알 수 없는 속성이 전달되었습니다.
- ValueError
매개변수 중 하나에 잘못된 값이 전달되었습니다.
속성
GeoPoint 클래스의 인스턴스에는 다음 속성이 있습니다.
- latitude
적도에서의 각도 거리(도)입니다. 적도 남쪽에 위치한 지점은 음수 값을 갖고 적도 북쪽에 위치한 지점은 양수 값을 갖습니다.
- longitude
본초자오선에서의 각도 거리(도)입니다. 본초자오선 서쪽에 위치한 지점은 양수 값을 갖고 본초자오선 동쪽에 위치한 지점은 음수 값을 갖습니다.