A classe GeoPoint

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.