La clase GeoPoint

La clase GeoPoint es un punto sobre la superficie de la Tierra representado por las coordenadas de latitud y longitud.

GeoPoint se define en el módulo google.appengine.api.search.

Introducción

La clase GeoPoint te permite buscar ubicaciones en el mapa. Comienzas con la creación de una instancia de la clase GeoPoint y, luego, pasas ese objeto a un 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 obtener más información sobre cómo realizar búsquedas basadas en la ubicación, consulta Queries on geopoint fields.

Constructor

El constructor para la clase GeoPoint se define de la manera siguiente:

GeoPoint(latitude, longitude)

Un punto sobre la superficie de la Tierra representado por las coordenadas de latitud y longitud.

Argumentos

latitude (latitud)

El ángulo entre la línea ecuatorial y una línea que pasa por GeoPoint entre -90 y 90 grados.

longitude (longitud)

El ángulo al este o al oeste desde una referencia de meridiano a otro meridiano que pasa por GeoPoint entre -180 y 180 grados.

Excepciones

TypeError

Alguno de los parámetros tiene un tipo no válido o se pasó un atributo desconocido.

ValueError

Se pasó algún valor no válido para uno de los parámetros.

Propiedades

Una instancia de la clase GeoPoint tiene las siguientes propiedades:

latitude (latitud)

Una distancia angular, en grados, desde el ecuador. Los puntos ubicados al sur del ecuador tienen valores negativos, mientras que los puntos ubicados al norte de este tienen valores positivos.

longitude (longitud)

Una distancia angular, en grados, desde el primer meridiano. Los puntos ubicados hacia el oeste del primer meridiano tienen valores positivos, mientras que los puntos ubicados hacia el este tienen valores negativos.