GeoPoint 클래스

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

본초자오선에서의 각도 거리(도)입니다. 본초자오선 서쪽에 위치한 지점은 양수 값을 갖고 본초자오선 동쪽에 위치한 지점은 음수 값을 갖습니다.