Search - Get Polygon
Şehir veya ülke bölgesi gibi bir coğrafi alan şeklinin çokgen verilerini almak için kullanın.
API Get Polygon , şehir veya ülke bölgesi gibi bir coğrafi alan taslağının çokgen verilerini sağlayan bir HTTP GET isteğidir.
GET {endpoint}/search/polygon?api-version=2026-01-01&coordinates={coordinates}
GET {endpoint}/search/polygon?api-version=2026-01-01&coordinates={coordinates}&view={view}&resultType={resultType}&resolution={resolution}
URI Parametreleri
| Veri Akışı Adı | İçinde | Gerekli | Tür | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Azure Haritalar service hostname. Azure açık bulut için |
|
api-version
|
query | True |
string minLength: 1 |
Bu işlem için kullanılacak API sürümü. |
|
coordinates
|
query | True |
number[] |
Dünya üzerinde boylam ve enlem olarak belirtilen bir nokta. Örnek: &koordinatları=lon,lat |
|
resolution
|
query |
Çözünürlük, geri gönderilecek puan miktarını belirler. Belirtilmezse, varsayılan değer orta çözünürlüktür. |
||
|
result
|
query |
Jeopolitik kavram için bir sınır döndürmek. Belirtilmezse, varsayılan değer |
||
|
view
|
query |
string |
ISO 3166-1 Alfa-2 bölge/ülke kodunutemsil eden bir dize. Bu, jeopolitik ihtilaflı kenarlıkları ve etiketleri belirtilen kullanıcı bölgesiyle uyumlu olacak şekilde değiştirir. Varsayılan olarak, görünüm parametresi istekte tanımlamamış olsanız bile "Otomatik" olarak ayarlanır. Ayrıntılar ve kullanılabilir Görünümleri görmek için lütfen Desteklenen Görünümler bakın. |
İstek Başlığı
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| x-ms-client-id |
string |
Azure AD güvenlik modeliyle birlikte hangi hesabın kullanılacağını belirtir. Bu cihaz, Azure Haritalar hesabı için benzersiz bir kimlik oluşturur ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'de Microsoft Entra ID güvenliği kullanımı hakkında daha fazla bilgi için bkz. Doğrulamayı Azure Haritalar içinde yönetin. |
|
| Accept-Language |
string |
Arama sonuçlarının döndürülmesi gereken dil. Ayrıntılar için lütfen Desteklenen Diller bakın. |
Yanıtlar
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| 200 OK |
İstek başarılı oldu. Media Types: "application/geo+json", "application/json" |
|
| Other Status Codes |
Beklenmeyen bir hata yanıtı. Media Types: "application/geo+json", "application/json" Üst Bilgiler x-ms-error-code: string |
Güvenlik
AadToken
Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim kontrolüyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi kontrol etmek için kullanılabilir. Azure rol tabanlı erişim kontrolleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağa erişim belirlemek için kullanılır. Tüm kullanıcılara, gruplara veya hizmet sorumlularına yerleşik bir rol veya Azure Haritalar REST API'leri için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.
Senaryoları uygulamak için
Note
- Bu güvenlik tanımı kullanılmasını gerektirir. Bu, Haritalar yönetim API'sindenedinilebilir.
-
Authorization URL, Azure genel bulut örneğine özgüdür. Egemen bulutlar benzersiz Yetkilendirme URL'lerine ve Microsoft Entra ID yapılandırmalarına sahiptir. - Azure rol tabanlı erişim denetimi Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla
Azure yönetim düzleminden yapılandırılır. - Azure Haritalar Web SDK'sının kullanımı, bir uygulamanın birden çok kullanım örneği için yapılandırma tabanlı kurulumuna olanak tanır.
- Microsoft kimlik platformu hakkında daha fazla bilgi için bkz. Microsoft kimlik platformuna genel bakış.
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
| Veri Akışı Adı | Description |
|---|---|
| https://atlas.microsoft.com/.default |
subscription-key
Bu, Azure portalında Azure Haritalar hesabı oluşturma veya PowerShell, CLI, Azure SDK'ları veya REST API kullanarak sağlanan paylaşılan bir anahtardır.
Bu anahtarla, tüm uygulamalar tüm REST API'lere erişebilir. Başka bir deyişle, bu anahtar, verildikleri hesapta ana anahtar olarak kullanılabilir.
Herkese açık uygulamalar için, anahtarınızın güvenli bir şekilde depolanabilmesi için Azure Haritalar REST API'lerine erişmek için gizli istemci uygulamaları yaklaşımını kullanmanızı öneririz.
Tür:
apiKey
İçinde:
header
SAS Token
Bu paylaşılan erişim imzası belirteci, Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzlemi aracılığıyla Azure Haritalar kaynağı Sas Listeleme işleminden oluşturulur.
Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirteç için kullanım süre sonu, oran ve bölgelere ayrıntılı denetim ile erişim yetkisine sahiptir. Başka bir deyişle SAS Belirteci, uygulamaların erişimi paylaşılan anahtardan daha güvenli bir şekilde denetlemesine izin vermek için kullanılabilir.
Herkese açık uygulamalar için önerimiz, Eşleme hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmayı işleme kötüye kullanımını sınırlamak ve SAS Belirtecini düzenli olarak yenilemektir.
Tür:
apiKey
İçinde:
header
Örnekler
Get polygon for a city at coordinates -122.204141,47.612560
Örnek isteği
GET https://atlas.microsoft.com/search/polygon?api-version=2026-01-01&coordinates=-122.204141,47.61256&resultType=locality&resolution=small
Örnek yanıt
Content-Type: application/geo+json
{
"type": "Feature",
"geometry": {
"type": "GeometryCollection",
"geometries": [
{
"type": "Polygon",
"coordinates": [
[
[
-122.13035,
47.53502
],
[
-122.12882,
47.53567
],
[
-122.12638000000001,
47.535140000000006
],
[
-122.12378000000001,
47.53717
],
[
-122.12068000000001,
47.537620000000004
],
[
-122.12028000000001,
47.538000000000004
],
[
-122.11682,
47.537940000000006
],
[
-122.11527000000001,
47.53609
],
[
-122.11119000000001,
47.536080000000005
],
[
-122.11103000000001,
47.539280000000005
],
[
-122.10832,
47.539530000000006
],
[
-122.10830000000001,
47.54057
],
[
-122.11006,
47.54055
],
[
-122.10999000000001,
47.542640000000006
],
[
-122.11185,
47.54298000000001
],
[
-122.11183000000001,
47.54426
],
[
-122.1114,
47.543800000000005
],
[
-122.10936000000001,
47.54379
],
[
-122.10912,
47.54462
],
[
-122.10745000000001,
47.544830000000005
],
[
-122.10808000000002,
47.545190000000005
],
[
-122.10808000000002,
47.54656000000001
],
[
-122.10665000000002,
47.546580000000006
],
[
-122.10711,
47.544700000000006
],
[
-122.10530000000001,
47.54473
],
[
-122.1054,
47.546910000000004
],
[
-122.10434000000001,
47.54693
],
[
-122.10433,
47.544830000000005
],
[
-122.10056000000002,
47.544940000000004
],
[
-122.1007,
47.548500000000004
],
[
-122.10194000000001,
47.54849
],
[
-122.10194000000001,
47.54883
],
[
-122.10194000000001,
47.549510000000005
],
[
-122.10071,
47.54883
],
[
-122.10048,
47.54849
],
[
-122.10047000000002,
47.54883
],
[
-122.10038000000002,
47.55904
],
[
-122.09796000000001,
47.55923000000001
],
[
-122.09870000000001,
47.560570000000006
],
[
-122.09818000000001,
47.56248
],
[
-122.10011000000002,
47.56839
],
[
-122.09876000000001,
47.56884
],
[
-122.09942000000001,
47.569900000000004
],
[
-122.09782000000001,
47.56983
],
[
-122.09672,
47.58019
],
[
-122.09885000000001,
47.58666
],
[
-122.09796000000001,
47.59503
],
[
-122.09664000000001,
47.602230000000006
],
[
-122.09411000000001,
47.607240000000004
],
[
-122.09104,
47.610240000000005
],
[
-122.08366000000001,
47.615660000000005
],
[
-122.08008000000001,
47.61939
],
[
-122.07904,
47.62201
],
[
-122.07959000000001,
47.627520000000004
],
[
-122.08008000000001,
47.627520000000004
],
[
-122.09181000000001,
47.627520000000004
],
[
-122.09221000000001,
47.62717000000001
],
[
-122.09256,
47.627520000000004
],
[
-122.11094000000001,
47.62765
],
[
-122.11091,
47.636720000000004
],
[
-122.11091,
47.64609
],
[
-122.11431,
47.646060000000006
],
[
-122.11437000000001,
47.64533
],
[
-122.11597,
47.64374
],
[
-122.12254000000001,
47.638510000000004
],
[
-122.12542,
47.636720000000004
],
[
-122.12809000000001,
47.635200000000005
],
[
-122.13241000000001,
47.63515
],
[
-122.13234000000001,
47.63268
],
[
-122.13407000000001,
47.63156000000001
],
[
-122.13484000000001,
47.62935
],
[
-122.13626000000001,
47.62820000000001
],
[
-122.1372,
47.627860000000005
],
[
-122.14184000000002,
47.62787
],
[
-122.14321000000001,
47.62713
],
[
-122.14312000000001,
47.636720000000004
],
[
-122.14335000000001,
47.660590000000006
],
[
-122.1641,
47.66077000000001
],
[
-122.16453000000001,
47.646370000000005
],
[
-122.16797000000001,
47.64621
],
[
-122.19629,
47.64643
],
[
-122.19629,
47.64289
],
[
-122.19846000000001,
47.642860000000006
],
[
-122.19846000000001,
47.64242
],
[
-122.19982000000002,
47.6424
],
[
-122.20169000000001,
47.644600000000004
],
[
-122.20341,
47.643190000000004
],
[
-122.20818000000001,
47.6435
],
[
-122.21014000000001,
47.643130000000006
],
[
-122.20962000000002,
47.642920000000004
],
[
-122.20974000000001,
47.636720000000004
],
[
-122.21005000000001,
47.62107
],
[
-122.22268000000001,
47.62106000000001
],
[
-122.22268000000001,
47.62066
],
[
-122.22203,
47.620470000000005
],
[
-122.22282000000001,
47.619890000000005
],
[
-122.22142000000001,
47.618570000000005
],
[
-122.22248,
47.61838
],
[
-122.22271,
47.617200000000004
],
[
-122.22136,
47.617180000000005
],
[
-122.21985000000001,
47.61643
],
[
-122.22044000000001,
47.614470000000004
],
[
-122.22033,
47.603840000000005
],
[
-122.22043000000001,
47.59682
],
[
-122.21702,
47.59038
],
[
-122.21653,
47.59042
],
[
-122.21572,
47.588240000000006
],
[
-122.21067000000001,
47.58375
],
[
-122.20153,
47.57887
],
[
-122.20227000000001,
47.57864000000001
],
[
-122.20132000000001,
47.578770000000006
],
[
-122.20034000000001,
47.57822
],
[
-122.19901000000002,
47.57592
],
[
-122.19923000000001,
47.567460000000004
],
[
-122.20034000000001,
47.55962
],
[
-122.20072,
47.55966
],
[
-122.20114000000001,
47.557520000000004
],
[
-122.20119000000001,
47.54943
],
[
-122.20160000000001,
47.549440000000004
],
[
-122.20167000000001,
47.54883
],
[
-122.20200000000001,
47.54609000000001
],
[
-122.19676000000001,
47.54621
],
[
-122.19545000000001,
47.54609000000001
],
[
-122.19545000000001,
47.545750000000005
],
[
-122.19091000000002,
47.54580000000001
],
[
-122.1907,
47.54216
],
[
-122.18581,
47.542100000000005
],
[
-122.18116,
47.541140000000006
],
[
-122.17142000000001,
47.54086
],
[
-122.16987,
47.54008
],
[
-122.16797000000001,
47.540060000000004
],
[
-122.16554000000001,
47.54005
],
[
-122.16439000000001,
47.54281
],
[
-122.16433,
47.545480000000005
],
[
-122.15356000000001,
47.54538
],
[
-122.15359000000001,
47.541760000000004
],
[
-122.14280000000001,
47.541520000000006
],
[
-122.14288,
47.539370000000005
],
[
-122.13645000000001,
47.53826
],
[
-122.13035,
47.53502
]
],
[
[
-122.19957000000001,
47.58372000000001
],
[
-122.20448,
47.583830000000006
],
[
-122.20585000000001,
47.586780000000005
],
[
-122.19654000000001,
47.586740000000006
],
[
-122.19655000000002,
47.58379
],
[
-122.19957000000001,
47.58372000000001
]
]
]
}
]
},
"properties": {
"name": "Bellevue",
"copyright": "© 2022 Microsoft and its suppliers. This API and any results cannot be used or accessed without Microsoft's express written permission.",
"copyrightUrl": "https://azure.microsoft.com/en-us/support/legal/preview-supplemental-terms/",
"geometriesCopyright": [
{
"sourceName": "TOM",
"copyright": "TomTom"
}
]
}
}
Tanımlar
| Veri Akışı Adı | Description |
|---|---|
|
Azure. |
Hata nesnesi. |
|
Azure. |
Hata ayrıntılarını içeren bir yanıt. |
|
Azure. |
Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors. |
| Boundary |
Başarılı yanıt organı tarafından geri döndü. |
|
Boundary |
Bir |
|
Boundary |
Çağrılırken |
|
Feature |
|
|
Geo |
Geçerli bir |
|
Geo |
Geçerli bir |
|
Geo |
Geçerli bir |
|
Geo |
Geçerli bir |
|
Geo |
Geçerli bir |
|
Geo |
|
|
Geo |
Geçerli bir |
|
Geo |
Geçerli bir |
|
Geometry |
İçinde |
|
Resolution |
Çokgen için |
Azure.Core.Foundations.Error
Hata nesnesi.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| code |
string |
Sunucu tanımlı hata kodları kümesinden biri. |
| details |
Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı. |
|
| innererror |
Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne. |
|
| message |
string |
Hatanın insan tarafından okunabilir bir gösterimi. |
| target |
string |
Hatanın hedefi. |
Azure.Core.Foundations.ErrorResponse
Hata ayrıntılarını içeren bir yanıt.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| error |
Hata nesnesi. |
Azure.Core.Foundations.InnerError
Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| code |
string |
Sunucu tanımlı hata kodları kümesinden biri. |
| innererror |
İç hata. |
Boundary
Başarılı yanıt organı tarafından geri döndü.Get Polygon Bir GeoJSON FeaturegeometryPolygonGeometryCollectionMultiPolygon veya daha fazla şekilli olarak kodlanmış, istenen coğrafi alanın hatlarını tanımlayan ve properties bölgenin gösterim adını ve telif hakkı atıfını taşıyan bir kişidir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| geometry |
Koordinatları WGS 84 boylam/enlem sırasında, RFC 7946 tarafından tanımlandığı şekilde, istenen alanın hattını tanımlayan bir veya |
|
| properties |
Iade edilen alanın gösterim adı ve telif hakkı atıfı. Mülk başına şekil için bakınız |
|
| type |
Nesne |
BoundaryProperties
Bir propertiesBoundaryyük . Geri gönderilen coğrafi alanın gösterim adını, telif hakkı atıfı, hem API çapında bir bildirim hem de geometri başına veri sağlayıcı kredilerini taşır.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| copyright |
string |
Bu yanıta uygulanan Azure Haritalar API telif hakkı ve kullanım bildirimi. Geometri başına veri sağlayıcı atıflarından farklı. |
| copyrightUrl |
string |
API ve altında yatan veri kaynakları için Azure Haritalar telif hakkı ve lisanslama bilgilerine bir URL. |
| geometriesCopyright |
Geometri başına veri sağlayıcı atıfı. Her girdi, ana |
|
| name |
string |
Örneğin |
BoundaryResultTypeEnum
Çağrılırken Get Polygonistenen coğrafi hiyerarşi seviyesi . Değer, sorgu parametresi olarak resultType sağlanır ve geri dönen Boundary çokgenin idari veya posta hiyerarşisinin hangi seviyesini işaretlediğini seçer. Belirtilmediğinde varsayılan olarak countryRegion kullanılır.
| Değer | Description |
|---|---|
| countryRegion |
Bir ülke ya da bölge. |
| adminDistrict |
Ülke/bölge içinde ilk idari seviye, örneğin bir eyalet veya eyalet. |
| adminDistrict2 |
Ülke/bölge içinde ikinci idari seviye, örneğin bir ilçe. |
| postalCode |
Posta kodu gibi en küçük posta kodu kategorisi. |
| postalCode2 |
Bundan sonraki en büyük posta kodu kategorisi |
| postalCode3 |
Bundan sonraki en büyük posta kodu kategorisi |
| postalCode4 |
Bundan sonraki en büyük posta kodu kategorisi |
| neighborhood |
Nüfuslu bir yer içinde yerel olarak tanınan bir alan, genellikle gayri resmi veya kültürel olarak tanımlanmış sınırlara sahip bir alan. |
| locality |
Şehir, kasaba veya köy gibi insan yerleşiminin yoğunlaştığı bir alan. |
FeatureTypeEnum
GeoJSON Nesneler için Feature nesne türü. Yanıtın dizisindeki FeatureCollection her girişi features etiketler (coğrafi kodlama, ters coğrafi kodlama, otomatik tamamlama) ve yanıtın Get Polygon kökünde görünür. Tek değer, FeatureRFC 7946'da tanımlandığı gibi 'dir.
| Değer | Description |
|---|---|
| Feature |
Nesne |
GeoJsonGeometryCollection
Geçerli bir GeoJSON GeometryCollection nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| bbox |
number[] (double) |
Sınırlayıcı kutu. Projeksiyon kullanıldı - EPSG:3857. Ayrıntılar için lütfen RFC 7946 bakın. |
| geometries | GeoJsonGeometry[]: |
Geçerli |
| type |
string:
Geometry |
|
GeoJsonLineString
Geçerli bir GeoJSON LineString geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| bbox |
number[] (double) |
Sınırlayıcı kutu. Projeksiyon kullanıldı - EPSG:3857. Ayrıntılar için lütfen RFC 7946 bakın. |
| coordinates |
number[] (double) |
|
| type |
string:
Line |
|
GeoJsonMultiLineString
Geçerli bir GeoJSON MultiLineString geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| bbox |
number[] (double) |
Sınırlayıcı kutu. Projeksiyon kullanıldı - EPSG:3857. Ayrıntılar için lütfen RFC 7946 bakın. |
| coordinates |
number[] (double) |
|
| type |
string:
Multi |
|
GeoJsonMultiPoint
Geçerli bir GeoJSON MultiPoint geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| bbox |
number[] (double) |
Sınırlayıcı kutu. Projeksiyon kullanıldı - EPSG:3857. Ayrıntılar için lütfen RFC 7946 bakın. |
| coordinates |
number[] (double) |
|
| type |
string:
Multi |
|
GeoJsonMultiPolygon
Geçerli bir GeoJSON MultiPolygon nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| bbox |
number[] (double) |
Sınırlayıcı kutu. Projeksiyon kullanıldı - EPSG:3857. Ayrıntılar için lütfen RFC 7946 bakın. |
| coordinates |
number[] (double) |
Geçerli |
| type |
string:
Multi |
|
GeoJsonObjectType
GeoJSON türünü belirtir. Dokuz geçerli GeoJSON nesne türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature ve FeatureCollection.
| Değer | Description |
|---|---|
| Point |
geometriyi |
| MultiPoint |
geometriyi |
| LineString |
geometriyi |
| MultiLineString |
geometriyi |
| Polygon |
geometriyi |
| MultiPolygon |
geometriyi |
| GeometryCollection |
geometriyi |
| Feature |
|
| FeatureCollection |
|
GeoJsonPoint
Geçerli bir GeoJSON Point geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| bbox |
number[] (double) |
Sınırlayıcı kutu. Projeksiyon kullanıldı - EPSG:3857. Ayrıntılar için lütfen RFC 7946 bakın. |
| coordinates |
number[] (double) |
|
| type |
string:
Point |
|
GeoJsonPolygon
Geçerli bir GeoJSON Polygon geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| bbox |
number[] (double) |
Sınırlayıcı kutu. Projeksiyon kullanıldı - EPSG:3857. Ayrıntılar için lütfen RFC 7946 bakın. |
| coordinates |
number[] (double) |
|
| type |
string:
Polygon |
|
GeometryCopyright
İçinde BoundaryProperties.geometriesCopyrightgeometri başına tek bir veri sağlayıcı atıflama girişi. Ana dizideki bir geometrinin Boundary.geometry.geometries kaynağını belirler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| copyright |
string |
Veri sağlayıcısı için insan tarafından okunabilir atıf dizisi. Örneğin, |
| sourceName |
string |
Bu geometriyi sağlayan veri sağlayıcısının tanımlayıcısı. |
ResolutionEnum
Çokgen için Boundary kullanılan detay seviyesi ise .Get Polygon Sorgu parametresi olarak resolution sağlanan değer, sınırı sınırı işaret eden sayısını artan sırayla seçer: small, medium, large, huge. Daha yüksek seviyeler, bir sonraki alt seviyeyle aynı veya daha fazla puan kullanır. Belirtilmediğinde varsayılan olarak medium kullanılır.
| Değer | Description |
|---|---|
| small |
Sınır geometrisini en az noktaya sahip döndürür. |
| medium |
Sınır geometrisini aynı sayıda veya daha fazla nokta |
| large |
Sınır geometrisini aynı sayıda veya daha fazla nokta |
| huge |
Sınır geometrisini aynı sayıda veya daha fazla nokta |