HTTP Protocol Reference

This document provides detailed reference documentation for the raw protocol (XML and HTTP) for the Maps Data API.

This document doesn't contain information about the programming-language client libraries. For client-library reference information, see the links from the programming-language-specific sections of the developer's guide.

Contents

Audience

This document is intended for programmers who want to write client applications that can interact with Maps. It's a reference document; it assumes that you understand the concepts presented in the developer's guide, and the general ideas behind the Google Data APIs protocol.

Maps Feed Types

The Maps Data API provides the following types of feeds:

• Map
• Feature

Map

The Map Feed is a feed of user-created maps.

This feed's full GET URI is:

http://maps.google.com/maps/feeds/maps/default/full

This feed returns a list of all maps for the authenticated user. Each map is returned as a separate entry, though full feature information is only retrieved via the feature feed URLs below.

Additionally, the following request types are supported for operations on maps:

• query GET http://maps.google.com/maps/feeds/maps/userID/full/mapID
• insert POST http://maps.google.com/maps/feeds/maps/userID/full
• update PUT http://maps.google.com/maps/feeds/maps/userID/full/mapID
• delete DELETE http://maps.google.com/maps/feeds/maps/userID/full/mapID
• batch POST http://maps.google.com/maps/feeds/maps/userID/full/batch

Supported query parameters:

• max-results
• showdeleted
• start-index

Feature

The Feature Feed is a feed of map features.

This feed's full GET URI is:

http://maps.google.com/maps/feeds/features/userID/mapID/full

This feed returns a list of all features for the given map for the authenticated user. Each feature is returned as a separate entry.

Additionally, the following request types are supported for operations on features:

• query GET http://maps.google.com/maps/feeds/features/userID/mapID/full/featureID
• insert POST http://maps.google.com/maps/feeds/features/userID/mapID/full
• update PUT http://maps.google.com/maps/feeds/festures/userID/mapID/full/featureID
• delete DELETE http://maps.google.com/maps/feeds/festures/userID/mapID/full/featureID
• batch POST http://maps.google.com/maps/feeds/features/userID/mapID/full/batch

Supported query parameters:

• max-results
• showdeleted
• start-index

Maps query parameters reference

In addition to the standard Data API query parameters, Maps uses the following optional parameters:

Maps Elements Reference

The Maps Data API uses the standard Atom elements, and some standard Google Data elements. For information about these standard elements, see the Atom specification and the Kinds document.

In addition to the standard elements, the Maps Data API uses the elements described in this section.

The elements specific to this Data API are defined in the following namespace:

The following table describes the symbols used to mark properties in the element-reference sections.

Back to top