science Bu özellik tüm bölgelerde kullanılabilir. Bu özellik Hindistan'da GKST'de, diğer tüm bölgelerde ise GKST öncesi deneysel lansman aşamasındadır. GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca bu ürünler ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Avrupa Ekonomik Alanı (AEA) geliştiricileri
Adres tanımlayıcıları, önemli noktaları ve alanları kullanarak bir konumu tanımlamaya yardımcı olan ek bilgiler içerir. Özelliği keşfetmek için adres tanımlayıcıları demosuna göz atın.
Ek parametreler
Adres tanımlayıcıları, extra_computations parametresi kullanılarak etkinleştirilebilir. Yanıtınızda adres tanımlayıcıları almak için coğrafi kodlama isteğine (extra_computations=ADDRESS_DESCRIPTORS), tersine coğrafi kodlama isteğine (extra_computations=ADDRESS_DESCRIPTORS) veya yer coğrafi kodlama isteğine (extra_computations=ADDRESS_DESCRIPTORS) dahil edin.
Coğrafi kodlamada örnek
Aşağıdaki sorguda Delhi'deki bir yerin adresi var:
{"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"]}]}}
Her address_descriptor nesnesinde iki dizi vardır: landmarks ve areas. landmarks dizisi, istenen koordinata yakınlık, simgenin yaygınlığı ve görünürlüğü dikkate alınarak alaka düzeyine göre sıralanmış en fazla 5 sonuç içerir. Her önemli nokta sonucu aşağıdaki değerleri içerir:
place_id, önemli noktalar sonucunun yer kimliğidir. Yer kimliğine genel bakış başlıklı makaleyi inceleyin.
display_name, önemli yerin görünen adıdır ve language_code ile text'yi içerir.
straight_line_distance_meters, giriş koordinatı ile önemli yerler sonucu arasındaki nokta nokta mesafedir (metre cinsinden).
travel_distance_meters, giriş koordinatı ile önemli yerler sonucu arasındaki yol ağında (yol kısıtlamaları göz ardı edilerek) gidilen mesafeyi metre cinsinden ifade eder.
spatial_relationship, giriş koordinatı ile önemli yerler sonucu arasındaki tahmini ilişkidir:
Aşağıdakilerden hiçbiri geçerli olmadığında "NEAR" varsayılan ilişkidir.
Giriş koordinatı, belirgin işaretle ilişkili yapının sınırları içinde yer aldığında "WITHIN"
"BESIDE" Giriş koordinatı, doğrudan önemli noktanın veya önemli noktanın erişim noktasının bitişiğinde olduğunda
"ACROSS_THE_ROAD" Giriş koordinatı, rotanın diğer tarafındaki önemli noktanın tam karşısında olduğunda.
"DOWN_THE_ROAD" Giriş koordinatı, önemli yerle aynı rota üzerinde olduğunda ancak "BESIDES" veya "ACROSS_THE_ROAD" olmadığında.
Giriş koordinatı, referans noktasıyla aynı yönde olmayan bir rota üzerindeyken (tek bir dönüşle sınırlıdır)."AROUND_THE_CORNER"
"BEHIND" Giriş koordinatı, yer işaretine yakın ancak erişim noktasına uzak olduğunda.
areas nesnesi en fazla 3 yanıt içerir ve kendisini mahalleler, alt yerleşim birimleri ve büyük kompleksler gibi küçük bölgeleri temsil eden yerlerle sınırlar. İstenen koordinatı içeren alanlar önce listelenir ve en küçüğünden en büyüğüne doğru sıralanır. Her areas sonucu aşağıdaki değerleri içerir:
display_name, bölgenin görünen adıdır ve language_code ile text'yi içerir.
containment, giriş koordinatı ile alanlar sonucu arasındaki tahmini kapsama ilişkisidir:
Aşağıdakilerden hiçbiri geçerli olmadığında "NEAR" varsayılan ilişkidir.
"WITHIN" Giriş koordinatı alanın merkezine yakın olduğunda.
"OUTSKIRTS" Giriş koordinatı, alanın kenarına yakın olduğunda.
Kapsam
Adres tanımlayıcıları tüm bölgelerde kullanılabilir. Ayrıntılar için bölge
kapsamı başlıklı makaleyi inceleyin.
Geri bildirim
Bu özellik tüm bölgelerde kullanılabilir. Hindistan'da genel kullanıma sunulmuş olup diğer tüm bölgelerde genel kullanıma sunulmadan önceki deneysel lansman aşamasındadır. Geri bildirimlerinizi bekliyoruz. Lütfen address-descriptors-feedback@google.com adresine e-posta gönderin.
[null,null,["Son güncelleme tarihi: 2025-08-31 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)."]]
