Die GeoPoint-Klasse

Die Klasse GeoPoint stellt einen Punkt auf der Erdoberfläche in Breiten- und Längenkoordinaten dar.

GeoPoint ist im Modul google.appengine.api.search definiert.

Einführung

Die GeoPoint-Klasse ermöglicht es, Kartenstandorte zu durchsuchen. Sie beginnen, indem Sie die GeoPoint-Klasse instanziieren und dieses Objekt dann an ein bestimmtes Dokumentfeld weitergeben:

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

Weitere Informationen zu standortbasierten Suchvorgängen finden Sie unter Queries on geopoint fields.

Konstruktor

Der Konstruktor für die Klasse GeoPoint ist so definiert:

GeoPoint(latitude, longitude)

Ein Punkt auf der Erdoberfläche, dargestellt in Breiten- und Längenkoordinaten.

Argumente

latitude

Der Winkel zwischen der Äquatorialebene und einer Linie, die durch den GeoPoint verläuft, zwischen -90 und 90 Grad.

longitude

Der östlich oder westlich gemessene Winkel zwischen einem Referenzmeridian und einem anderen Meridian, der durch den GeoPoint verläuft, zwischen -180 und 180 Grad.

Ausnahmen

TypeError

Einer der Parameter weist einen ungültigen Typ auf oder ein unbekanntes Attribut wurde übergeben.

ValueError

Ein ungültiger Wert wurde für einen der Parameter übergeben.

Eigenschaften

Eine Instanz der Klasse GeoPoint hat die folgenden Attribute:

latitude

Ein Winkelabstand in Grad vom Äquator aus betrachtet. Punkte südlich des Äquators haben negative Werte, nördlich davon liegende Punkte positive.

longitude

Ein Winkelabstand in Grad, vom Nullmeridian aus betrachtet. Punkte westlich des Nullmeridians haben positive Werte, östlich davon liegende Punkte negative.