La classe GeoPoint rappresenta un punto sulla superficie terrestre rappresentato da 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 le posizioni sulla mappa. Inizia creando un'istanza della classe GeoPoint e poi passa 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 ulteriori informazioni 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 da coordinate di latitudine e longitudine.
Argomenti
- latitude
L'angolo tra il piano equatoriale e una linea che passa per il punto geografico, compreso tra -90 e 90 gradi.
- longitude
L'angolo est o ovest da un meridiano di riferimento a un altro meridiano che passa per il punto geografico, compreso tra -180 e 180 gradi.
Eccezioni
- TypeError
Uno dei parametri ha un tipo non valido o è stato passato 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 a sud dell'equatore hanno valori negativi, mentre quelli a nord hanno valori positivi.
- longitude
Una distanza angolare, in gradi, dal meridiano di Greenwich. I punti a ovest del meridiano zero hanno valori positivi, mentre quelli a est hanno valori negativi.