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 ti consente di rendere disponibili per la ricerca i luoghi sulla mappa. Puoi iniziare creando un'istanza della classe GeoPoint e poi passare tale oggetto a un campo di 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 ulteriori informazioni sull'esecuzione di ricerche basate sulla località, consulta Queries on geopoint fields.
Costruttore
Il costruttore della classe GeoPoint viene definito come segue:
-
GeoPoint(latitudine, longitudine)
Un punto sulla superficie terrestre rappresentato dalle coordinate di latitudine e longitudine.
Argomenti
- latitudine
L'angolo tra il piano equatoriale e una linea che passa per il GeoPoint, compreso tra -90 e 90 gradi.
- longitude
L'angolo est o ovest da un meridiano di riferimento a un altro meridiano che passa attraverso il GeoPoint, con un intervallo compreso tra -180 e 180 gradi.
Eccezioni
- TypeError
Il tipo di parametro non è valido oppure è stato trasmesso un attributo sconosciuto.
- ValueError
È stato trasmesso un valore non valido per uno dei parametri.
Proprietà
Un'istanza della classe GeoPoint ha le seguenti proprietà:
- latitudine
Distanza angolare, in gradi, dall'equatore. I punti situati a sud dell'equatore hanno valori negativi, mentre quelli a nord hanno valori positivi.
- longitude
Distanza angolare, in gradi, dal meridiano primo. I punti a ovest del meridiano fondamentale hanno valori positivi, mentre quelli a est hanno valori negativi.