La classe GeoPoint rappresenta un punto sulla superficie terrestre rappresentato dalle coordinate di latitudine e longitudine.
GeoPoint è definito nel modulo google.appengine.api.search.
Introduzione
La classe GeoPoint consente di rendere ricercabili le posizioni sulla mappa. Inizi creando un'istanza della classe GeoPoint e poi passi l'oggetto a un campo del documento specifico:
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) ]
Per saperne di più su come eseguire ricerche basate sulla posizione, consulta Queries on geopoint fields.
Costruttore
Il costruttore della classe GeoPoint è definito come segue:
-
GeoPoint(latitude, longitude)
Un punto sulla superficie terrestre rappresentato dalle coordinate di latitudine e longitudine.
Argomenti
- latitude
L'angolo tra il piano equatoriale e una linea che passa per il GeoPoint, compreso tra -90 e 90 gradi.
- longitude
L'angolo a est o a ovest da un meridiano di riferimento a un altro meridiano che passa per il GeoPoint, compreso tra -180 e 180 gradi.
Eccezioni
- TypeError
Uno dei parametri ha un tipo non valido o è stato trasmesso un attributo sconosciuto.
- ValueError
È stato passato un valore non valido per uno dei parametri.
Proprietà
Un'istanza della classe GeoPoint ha le seguenti proprietà:
- latitude
Una distanza angolare, in gradi, dall'equatore. I punti situati a sud dell'equatore hanno valori negativi, mentre quelli situati a nord hanno valori positivi.
- longitude
Una distanza angolare, in gradi, dal meridiano fondamentale. I punti situati a ovest del meridiano zero hanno valori positivi, mentre quelli situati a est hanno valori negativi.