Module geocoding

The Geocoding API is a service that provides geocoding and reverse geocoding of addresses. It can be used to convert a street address to geographic coordinates (latitude & longitude), or vice versa.

Geocoding is the process of converting addresses (like a street address) into geographic coordinates (like latitude and longitude), which you can use to place markers on a map, or position the map.

Reverse geocoding is the process of converting geographic coordinates into a human-readable address.

You can also use the Geocoding API to find the address for a given place ID.

Get Started

• New Users: Before you can start using the Google Maps Platform APIs and SDKs, you must sign up and create a billing account. To learn more, see Get Started with Google Maps Platform.

• This service is also available as part of the client-side Google Maps JavaScript API, or for server-side use with the Java Client, Python Client, Go Client and Node.js Client for Google Maps Services.

Start coding with our client libraries

Client libraries make developing with the Google Maps web service APIs easier by providing simple, native implementations of common tasks, such as authentication, request throttling and automatic retry. The Geocoding API is available in the Java Client, Python Client, Go Client and Node.js Client for Google Maps Services.

Authentication, quotas, pricing, and policies

Activate the API and get an API key

To use the Geocoding API, you must first activate the API in the Google Cloud Platform Console and obtain the proper authentication credentials. You need to provide an API key in each request (or a client ID if you have a Premium Plan.

Click the button below to flow through a process where you will:

1. Create or select a project
2. Enable the API
3. Get an API key

Get Started

Learn more about authentication credentials.

Quotas and pricing

Review the usage and billing page for details on the quotas and pricing set for the Geocoding API.

Policies

Use of the Geocoding API must be in accordance with the API policies.

Learn more

There’s more you can do with the Geocoding API. See the Geocoding API developer guide for additional demos, examples, available parameters, status codes and error messages, and other details.

The Geocoding API developer guide describes the Geocoding API web service. It is intended for website and mobile developers who want to use geocoding data within maps provided by one of the Google Maps Platform APIs.

Re-exports

pub use crate::geocoding::error::Error;

pub use crate::geocoding::forward::component::Component;

pub use crate::geocoding::forward::ForwardRequest;

pub use crate::geocoding::response::geocoding::Geocoding;

pub use crate::geocoding::response::plus_code::PlusCode;

pub use crate::geocoding::response::status::Status;

pub use crate::geocoding::response::Response;

pub use crate::geocoding::reverse::ReverseRequest;

pub use crate::types::AddressComponent;

pub use crate::types::Geometry;

pub use crate::types::LocationType;

pub use crate::geocoding::error::Error as GeocodingError;

pub use crate::geocoding::forward::component::Component as GeocodingComponent;

pub use crate::geocoding::forward::ForwardRequest as GeocodingRequest;

pub use crate::geocoding::response::status::Status as GeocodingStatus;

pub use crate::geocoding::response::Response as GeocodingResponse;

pub use crate::geocoding::reverse::ReverseRequest as GeocodingReverseRequest;

Modules

error

Elevation API error types and error messages.

forward

Look in this module for documentation on building your Geocoding API forward query. In particular, look at the ForwardRequest struct for examples of the builder pattern. This module contains the tools (enums, structs, methods) for building your Google Maps Platform request. Forward geocoding converts a street address to latitude & longitude coordinates.

response

Resources (enums, structs) for processing the Geocoding API response from the Google Maps Platform. Look in here for more information about the data returned from Google’s server and how to parse it with your program.

reverse

Look in this module for documentation on building your Geocoding API reverse query. In particular, look at the ReverseRequest struct for examples of the builder pattern. This module contains the tools (enums, structs, methods) for building your Google Maps Platform request. Reverse geocoding converts latitude & longitude coordinates to a street address.