La classe GeoPoint

La classe GeoPoint représente un point de la surface de la Terre représenté par les coordonnées de latitude et de longitude.

Attention : **Cette solution n'est plus recommandée** : les applications qui utilisent cette API ne peuvent s'exécuter que dans l'environnement d'exécution Python 2 et devront passer à une [solution recommandée](/appengine/docs/standard/python/migrate-to-python3/migrating-services#migration_paths_for_bundled_services) avant de migrer vers l'environnement d'exécution Python 3.

La classe GeoPoint est définie dans le module google.appengine.api.search.

Présentation

La classe GeoPoint vous permet de rechercher des emplacements de carte. Vous commencez par instancier la classe GeoPoint, puis vous transmettez cet objet à un champ de document spécifique :

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)
         ]

Pour en savoir plus sur les recherches basées sur la localisation, consultez la page Queries on geopoint fields.

Constructeur

Le constructeur de la classe GeoPoint est défini comme suit :

GeoPoint(latitude, longitude)

Un point sur la surface de la terre représenté par les coordonnées de latitude et de longitude.

Arguments

latitude

L'angle entre le plan équatorial et une ligne passant par le GeoPoint, entre -90 et 90 degrés.

longitude

L'angle est ou ouest d'un méridien de référence à un autre méridien passant par le GeoPoint, entre -180 et 180 degrés.

Exceptions

TypeError

L'un des paramètres a un type non valide ou un attribut inconnu a été passé.

ValueError

Une valeur non valide a été transmise pour l'un des paramètres.

Propriétés

Une instance de la classe GeoPoint possède les propriétés suivantes :

latitude

Une distance angulaire, en degrés, de l'équateur. Les points situés au sud de l'équateur ont des valeurs négatives, tandis que les points situés au nord de celui-ci ont des valeurs positives.

longitude

Une distance angulaire, en degrés, du premier méridien. Les points situés à l'ouest du premier méridien ont des valeurs positives tandis que les points situés à l'est de celui-ci ont des valeurs négatives.