science This feature is available in all regions. It is in GA for India and in the pre-GA Experimental launch stage for all other regions. 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 the Google Maps Platform Service Specific Terms. For more information, see the launch stage descriptions.
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Entwickler im Europäischen Wirtschaftsraum (EWR)
Adressdeskriptoren enthalten zusätzliche Informationen, mit denen ein Ort anhand von Sehenswürdigkeiten und Gebieten beschrieben wird. Demo für Adressdeskriptoren
Zusätzliche Parameter
Adressdeskriptoren können mit dem Parameter extra_computations aktiviert werden. Fügen Sie extra_computations=ADDRESS_DESCRIPTORS in eine Geocoding-Anfrage, Reverse Geocoding-Anfrage oder Places Geocoding-Anfrage ein, um Adressdeskriptoren in Ihrer Antwort zu erhalten.
Beispiel für Geocoding
Die folgende Anfrage enthält die Adresse eines Orts in Delhi:
{"address_descriptor":{"areas":[{"containment":"OUTSKIRTS","display_name":{"language_code":"en","text":"Turkman Gate"},"place_id":"ChIJ_7LLvyb9DDkRMKKxP9YyXgs"},{"containment":"OUTSKIRTS","display_name":{"language_code":"en","text":"Chandni Chowk"},"place_id":"ChIJWcXciBr9DDkRUb4dCDykTwI"},{"containment":"NEAR","display_name":{"language_code":"en","text":"Katar Ganj"},"place_id":"ChIJH3cWUyH9DDkRaw-9CjvcRvY"}],"landmarks":[{"display_name":{"language_code":"en","text":"Delite Cinema"},"straight_line_distance_meters":29.9306755065918,"place_id":"ChIJLfiYDCT9DDkROoEa7NdupUM","travel_distance_meters":418.7794799804688,"spatial_relationship":"ACROSS_THE_ROAD","types":["establishment","movie_theater","point_of_interest"]},{"display_name":{"language_code":"en","text":"YES Bank"},"straight_line_distance_meters":66.83731079101562,"place_id":"ChIJFYHM3yb9DDkRRKGkZl2mpSQ","travel_distance_meters":489.0340270996094,"spatial_relationship":"DOWN_THE_ROAD","types":["bank","establishment","finance","point_of_interest"]},{"display_name":{"language_code":"en","text":"UCO Bank"},"straight_line_distance_meters":25.38849639892578,"place_id":"ChIJ-c6_wCb9DDkRjIk1LeqRtGM","travel_distance_meters":403.2246398925781,"spatial_relationship":"ACROSS_THE_ROAD","types":["atm","bank","establishment","finance","point_of_interest"]},{"display_name":{"language_code":"en","text":"Delhi By Cycle Meeting Point"},"straight_line_distance_meters":44.02867126464844,"place_id":"ChIJNxVfkSb9DDkRJD22l-eGFdM","travel_distance_meters":97.41281890869141,"spatial_relationship":"AROUND_THE_CORNER","types":["establishment","point_of_interest","tourist_attraction","travel_agency"]},{"display_name":{"language_code":"en","text":"Axis Bank Branch"},"straight_line_distance_meters":102.3495178222656,"place_id":"ChIJr3uaDCT9DDkR8roHTVSn1x4","travel_distance_meters":330.8566284179688,"spatial_relationship":"DOWN_THE_ROAD","types":["bank","establishment","finance","point_of_interest"]}]}}
Jedes address_descriptor-Objekt enthält zwei Arrays: landmarks und areas. Das Array landmarks enthält bis zu fünf Ergebnisse, die nach Relevanz sortiert sind. Dabei werden die Nähe zur angeforderten Koordinate, die Häufigkeit des Orientierungspunkts und seine Sichtbarkeit berücksichtigt. Jedes Landmark-Ergebnis enthält die folgenden Werte:
place_id ist die Orts-ID des Ergebnisses für Sehenswürdigkeiten. Weitere Informationen finden Sie unter Orts-IDs.
display_name ist der Anzeigename des Orientierungspunkts und enthält language_code und text.
straight_line_distance_meters ist die Entfernung zwischen der Eingabekoordinate und dem Ergebnis für Sehenswürdigkeiten in Metern.
travel_distance_meters ist die Entfernung in Metern, die über das Straßennetz (ohne Berücksichtigung von Straßenbeschränkungen) zwischen der Eingabekoordinate und dem Ergebnis für Sehenswürdigkeiten zurückgelegt wurde.
spatial_relationship ist die geschätzte Beziehung zwischen der Eingabekoordinate und dem Ergebnis der Landmarken:
"NEAR" ist die Standardbeziehung, wenn keine der folgenden Bedingungen zutrifft.
"WITHIN", wenn die eingegebene Koordinate innerhalb der Grenzen der Struktur liegt, die mit dem Orientierungspunkt verknüpft ist.
"BESIDE", wenn die Eingabekoordinate direkt neben dem Orientierungspunkt oder dem Zugangspunkt des Orientierungspunkts liegt.
"ACROSS_THE_ROAD", wenn die Eingabekoordinate auf der anderen Seite der Route direkt gegenüber dem Orientierungspunkt liegt.
"DOWN_THE_ROAD", wenn die Eingabekoordinate auf derselben Route wie das Landmark liegt, aber nicht "BESIDES" oder "ACROSS_THE_ROAD" ist.
"AROUND_THE_CORNER", wenn die Eingabekoordinate auf einer senkrechten Route zur Sehenswürdigkeit liegt (beschränkt auf eine einzelne Abbiegung).
"BEHIND", wenn die Eingabekoordinate räumlich nah am Orientierungspunkt, aber weit von seinem Zugangspunkt entfernt ist.
Das areas-Objekt enthält bis zu drei Antworten und beschränkt sich auf Orte, die kleine Regionen wie Stadtteile, untergeordnete Orte und große Komplexe repräsentieren. Gebiete, die die angeforderte Koordinate enthalten, werden zuerst aufgelistet und von klein nach groß sortiert. Jedes areas-Ergebnis enthält die folgenden Werte:
place_id ist die Orts-ID des Bereichsergebnisses. Weitere Informationen finden Sie unter Orts-IDs.
display_name ist der Anzeigename des Bereichs und enthält language_code und text.
containment ist die geschätzte Beziehung zwischen der Eingabekoordinate und dem Ergebnis für die Gebiete:
"NEAR" ist die Standardbeziehung, wenn keine der folgenden Bedingungen zutrifft.
"WITHIN", wenn die eingegebene Koordinate in der Nähe des Mittelpunkts des Bereichs liegt.
"OUTSKIRTS", wenn sich die eingegebene Koordinate in der Nähe des Rands des Bereichs befindet.
Abdeckung
Adressdeskriptoren sind in allen Regionen verfügbar. Weitere Informationen finden Sie unter Regionenabdeckung.
Feedback
Diese Funktion ist in allen Regionen verfügbar. In Indien ist sie allgemein verfügbar, in allen anderen Regionen befindet sie sich in der experimentellen Vorab-GA-Phase. Wir freuen uns über Feedback. Senden Sie uns eine E‑Mail an address-descriptors-feedback@google.com.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-05 (UTC)."],[[["\u003cp\u003eAddress descriptors provide richer location details by including nearby landmarks and areas in geocoding results.\u003c/p\u003e\n"],["\u003cp\u003eEnable address descriptors in geocoding requests by adding the \u003ccode\u003eextra_computations=ADDRESS_DESCRIPTORS\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eLandmark results are ranked by relevance based on proximity, prevalence, and visibility, and include details like distance, spatial relationship, and place type.\u003c/p\u003e\n"],["\u003cp\u003eArea results, such as neighborhoods and sublocalities, are prioritized by containment and ordered from smallest to largest, offering context about the surrounding region.\u003c/p\u003e\n"],["\u003cp\u003eAddress descriptor coverage varies by region, with denser locations generally providing more detailed results.\u003c/p\u003e\n"]]],["Address descriptors provide location context using landmarks and areas. They can be enabled in geocoding, reverse geocoding, and places geocoding requests via the `extra_computations=ADDRESS_DESCRIPTORS` parameter. Descriptors include `landmarks` (up to 5), with details like `place_id`, `display_name`, distance, `spatial_relationship`, and `types`; and `areas` (up to 3) with `place_id`, `display_name`, and `containment`. Descriptors are most useful in denser locations. Some regions may return only landmarks.\n"],null,["# Address descriptors request and response\n\n**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](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nAddress descriptors include additional information that help describe a location\nusing landmarks and areas. Check out the [address descriptors demo](https://mapsplatform.google.com/demos/address-descriptors/)\nto explore the feature.\n| **Note:** Address descriptors are more useful in denser locations. If there are no relevant landmarks or areas the response may be empty. Some regions don't have detailed area data and will return landmarks only.\n\nAdditional parameters\n---------------------\n\nAddress descriptors can be enabled through the use of the `extra_computations`\nparameter. Include `extra_computations=ADDRESS_DESCRIPTORS` in a [geocoding request](/maps/documentation/geocoding/requests-geocoding)\n, [reverse geocoding request](/maps/documentation/geocoding/requests-reverse-geocoding)\n, or a [places geocoding request](/maps/documentation/geocoding/requests-places-geocoding)\nto receive address descriptors in your response.\n\nExample in geocoding\n--------------------\n\nThe following query contains the address of a place in Delhi: \n\n https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY\n\nExample in places geocoding\n---------------------------\n\nThe following query contains the place ID of a place in Delhi: \n\n https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY\n\n| **Note**: Not all places are compatible with address descriptors. Very large places (for example, an airport) or areas (for example, a postal region) will never receive an address descriptor.\n\nExample in reverse geocoding\n----------------------------\n\nThe following query contains the latitude/longitude value for a location in\nDelhi: \n\n https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY\n\n| **Note**: Reverse geocoding includes a single address descriptor at the response level. Geocoding and places geocoding will receive an address descriptor for each compatible result in the response\n\n### Response\n\nAn example `address_descriptor` is as follows: \n\n {\n \"address_descriptor\" : {\n \"areas\" : [\n {\n \"containment\" : \"OUTSKIRTS\",\n \"display_name\" : {\n \"language_code\" : \"en\",\n \"text\" : \"Turkman Gate\"\n },\n \"place_id\" : \"ChIJ_7LLvyb9DDkRMKKxP9YyXgs\"\n },\n {\n \"containment\" : \"OUTSKIRTS\",\n \"display_name\" : {\n \"language_code\" : \"en\",\n \"text\" : \"Chandni Chowk\"\n },\n \"place_id\" : \"ChIJWcXciBr9DDkRUb4dCDykTwI\"\n },\n {\n \"containment\" : \"NEAR\",\n \"display_name\" : {\n \"language_code\" : \"en\",\n \"text\" : \"Katar Ganj\"\n },\n \"place_id\" : \"ChIJH3cWUyH9DDkRaw-9CjvcRvY\"\n }\n ],\n \"landmarks\" : [\n {\n \"display_name\" : {\n \"language_code\" : \"en\",\n \"text\" : \"Delite Cinema\"\n },\n \"straight_line_distance_meters\" : 29.9306755065918,\n \"place_id\" : \"ChIJLfiYDCT9DDkROoEa7NdupUM\",\n \"travel_distance_meters\" : 418.7794799804688,\n \"spatial_relationship\" : \"ACROSS_THE_ROAD\",\n \"types\" : [ \"establishment\", \"movie_theater\", \"point_of_interest\" ]\n },\n {\n \"display_name\" : {\n \"language_code\" : \"en\",\n \"text\" : \"YES Bank\"\n },\n \"straight_line_distance_meters\" : 66.83731079101562,\n \"place_id\" : \"ChIJFYHM3yb9DDkRRKGkZl2mpSQ\",\n \"travel_distance_meters\" : 489.0340270996094,\n \"spatial_relationship\" : \"DOWN_THE_ROAD\",\n \"types\" : [ \"bank\", \"establishment\", \"finance\", \"point_of_interest\" ]\n },\n {\n \"display_name\" : {\n \"language_code\" : \"en\",\n \"text\" : \"UCO Bank\"\n },\n \"straight_line_distance_meters\" : 25.38849639892578,\n \"place_id\" : \"ChIJ-c6_wCb9DDkRjIk1LeqRtGM\",\n \"travel_distance_meters\" : 403.2246398925781,\n \"spatial_relationship\" : \"ACROSS_THE_ROAD\",\n \"types\" : [ \"atm\", \"bank\", \"establishment\", \"finance\", \"point_of_interest\" ]\n },\n {\n \"display_name\" : {\n \"language_code\" : \"en\",\n \"text\" : \"Delhi By Cycle Meeting Point\"\n },\n \"straight_line_distance_meters\" : 44.02867126464844,\n \"place_id\" : \"ChIJNxVfkSb9DDkRJD22l-eGFdM\",\n \"travel_distance_meters\" : 97.41281890869141,\n \"spatial_relationship\" : \"AROUND_THE_CORNER\",\n \"types\" : [\n \"establishment\",\n \"point_of_interest\",\n \"tourist_attraction\",\n \"travel_agency\"\n ]\n },\n {\n \"display_name\" : {\n \"language_code\" : \"en\",\n \"text\" : \"Axis Bank Branch\"\n },\n \"straight_line_distance_meters\" : 102.3495178222656,\n \"place_id\" : \"ChIJr3uaDCT9DDkR8roHTVSn1x4\",\n \"travel_distance_meters\" : 330.8566284179688,\n \"spatial_relationship\" : \"DOWN_THE_ROAD\",\n \"types\" : [ \"bank\", \"establishment\", \"finance\", \"point_of_interest\" ]\n }\n ]\n }\n }\n\nThere are two arrays in each `address_descriptor` object: `landmarks` and\n`areas`. The `landmarks` array contains up to 5 results ranked in order of\nrelevance by taking account of proximity to the requested coordinate, the\nprevalence of the landmark and its visibility. Each landmark result contains the\nfollowing values:\n\n- `place_id` is the place ID of the landmarks result. See the [place ID\n overview](/maps/documentation/places/web-service/place-id).\n- `display_name` is the display name of the landmark and contains `language_code` and `text`.\n- `straight_line_distance_meters` is the point to point distance in meters between the input coordinate and the landmarks result.\n- `travel_distance_meters` is the distance in meters as traveled via the road network (ignoring road restrictions) between the input coordinate and the landmarks result.\n- `spatial_relationship` is the estimated relationship between the input coordinate and the landmarks result:\n - `\"NEAR\"` is the default relationship when none of the following applies.\n - `\"WITHIN\"` when the input coordinate is contained within the bounds of the structure associated with the landmark.\n - `\"BESIDE\"` when the input coordinate is directly adjacent to the landmark or landmark's access point.\n - `\"ACROSS_THE_ROAD\"` when the input coordinate is directly opposite of the landmark on the other side of the route.\n - `\"DOWN_THE_ROAD\"` when the input coordinate is along the same route as the landmark, but not `\"BESIDES\"` or `\"ACROSS_THE_ROAD\"`.\n - `\"AROUND_THE_CORNER\"` when the input coordinate is along a perpendicular route as the landmark (restricted to a single turn).\n - `\"BEHIND\"` when the input coordinate is spatially close to the landmark, but far from its access point.\n- `types` are the [Place types](/maps/documentation/places/web-service/supported_types#table1) of the landmark.\n\nThe `areas` object contains up to 3 responses and limits itself to places that\nrepresent small regions, such as neighborhoods, sublocalities, and large\ncomplexes. Areas that contain the requested coordinate are listed first and\nordered from smallest to largest. Each `areas` result contains the following\nvalues:\n\n- `place_id` is the place ID of the areas result. See the [place ID\n overview](/maps/documentation/places/web-service/place-id).\n- `display_name` is the display name of the area and contains `language_code` and `text`.\n- `containment` is the estimated containment relationship between the input coordinate and the areas result:\n - `\"NEAR\"` is the default relationship when none of the following applies.\n - `\"WITHIN\"` when the input coordinate is close to the center of the area.\n - `\"OUTSKIRTS\"` when the input coordinate is close to the edge of the area.\n\n### Coverage\n\nAddress descriptors are available in all regions. See\n[region\ncoverage](/maps/documentation/geocoding/address-descriptors/coverage) for details.\n\n### Feedback\n\nThis feature is available in all regions and is in GA for India and in the\npre-GA Experimental launch stage for all other regions. We would appreciate\nfeedback. Please email us at [address-descriptors-feedback@google.com](mailto:address-descriptors-feedback@google.com)."]]
