Google Geo Type API Client Library

Common errors

• ModuleNotFoundError: No module named 'google.geo.type.latlng'

  cause Incorrect import path. The protobuf definitions are found in modules ending with `_pb2`.
  fix Change the import statement to include `_pb2` at the end: `from google.geo.type import latlng_pb2`.

• ERROR: Package 'google-geo-type' requires a different Python; <your_version> not in '>=3.9'

  cause Attempting to install or run the library with a Python version older than 3.9.
  fix Upgrade your Python environment to version 3.9 or newer. Check your Python version with `python --version`.

• AttributeError: 'module' object has no attribute 'LatLng'

  cause Attempting to access a protobuf message directly from the `google.geo.type` module, or using the wrong casing/name.
  fix Ensure you are importing the specific protobuf definition module (e.g., `latlng_pb2`) and accessing the message class (e.g., `LatLng`) from *that* module: `from google.geo.type import latlng_pb2; point = latlng_pb2.LatLng(...)`.

Warnings

• gotcha As a pre-GA (versions < 1.0.0) library, protobuf definitions within `google-geo-type` may introduce backward-incompatible changes without a major version bump. Always review release notes when upgrading.
  Fix: Pin the library version in your `requirements.txt` (e.g., `google-geo-type==0.6.0`) and carefully test updates. Monitor the GitHub repository for official release notes.
• breaking The library explicitly requires Python 3.9 or newer. Installing or running on older Python versions will result in an `ERROR: Package 'google-geo-type' requires a different Python; <your_version> not in '>=3.9'` during installation or runtime errors.
  Fix: Ensure your development and deployment environments use Python 3.9 or a newer compatible version. Upgrade Python if necessary.
• gotcha This library provides only protobuf *definitions* (like `LatLng`, `Viewport`). It does not include client methods for interacting with specific Google Geo APIs (e.g., Geocoding API, Places API). For those, you'll need the respective Google Cloud client library.
  Fix: If you need to *call* a Google Geo API, ensure you install the appropriate client library (e.g., `google-maps-services-python`, `google-cloud-maps` for newer services) in addition to, or instead of, `google-geo-type` for types that are not part of the specific client library.

Install

• pip install google-geo-type Install latest version

Imports

• latlng_pb2
  wrong:

  from google.geo.type.v1 import latlng_pb2

  correct:

  from google.geo.type import latlng_pb2

  Early versions might have used a versioned path (e.g., 'v1') which is not present in the current unversioned structure.
• viewport_pb2

  from google.geo.type import viewport_pb2

• postal_address_pb2

  from google.geo.type import postal_address_pb2

Quickstart

This quickstart demonstrates how to import and create instances of common geographic types like `LatLng` and `Viewport` using their respective protobuf definition modules.

from google.geo.type import latlng_pb2
from google.geo.type import viewport_pb2

# Create a LatLng object
latitude = 34.052235
longitude = -118.243683
point = latlng_pb2.LatLng(latitude=latitude, longitude=longitude)
print(f"Point: ({point.latitude}, {point.longitude})")

# Create a Viewport object
viewport = viewport_pb2.Viewport(
    low=latlng_pb2.LatLng(latitude=33.9, longitude=-118.3),
    high=latlng_pb2.LatLng(latitude=34.1, longitude=-118.1)
)
print(f"Viewport Low: ({viewport.low.latitude}, {viewport.low.longitude})")
print(f"Viewport High: ({viewport.high.latitude}, {viewport.high.longitude})")