Grounds

Important: This experimental feature has been replaced by theSearchDestinationsendpoint of the new Geocoding API v4. Use that endpoint instead if you want toget the grounds of a place.

This product or feature is Experimental (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by theGoogle Maps Platform Service Specific Terms. For more information, see thelaunch stage descriptions.

European Economic Area (EEA) developers If your billing address is in the European Economic Area, effective on 8 July 2025, the Google Maps Platform EEA Terms of Service will apply to your use of the Services. Functionality varies by region.Learn more.

Thegrounds field within the Geocoding response contains a single groundsthat, when populated, gives contextual information about the immediateterritory that the geocoding is on. For example:

  • If the geocode is a museum located inside of a park, the grounds may be thepark.
  • If the geocode is a shop within a strip mall, the grounds may be the stripmall.
  • If the geocode is a restaurant within a sports complex, the grounds may be thesports complex.
  • If the geocode is a building within a university, the grounds may be theuniversity.
  • If the geocode is an office building within a corporate campus, the groundsmay be the corporate campus.

The grounds contains the following values:

  • outline contains the GeoJSON encoding of the polygon that approximates the surface area of the earth covered by the grounds, using theRFC 7946 format
  • name contains the name of the grounds and is an object with subfieldslanguage_code andtext

Note: The RFC 7946 format supports MultiPolygons, so oneoutline object canrepresent multiple polygons.

Grounds are returned for some, but not all, places with a precise location, suchas street addresses, buildings, and establishments. Places that represent largeareas, such as cities and regions, won't be returned with grounds.

Request details

You can obtain navigation points in the following kinds of requests:

For any of these requests, you must supply this parameter:extra_computations=GROUNDS.

Example request

The following query usesplace geocoding to obtain the grounds for arestaurant within a mall in Hackensack, New Jersey, United States:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJ-Wdg_3b6wokRjB1ux1e68XM&extra_computations=GROUNDS&key=YOUR_API_KEY

Example response

The response from the query above shows the grounds:

{"grounds":{"display_name":{"language_code":"en","text":"The Shops at Riverside"},"outline":{"coordinates":[[[-74.03276087437951,40.9079393287367],[-74.0328096444231,40.9079123990298],[-74.032853573312,40.9078787684781],[-74.0329374864265,40.907833205165],[-74.0329543407656,40.9076763372261],[-74.0329762155439,40.9076367262102],[-74.03299916612821,40.9075190685498],[-74.0330511635356,40.9071219006983],[-74.0331433244228,40.9065102533867],[-74.03309025123249,40.906473864115],[-74.0330778794394,40.9064567729216],[-74.03304363287749,40.9063779338105],[-74.03298374620459,40.9062267374933],[-74.03284191870981,40.9060418308559],[-74.0327045736519,40.9058626714851],[-74.0324668194403,40.9055539457374],[-74.03218782543171,40.9051507995429],[-74.03202878431971,40.9049213427489],[-74.031980910588,40.9048524525955],[-74.0318966384468,40.9047239669456],[-74.03188946634801,40.9047059572771],[-74.0318858802984,40.904689357769],[-74.03188605960089,40.9046316335439],[-74.0317557066551,40.9044960202159],[-74.03166641393911,40.9044030668361],[-74.031603120081,40.9043369552179],[-74.0315466397082,40.9042767712891],[-74.03149625561549,40.9042231654583],[-74.0314272240077,40.9041493230684],[-74.0313515581648,40.9040692773688],[-74.031280374868,40.9039955812079],[-74.0312140327287,40.9040621334267],[-74.03094346414279,40.9042364679492],[-74.0309237407716,40.9042490145166],[-74.0309043760051,40.9042578521067],[-74.0308932591939,40.9042613909983],[-74.0308821423819,40.9042634259862],[-74.0308654671629,40.9042639218323],[-74.0285474182009,40.9040980324443],[-74.0285409631984,40.9041506567763],[-74.0284695995455,40.9041477672732],[-74.0284391175751,40.904464680407],[-74.0284416278552,40.9044690964629],[-74.0284448553581,40.9044713582818],[-74.0284504138353,40.9044724463848],[-74.0284848405289,40.9044735630073],[-74.02849255067299,40.9047420452213],[-74.0285024124847,40.9047613382318],[-74.0285088674885,40.9047682680531],[-74.0285178327711,40.9047717937456],[-74.02860246501849,40.9047800216474],[-74.0284446760524,40.9060030191662],[-74.02847533732761,40.9060129264131],[-74.0288760851204,40.9060525457656],[-74.0285884791836,40.9069432827033],[-74.02962647637111,40.9069961651161],[-74.029634186469,40.906997858665],[-74.0296395656068,40.9070004251279],[-74.0296417172619,40.9070019329367],[-74.02964422752621,40.907003491537],[-74.02964691709499,40.9070070305046],[-74.02964763431331,40.907010440501],[-74.02964727570421,40.9070133973578],[-74.02964619987669,40.9070203129561],[-74.02999046437181,40.9070453118125],[-74.03005788276261,40.9077398485747],[-74.0300808336987,40.9080079189719],[-74.03036987181341,40.9080202832536],[-74.03096784939891,40.9080511362848],[-74.03120058499491,40.9080502612003],[-74.0314021215987,40.9080639151613],[-74.03163754620471,40.9080799617702],[-74.03186472260489,40.9080952909298],[-74.0319188719515,40.9080990493699],[-74.0320239431563,40.9080594910787],[-74.0324187665168,40.9080114893404],[-74.0325363885767,40.907988144292],[-74.0326864641787,40.9079585672777],[-74.03276087437951,40.9079393287367]]],"type":"Polygon"}},}

Using the JavaScript code similar to the example inBuilding outlines andentrances, we are able to render the grounds outline on the map:

Grounds outline rendered on the map

Feedback

This is an experimental feature. We would appreciate feedback atgeocoding-feedback-channel@google.com.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-21 UTC.