Registry / gcp / google-geo-type

google-geo-type

library0.7.0pypypiunverified

The `google-geo-type` library provides Python protobuf definitions for common geographic types used across Google APIs, such as LatLng, Viewport, and PostalAddress. It is part of the larger `google-cloud-python` monorepo. Currently at version 0.6.0, it follows the release cadence of the Google Cloud client libraries, with updates typically bundled with other related packages.

gcp serialization

pip install google-geo-type

github ↗package ↗

INSTALL

IMPORT

SIG · GOOGLE-GEO-TYPE

google-geo-type

gcppythonv0.7.0

Install

5.3s avg

Import

—

Disk

66MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.7.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.920 runs

installs and imports cleanly · install 0.0s · import 0.000s · 67.6MB

glibc

py 3.10–3.920 runs

installs and imports cleanly · install 5.3s · import 0.000s · 65MB

66MB installed

● package 66MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

LatLng

✓ from google.geo.type import latlng_pb2

✗ from google.geo.type import latlng_pb2

Viewport

✓ from google.geo.type import viewport_pb2

✗ from google.geo.type import viewport_pb2

PostalAddress

✓ from google.geo.type import postal_address_pb2

✗ from google.geo.type import postal_address_pb2

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})")

Debug

Known issues

gotchaAs 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.

affects: <1.0.0

breakingThe 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.

affects: All versions

gotchaThis 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.

affects: All versions

Upgrade

Version history

0.7.0latest on PyPI · released Jun 3, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

24 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/googleapis/google-cloud-python ↗

packagehttps://pypi.org/project/google-geo-type/ ↗