The GeoPoint Class

Class GeoPoint represents a point on the earth's surface represented by latitude and longitude coordinates.

GeoPoint is defined in the module google.appengine.api.search.

Introduction

The GeoPoint class allows you to make map locations searchable. You start by instantiating the GeoPoint class and then pass that object to a specific document field:

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

For more information about performing location-based searches, please see Queries on geopoint fields.

Constructor

The constructor for class GeoPoint is defined as follows:

GeoPoint(latitude, longitude)

A point on the earth's surface represented by latitude and longitude coordinates.

Arguments

latitude

The angle between the equatorial plan and a line that passes through the GeoPoint, between -90 and 90 degrees.

longitude

The angle east or west from a reference meridian to another meridian that passes through the GeoPoint, between -180 and 180 degrees.

Exceptions

TypeError

Any of the parameters has an invalid type, or an unknown attribute was passed.

ValueError

An invalid value was passed for one of the parameters.

Properties

An instance of class GeoPoint has the following properties:

latitude

An angular distance, in degrees, from the equator. Points located to the south of the equator have negative values, while points located to the north of it have positive values.

longitude

An angular distance, in degrees, from the prime meridian. Points located to the west of the prime meridian have positive values, while points located to the east of it have negative values.