A classe GeoPoint representa um ponto na superfície da Terra representado por coordenadas de latitude e longitude.
GeoPoint está definido no módulo google.appengine.api.search.
Introdução
A classe GeoPoint permite-lhe tornar as localizações no mapa pesquisáveis. Comece por instanciar a classe GeoPoint e, em seguida, transmita esse objeto a 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) ]
Para mais informações sobre como fazer pesquisas baseadas na localização, consulte Queries on geopoint fields.
Construtor
O construtor da classe GeoPoint é definido da seguinte forma:
-
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 a leste ou oeste de um meridiano de referência para outro meridiano que passa pelo GeoPoint, entre -180 e 180 graus.
Exceções
- TypeError
Qualquer um dos parâmetros tem um tipo inválido ou foi transmitido um atributo desconhecido.
- ValueError
Foi transmitido um valor inválido para um dos parâmetros.
Propriedades
Uma instância da classe GeoPoint tem as seguintes propriedades:
- latitude
Uma distância angular, em graus, a partir do equador. Os pontos localizados a sul do equador têm valores negativos, enquanto os pontos localizados a norte do mesmo têm valores positivos.
- longitude
Uma distância angular, em graus, a partir do meridiano de referência. Os pontos localizados a oeste do meridiano principal têm valores positivos, enquanto os pontos localizados a leste têm valores negativos.