A classe GeoPoint representa um ponto na superfície da Terra representado por coordenadas de latitude e longitude.
GeoPoint é definido no módulo google.appengine.api.search.
Introdução
A classe GeoPoint permite que tornar locais no mapa pesquisáveis. Você começa instanciando a classe GeoPoint e depois passa esse objeto para um campo de documento específico:
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)
]
Saiba mais sobre como realizar pesquisas com base em localização em Queries on geopoint fields.
Construtor
O construtor da classe GeoPoint é definido da seguinte maneira:
-
GeoPoint(latitude, longitude)
Um ponto na superfície da Terra representado por coordenadas de latitude e longitude.
Argumentos
- latitude
O ângulo entre o plano equatorial e uma linha que passa pelo GeoPoint, entre -90 e 90 graus.
- longitude
O ângulo leste ou oeste de um meridiano de referência para outro que passa pelo GeoPoint, entre -180 e 180 graus.
Exceções
- TypeError
Qualquer um dos parâmetros tem um tipo inválido ou um atributo desconhecido foi passado.
- ValueError
Um valor inválido foi passado para um dos parâmetros.
Propriedades
Uma instância da classe GeoPoint tem as seguintes propriedades:
- latitude
Uma distância angular, em graus, partindo da linha do equador. Pontos localizados ao sul do equador têm valores negativos, enquanto os pontos localizados ao norte dele têm valores positivos.
- longitude
Uma distância angular, em graus, partindo do meridiano principal. Pontos localizados a oeste do meridiano principal têm valores positivos, enquanto os pontos localizados a leste dele têm valores negativos.