Search - Get Polygon
Şehir veya ülke bölgesi gibi coğrafi alan şeklinin çokgen verilerini almak için kullanın.
Get Polygon
API, şehir veya ülke bölgesi gibi coğrafi bir alan ana hattının çokgen verilerini sağlayan bir HTTP GET
isteğidir.
GET https://atlas.microsoft.com/search/polygon?api-version=2023-06-01&coordinates={coordinates}
GET https://atlas.microsoft.com/search/polygon?api-version=2023-06-01&coordinates={coordinates}&view={view}&resultType={resultType}&resolution={resolution}
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
api-version
|
query | True |
string |
Azure Haritalar API'sinin sürüm numarası. |
coordinates
|
query | True |
number[] |
Dünyada boylam ve enlem olarak belirtilen bir nokta. Örnek: &koordinatları=lon,lat |
resolution
|
query |
Çözüm, geri gönderilecek nokta miktarını belirler. Belirtilmezse, varsayılan orta çözünürlük olur. |
||
result
|
query |
Sınır döndürmek için jeopolitik kavram. Belirtilmezse, varsayılan |
||
view
|
query |
string |
ISO 3166-1 Alfa-2 bölge/ülke kodunu temsil 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'e bakın. |
İstek Başlığı
Name | Gerekli | Tür | Description |
---|---|---|---|
x-ms-client-id |
string |
Hangi hesabın Azure AD güvenlik modeliyle birlikte kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'de Azure AD güvenliği kullanmak için rehberlik için aşağıdaki makalelere bakın. |
|
Accept-Language |
string |
Arama sonuçlarının döndürülmesi gereken dil. Ayrıntılar için lütfen Desteklenen Diller'e bakın. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam Media Types: "application/geo+json" |
|
Other Status Codes |
Beklenmeyen bir hata oluştu. Media Types: "application/geo+json" |
Güvenlik
AADToken
Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim denetimiyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi denetlemek için kullanılabilir. Azure rol tabanlı erişim denetimleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağa erişim tanımlamak 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 kimlik doğrulama kavramlarını görüntülemenizi öneririz. Özetle, bu güvenlik tanımı belirli API'ler ve kapsamlar üzerinde erişim denetimi yapabilen nesneler aracılığıyla uygulamaları modellemek için bir çözüm sağlar.
Not
- Bu güvenlik tanımı, uygulamanın erişim istediği Azure Haritalar kaynağı belirtmek için üst bilgi kullanımını
x-ms-client-id
gerektirir. Bu, Haritalar yönetim API'sinden alınabilir. Authorization URL
, Azure genel bulut örneğine özgüdür. Bağımsız bulutların benzersiz Yetkilendirme URL'leri ve Microsoft Entra ID yapılandırmaları vardır.- 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 platformu genel bakış.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Bu, 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ğı oluştururken sağlanan paylaşılan bir anahtardır.
Bu anahtarla, tüm uygulamalar tüm REST API'lerine erişim yetkisine sahip olur. Başka bir deyişle, bunlar şu anda verildikleri hesabın ana anahtarları olarak değerlendirilebilir.
Herkese açık uygulamalar için önerimiz, bu anahtarın güvenli bir şekilde depolanabileceği Azure Haritalar REST API'lerinin sunucudan sunucuya erişiminin kullanılmasıdır.
Type:
apiKey
In:
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ğındaki 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ölgeler için ayrıntılı denetim ile erişim yetkisine sahip olur. Başka bir deyişle SAS Belirteci, uygulamaların paylaşılan anahtardan daha güvenli bir şekilde erişimi denetlemesine izin vermek için kullanılabilir.
Herkese açık uygulamalar için önerimiz, işleme kötüye kullanımını sınırlamak ve SAS Belirtecini düzenli olarak yenilemek için Harita hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmayı önermektedir.
Type:
apiKey
In:
header
Örnekler
Get polygon for a city at coordinates -122.204141,47.612560
Sample Request
GET https://atlas.microsoft.com/search/polygon?api-version=2023-06-01&coordinates=-122.204141,47.61256&resultType=locality&resolution=small
Sample Response
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
Name | Description |
---|---|
Boundary |
Hizmetin genellikle Polygon veya MultiPolygon alt türlerine sahip bir GeometryCollection döndürdüğüne dikkat edin. |
Boundary |
Sınır döndürmek için jeopolitik kavram. Belirtilmezse, varsayılan sonuç türüdür |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı |
Geo |
Geçerli |
Geo |
Geçerli |
Geo |
Geçerli |
Geo |
Geçerli |
Geo |
Geçerli |
Geo |
Geçerli |
Geo |
Geçerli |
Geo |
Geçerli |
Geometry |
Sınır nesnesinin geometrisinin telif hakkı bilgileri. |
Resolution |
Çözüm, geri gönderilecek nokta miktarını belirler. Belirtilmezse, varsayılan orta çözünürlük olur. |
Boundary
GeoJSON GeocodingFeature
bir coğrafi alanın sınırlarını açıklayan nesne. Özelliğin geometrisi ile GeoJSON GeometryCollection
açıklanmıştır.
Hizmetin genellikle Polygon veya MultiPolygon alt türlerine sahip bir GeometryCollection döndürdüğüne dikkat edin.
Name | Tür | Description |
---|---|---|
bbox |
number[] |
Sınırlayıcı kutu. Kullanılan projeksiyon - EPSG:3857. Ayrıntılar için lütfen RFC 7946'ya bakın. |
copyright |
string |
Telif hakkı dizesi. |
copyrightURL |
string |
Azure Haritalar için veri sağlayıcılarının çoğunu ve ilgili telif hakkı bilgilerini listeleyen bir URL. |
featureType |
string |
Özelliğin türü. Değer, geçerli özelliğin parçası olduğu veri modeline bağlıdır. Bazı veri modellerinin değeri boş olabilir. |
geometriesCopyright |
Sınır nesnesinin her geometrisi için, göründükleri sırayla telif hakkı bilgileri koleksiyonu. |
|
geometry | GeoJsonGeometry: |
Geçerli |
id |
string |
Özelliğin tanımlayıcısı. |
name |
string |
Coğrafi alanla ilişkili ad. |
type |
string:
Feature |
|
BoundaryResultTypeEnum
Sınır döndürmek için jeopolitik kavram. Belirtilmezse, varsayılan sonuç türüdür countryRegion
.
Name | Tür | Description |
---|---|---|
adminDistrict |
string |
Eyalet veya il gibi ülke/bölge düzeyindeki ilk yönetim düzeyi. |
adminDistrict2 |
string |
Ülke/bölge düzeyinde ikinci yönetim düzeyi, örneğin bir ilçe. |
countryRegion |
string |
Ülke veya bölge. |
locality |
string |
şehir, kasaba veya köy gibi insan yerleşiminin yoğun bir alanı. |
neighborhood |
string |
Doldurulan bir yerin genellikle iyi bilinen, ancak genellikle ayırt etmeyen sınırları olan bir bölümü. |
postalCode |
string |
Posta kodu gibi en küçük posta kodu kategorisi. |
postalCode2 |
string |
postalCode alanlarını toplayarak oluşturulan posta kodundan sonraki en büyük posta kodu kategorisi. |
postalCode3 |
string |
postalCode2 alanlarını toplayarak oluşturulan postakod2'nin ardından gelen sonraki en büyük posta kodu kategorisi. |
postalCode4 |
string |
postalCode3 alanlarının toplanarak oluşturulan postakod3'e göre sonraki en büyük posta kodu kategorisi. |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
GeoJsonGeometry
Geçerli GeoJSON
bir geometri nesnesi. Tür yedi geçerli GeoJSON geometri türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon ve GeometryCollection. Ayrıntılar için lütfen RFC 7946'ya bakın.
Name | Tür | Description |
---|---|---|
bbox |
number[] |
Sınırlayıcı kutu. Kullanılan projeksiyon - EPSG:3857. Ayrıntılar için lütfen RFC 7946'ya bakın. |
type |
Geo |
|
GeoJsonGeometryCollection
Geçerli GeoJSON GeometryCollection
bir nesne türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
Name | Tür | Description |
---|---|---|
bbox |
number[] |
Sınırlayıcı kutu. Kullanılan projeksiyon - EPSG:3857. Ayrıntılar için lütfen RFC 7946'ya bakın. |
geometries | GeoJsonGeometry[]: |
Geçerli |
type |
string:
Geometry |
|
GeoJsonLineString
Geçerli GeoJSON LineString
bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
Name | Tür | Description |
---|---|---|
bbox |
number[] |
Sınırlayıcı kutu. Kullanılan projeksiyon - EPSG:3857. Ayrıntılar için lütfen RFC 7946'ya bakın. |
coordinates |
number[] |
Geometrinin |
type |
string:
Line |
|
GeoJsonMultiLineString
Geçerli GeoJSON MultiLineString
bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
Name | Tür | Description |
---|---|---|
bbox |
number[] |
Sınırlayıcı kutu. Kullanılan projeksiyon - EPSG:3857. Ayrıntılar için lütfen RFC 7946'ya bakın. |
coordinates |
number[] |
Geometrinin |
type |
string:
Multi |
|
GeoJsonMultiPoint
Geçerli GeoJSON MultiPoint
bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
Name | Tür | Description |
---|---|---|
bbox |
number[] |
Sınırlayıcı kutu. Kullanılan projeksiyon - EPSG:3857. Ayrıntılar için lütfen RFC 7946'ya bakın. |
coordinates |
number[] |
Geometrinin |
type |
string:
Multi |
|
GeoJsonMultiPolygon
Geçerli GeoJSON MultiPolygon
bir nesne türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
Name | Tür | Description |
---|---|---|
bbox |
number[] |
Sınırlayıcı kutu. Kullanılan projeksiyon - EPSG:3857. Ayrıntılar için lütfen RFC 7946'ya bakın. |
coordinates |
number[] |
Geçerli |
type |
string:
Multi |
|
GeoJsonPoint
Geçerli GeoJSON Point
bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
Name | Tür | Description |
---|---|---|
bbox |
number[] |
Sınırlayıcı kutu. Kullanılan projeksiyon - EPSG:3857. Ayrıntılar için lütfen RFC 7946'ya bakın. |
coordinates |
number[] |
A |
type |
string:
Point |
|
GeoJsonPolygon
Geçerli GeoJSON Polygon
bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
Name | Tür | Description |
---|---|---|
bbox |
number[] |
Sınırlayıcı kutu. Kullanılan projeksiyon - EPSG:3857. Ayrıntılar için lütfen RFC 7946'ya bakın. |
coordinates |
number[] |
Geometri türü için |
type |
string:
Polygon |
|
GeometryCopyright
Sınır nesnesinin geometrisinin telif hakkı bilgileri.
Name | Tür | Description |
---|---|---|
copyright |
string |
Veri sağlayıcısı için telif hakkı dizesi |
sourceName |
string |
Veri sağlayıcısının adı |
ResolutionEnum
Çözüm, geri gönderilecek nokta miktarını belirler. Belirtilmezse, varsayılan orta çözünürlük olur.
Name | Tür | Description |
---|---|---|
huge |
string |
Sınır geometrisini daha fazla veya aynı miktarda noktayla döndür. |
large |
string |
Sınır geometrisini orta değerle daha fazla veya aynı miktarda noktayla döndürür. |
medium |
string |
Sınır geometrisini küçük olan daha fazla veya aynı miktarda noktayla döndür. |
small |
string |
Sınır geometrisini en az nokta miktarıyla döndürür. |