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.