Search - Get Reverse Geocoding
Boylam ve enlem koordinatlarından sokak adresi ve konum bilgilerini almak için kullanın.
Get Reverse Geocoding
API, bir koordinatı (örnek: 37.786505, -122.3862) insan tarafından anlaşılabilen bir açık adrese çevirmek için kullanılan bir HTTP GET
isteğidir. Cihazdan veya varlıktan BIR GPS akışı aldığınız ve koordinatlarla ilişkili adresi bilmek istediğiniz uygulamaları izlemede yararlıdır. Bu uç nokta, belirli bir koordinat için adres bilgilerini döndürür.
GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={coordinates}
GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={coordinates}&resultTypes={resultTypes}&view={view}
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[] |
Coğrafi kodu tersine çevirmek istediğiniz konumun koordinatları. Örnek: &koordinatları=lon,lat |
result
|
query |
Yanıtta olmasını istediğiniz varlık türlerini belirtin. Yalnızca belirttiğiniz türler döndürülür. Nokta belirttiğiniz varlık türleriyle eşlenemiyorsa, yanıtta hiçbir konum bilgisi döndürülemez. Varsayılan değer tüm olası varlıklardır. Aşağıdaki seçeneklerden seçilen varlık türlerinin virgülle ayrılmış listesi.
Bu varlık türleri en belirli varlıktan en az belirli varlığa sıralanır. Birden fazla varlık türündeki varlıklar bulunduğunda, yalnızca en belirli varlık döndürülür. Örneğin, varlık türleri olarak Address ve AdminDistrict1 belirtirseniz ve her iki tür için de varlıklar bulunursa, yanıtta yalnızca Adres varlık bilgileri döndürülür. |
||
view
|
query |
string |
ISO 3166-1 Alfa-2 bölge/ülke kodunu temsil eden bir dize. Bu işlem Jeopolitik olarak tartışmalı 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'da Azure AD güvenliği kullanmak için kılavuz 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ğına erişimi tanımlamak için kullanılır. Herhangi bir kullanıcı, grup veya hizmet sorumlusuna yerleşik bir rol veya REST API'lerini Azure Haritalar 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ı modellemeye yönelik bir çözüm sağlar.
Not
- Bu güvenlik tanımı, uygulamanın erişim isteğinde
x-ms-client-id
bulunduğu Azure Haritalar kaynağı belirtmek için üst bilginin kullanılmasını gerektirir. Bu, Haritalar yönetim API'sinden edinilebilir. 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 kabul edilebilir.
Genel kullanıma sunulan uygulamalar için önerimiz, bu anahtarın güvenli bir şekilde depolanabildiğ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 belirtecin kullanım süresi, oranı ve bölgelerine yönelik ayrıntılı denetim ile erişim yetkisine sahip olur. 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, uygunsuz işlemeyi 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ırmanızdır.
Type:
apiKey
In:
header
Örnekler
Search point -122.138681, 47.630358
Sample Request
GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates=-122.138681,47.630358
Sample Response
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"address": {
"countryRegion": {
"name": "United States"
},
"adminDistricts": [
{
"shortName": "WA"
},
{
"shortName": "King County"
}
],
"formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
"locality": "Redmond",
"postalCode": "98052",
"addressLine": "15127 NE 24th St"
},
"type": "Address",
"confidence": "Medium",
"matchCodes": [
"Good"
],
"geocodePoints": [
{
"geometry": {
"type": "Point",
"coordinates": [
-122.138681,
47.630358
]
},
"calculationMethod": "Rooftop",
"usageTypes": [
"Display"
]
},
{
"geometry": {
"type": "Point",
"coordinates": [
-122.1386787,
47.6302179
]
},
"calculationMethod": "Rooftop",
"usageTypes": [
"Route"
]
}
]
},
"geometry": {
"type": "Point",
"coordinates": [
-122.138681,
47.630358
]
},
"bbox": [
-122.14632282407,
47.626495282429325,
-122.13103917593001,
47.63422071757068
]
}
]
}
Tanımlar
Name | Description |
---|---|
Address |
Sonucun adresi |
Admin |
Bir adresin ülke veya bölgedeki alt bölüm adı. Bu öğe genellikle ilk sıra yönetim alt bölümü olarak kabul edilir, ancak bazı durumlarda bir ülke, bağımlılık veya bölgedeki ikinci, üçüncü veya dördüncü sıra alt bölümünü de içerir. |
Calculation |
Coğrafi kod noktasını hesaplamak için kullanılan yöntem. |
Confidence |
Coğrafi olarak kodlanmış konum sonucunun eşleşmesi güven düzeyi. Eşleştirme hakkında daha eksiksiz bilgi için bu değeri eşleştirme koduyla kullanın. Coğrafi olarak kodlanmış bir konumun güvenilirliği, coğrafi olarak kodlanmış konumun ve belirtildiyse kullanıcının konumunun göreli önemi de dahil olmak üzere birçok faktöre bağlıdır. |
Country |
|
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı |
Feature |
FeatureCollection nesnesinin türü FeatureCollection olmalıdır. |
Features |
|
Feature |
Özelliğin türü Özellik olmalıdır. |
Geocode |
Hesaplanma şekli ve önerilen kullanımları bakımından farklılık gösteren coğrafi kod noktaları koleksiyonu. |
Geocoding |
Bu nesne başarılı bir Coğrafi Kodlama çağrısından döndürülür |
Geo |
Geçerli |
Intersection |
Sonucun adresi. |
Match |
Yanıttaki her konumun coğrafi kodlama düzeyini temsil eden bir veya daha fazla eşleşme kodu değeri. Örneğin, eşleşme kodları Benzer şekilde, eşleşme kodları Olası değerler şunlardır:
|
Properties | |
Reverse |
Yanıtta olmasını istediğiniz varlık türlerini belirtin. Yalnızca belirttiğiniz türler döndürülür. Nokta belirttiğiniz varlık türleriyle eşlenemiyorsa, yanıtta hiçbir konum bilgisi döndürülemez. Varsayılan değer tüm olası varlıklardır. Aşağıdaki seçeneklerden seçilen varlık türlerinin virgülle ayrılmış listesi.
Bu varlık türleri en belirli varlıktan en az belirli varlığa sıralanır. Birden fazla varlık türündeki varlıklar bulunduğunda, yalnızca en belirli varlık döndürülür. Örneğin, varlık türleri olarak Address ve AdminDistrict1 belirtirseniz ve her iki tür için de varlıklar bulunursa, yanıtta yalnızca Adres varlık bilgileri döndürülür. |
Usage |
Coğrafi kod noktası için en iyi kullanım.
Her coğrafi kod noktası nokta |
Address
Sonucun adresi
Name | Tür | Description |
---|---|---|
addressLine |
string |
Sokak Adı ve Numarası içeren Adres Çizgisi |
adminDistricts |
Bir adresin ülke veya bölgedeki alt bölüm adı. Bu öğe genellikle ilk sıra yönetim alt bölümü olarak kabul edilir, ancak bazı durumlarda bir ülke, bağımlılık veya bölgedeki ikinci, üçüncü veya dördüncü sıra alt bölümünü de içerir. |
|
countryRegion | ||
formattedAddress |
string |
Biçimlendirilmiş Adres özelliği |
intersection |
Sonucun adresi. |
|
locality |
string |
locality özelliği |
neighborhood |
string |
mahalle mülkiyeti |
postalCode |
string |
Posta Kodu özelliği |
AdminDistricts
Bir adresin ülke veya bölgedeki alt bölüm adı. Bu öğe genellikle ilk sıra yönetim alt bölümü olarak kabul edilir, ancak bazı durumlarda bir ülke, bağımlılık veya bölgedeki ikinci, üçüncü veya dördüncü sıra alt bölümünü de içerir.
Name | Tür | Description |
---|---|---|
name |
string |
Karşılık gelen adminDistrict alanının adı olan adminDistrict için[0], bu, Washington, For adminDistrict[1] gibi bir eyaletin tam adı olabilir; bu, ilçenin tam adı olabilir |
shortName |
string |
karşılık gelen adminDistrict alanının kısa adı olan adminDistrict için[0], wa, for adminDistrict[1] gibi kısa bir durum adı olabilir; bu, ilçenin kısa adı olabilir |
CalculationMethodEnum
Coğrafi kod noktasını hesaplamak için kullanılan yöntem.
Name | Tür | Description |
---|---|---|
Interpolation |
string |
Coğrafi kod noktası, ilişkilendirme kullanılarak yoldaki bir noktayla eşleştirildi. |
InterpolationOffset |
string |
Coğrafi kod noktası, noktayı caddenin kenarına kaydırmak için ek bir uzaklık ile ilişkilendirme kullanılarak yol üzerindeki bir noktayla eşleştirildi. |
Parcel |
string |
Coğrafi kod noktası bir parselin merkeziyle eşleşti. |
Rooftop |
string |
Coğrafi kod noktası bir binanın çatısı ile eşleşti. |
ConfidenceEnum
Coğrafi olarak kodlanmış konum sonucunun eşleşmesi güven düzeyi. Eşleştirme hakkında daha eksiksiz bilgi için bu değeri eşleştirme koduyla kullanın.
Coğrafi olarak kodlanmış bir konumun güvenilirliği, coğrafi olarak kodlanmış konumun ve belirtildiyse kullanıcının konumunun göreli önemi de dahil olmak üzere birçok faktöre bağlıdır.
Name | Tür | Description |
---|---|---|
High |
string |
Güvenilirlik olarak ayarlandıysa bir istek bir konum veya görünüm içeriyorsa, sıralama uygun şekilde değişebilir. Örneğin, "Paris" için konum sorgusu "Paris, Fransa" ve "Paris, TX" ifadelerini |
Low |
string |
|
Medium |
string |
Bazı durumlarda, döndürülen eşleşme istekte sağlanan bilgilerle aynı düzeyde olmayabilir. Örneğin, bir istek adres bilgilerini belirtebilir ve coğrafi kod hizmeti yalnızca posta koduyla eşleşebilir. Bu durumda, coğrafi kod hizmeti posta kodunun verilerle eşleştiğinden eminse, güvenilirlik olarak ayarlanır Sorgudaki konum bilgileri belirsizse ve konumları sıralamak için ek bilgi yoksa (kullanıcı konumu veya konumun göreli önemi gibi), güvenilirlik olarak Sorgudaki konum bilgileri belirli bir konumu coğrafi olarak kodlamak için yeterli bilgi sağlamıyorsa, daha az kesin bir konum değeri döndürülebilir ve güvenilirlik olarak |
CountryRegion
Name | Tür | Description |
---|---|---|
ISO |
string |
Ülke/bölge ISO'sunun |
name |
string |
ülke/bölge adı |
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. |
FeatureCollectionEnum
FeatureCollection nesnesinin türü FeatureCollection olmalıdır.
Name | Tür | Description |
---|---|---|
FeatureCollection |
string |
FeaturesItem
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. |
geometry |
Geçerli |
|
id |
string |
Döndürülen özelliğin kimliği |
properties | ||
type |
Özelliğin türü Özellik olmalıdır. |
FeatureTypeEnum
Özelliğin türü Özellik olmalıdır.
Name | Tür | Description |
---|---|---|
Feature |
string |
GeocodePoints
Hesaplanma şekli ve önerilen kullanımları bakımından farklılık gösteren coğrafi kod noktaları koleksiyonu.
Name | Tür | Description |
---|---|---|
calculationMethod |
Coğrafi kod noktasını hesaplamak için kullanılan yöntem. |
|
geometry |
Geçerli |
|
usageTypes |
Coğrafi kod noktası için en iyi kullanım.
Her coğrafi kod noktası nokta |
GeocodingResponse
Bu nesne başarılı bir Coğrafi Kodlama çağrısından döndürülür
Name | Tür | Description |
---|---|---|
features | ||
nextLink |
string |
, döndürülen özelliklerin sonraki sayfasının bağlantısıdır. Bu son sayfaysa, bu alan yok. |
type |
FeatureCollection nesnesinin türü FeatureCollection olmalıdır. |
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 |
|
Intersection
Sonucun adresi.
Name | Tür | Description |
---|---|---|
baseStreet |
string |
Konum için birincil cadde. |
displayName |
string |
Kesişimin tam adı. |
intersectionType |
string |
Kesişim türü. |
secondaryStreet1 |
string |
kesişen ilk sokak. |
secondaryStreet2 |
string |
Eğer varsa, ikinci kesişen sokak. |
MatchCodesEnum
Yanıttaki her konumun coğrafi kodlama düzeyini temsil eden bir veya daha fazla eşleşme kodu değeri.
Örneğin, eşleşme kodları Good
olan coğrafi kodlu bir konum ve Ambiguous
konum bilgileri için birden fazla coğrafi kod konumu bulunduğu ve coğrafi kod hizmetinin eşleşme bulmak için yukarı hiyerarşide arama yapmadığı anlamına gelir.
Benzer şekilde, eşleşme kodları Ambiguous
olan coğrafi kodlu bir konum ve UpHierarchy
belirtilen tüm konum bilgileriyle eşleşen bir coğrafi kod konumunun bulunamadığını gösterir, bu nedenle coğrafi kod hizmetinin hiyerarşiyi araması gerekiyordu ve bu düzeyde birden çok eşleşme buldu. Ve sonucunun Ambiguous
UpHierarchy
bir örneği, tam adres bilgilerini sağladığınızda, ancak coğrafi kod hizmeti sokak adresi için bir eşleşme bulamadığınızda ve bunun yerine birden fazla RoadBlock değeri için bilgi döndürdüğünde ortaya çıkar.
Olası değerler şunlardır:
Good
: Konumda yalnızca bir eşleşme var veya döndürülen tüm eşleşmeler güçlü eşleşmeler olarak kabul edilir. Örneğin, New York sorgusu birkaç İyi eşleşme döndürür.
Ambiguous
: Konum, olası eşleşme kümelerinden biridir. Örneğin, 128 Main St. sokak adresini sorguladığınızda, hangi seçeneğin seçileceğini belirlemek için yeterli bilgi olmadığından, yanıt 128 Kuzey Ana Cadde ve 128 Güney Ana Cadde için iki konum döndürebilir.
UpHierarchy
: Konum, coğrafi hiyerarşide yukarı taşımayı temsil eder. Bu, konum isteği için bir eşleşme bulunamadığında oluşur, bu nedenle daha az kesin bir sonuç döndürülür. Örneğin, istenen adres için eşleşme bulunamazsa, RoadBlock varlık türüne sahip eşleşme kodu UpHierarchy
döndürülebilir.
Name | Tür | Description |
---|---|---|
Ambiguous |
string |
|
Good |
string |
|
UpHierarchy |
string |
Properties
Name | Tür | Description |
---|---|---|
address |
Sonucun adresi |
|
confidence |
Coğrafi olarak kodlanmış konum sonucunun eşleşmesi güven düzeyi. Eşleştirme hakkında daha eksiksiz bilgi için bu değeri eşleştirme koduyla kullanın. Coğrafi olarak kodlanmış bir konumun güvenilirliği, coğrafi olarak kodlanmış konumun ve belirtildiyse kullanıcının konumunun göreli önemi de dahil olmak üzere birçok faktöre bağlıdır. |
|
geocodePoints |
Hesaplanma şekli ve önerilen kullanımları bakımından farklılık gösteren coğrafi kod noktaları koleksiyonu. |
|
matchCodes |
Yanıttaki her konumun coğrafi kodlama düzeyini temsil eden bir veya daha fazla eşleşme kodu değeri. Örneğin, eşleşme kodları Benzer şekilde, eşleşme kodları Olası değerler şunlardır:
|
|
type |
string |
Bunlardan biri:
|
ReverseGeocodingResultTypeEnum
Yanıtta olmasını istediğiniz varlık türlerini belirtin. Yalnızca belirttiğiniz türler döndürülür. Nokta belirttiğiniz varlık türleriyle eşlenemiyorsa, yanıtta hiçbir konum bilgisi döndürülemez. Varsayılan değer tüm olası varlıklardır. Aşağıdaki seçeneklerden seçilen varlık türlerinin virgülle ayrılmış listesi.
- Adres
- Mahalle
- Doldurulan Yer
- Posta kodu1
- AdminDivision1
- AdminDivision2
- CountryRegion
Bu varlık türleri en belirli varlıktan en az belirli varlığa sıralanır. Birden fazla varlık türündeki varlıklar bulunduğunda, yalnızca en belirli varlık döndürülür. Örneğin, varlık türleri olarak Address ve AdminDistrict1 belirtirseniz ve her iki tür için de varlıklar bulunursa, yanıtta yalnızca Adres varlık bilgileri döndürülür.
Name | Tür | Description |
---|---|---|
Address |
string |
|
AdminDivision1 |
string |
|
AdminDivision2 |
string |
|
CountryRegion |
string |
|
Neighborhood |
string |
|
PopulatedPlace |
string |
|
Postcode1 |
string |
UsageTypeEnum
Coğrafi kod noktası için en iyi kullanım.
Her coğrafi kod noktası nokta Route
, Display
nokta veya her ikisi olarak tanımlanır.
Konuma bir yol oluşturuyorsanız noktaları kullanın Route
. Konumu haritada gösteriyorsanız noktaları kullanın Display
. Örneğin, konum bir parksa, bir Route
nokta parka arabayla girebileceğiniz bir giriş belirtebilir ve nokta Display
, parkın merkezini belirten bir nokta olabilir.
Name | Tür | Description |
---|---|---|
Display |
string |
|
Route |
string |