Search - Get Search Address Reverse Cross Street
Enlem ve boylam koordinatlarından caddeler arası konum bilgisi almak için kullanın.
Get Search Address Reverse Cross Street
API, enlem ve boylam koordinatları verildiğinde en yakın çapraz caddeyi döndüren bir HTTP GET
isteğidir. Bir koordinatı (örnek: 37.786505, -122.3862) insan tarafından anlaşılabilen bir caddeye çevirmeniz gereken zamanlar olabilir. Çoğu zaman bu, cihazdan veya varlıktan BIR GPS akışı aldığınız ve koordinatın bulunduğu adresi bilmek istediğiniz uygulamaları izlemede gereklidir.
Bu uç nokta, belirli bir koordinat için caddeler arası bilgileri döndürür.
GET https://atlas.microsoft.com/search/address/reverse/crossStreet/{format}?api-version=1.0&query={query}
GET https://atlas.microsoft.com/search/address/reverse/crossStreet/{format}?api-version=1.0&query={query}&limit={limit}&heading={heading}&radius={radius}&language={language}&view={view}
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
format
|
path | True |
Response |
Yanıtın istenen biçimi. Değer json veya xml olabilir. |
api-version
|
query | True |
string |
Azure Haritalar API'sinin sürüm numarası. |
query
|
query | True |
number[] |
Enlem ve ardından "47.641268,-122.125679" gibi boylamlardan oluşan virgülle ayrılmış bir dize olarak belirtilen geçerli sorgu. |
heading
|
query |
integer |
Bir yol segmenti boyunca seyahat etmek için aracın derece olarak yön başlığı. 0 Kuzey, 90 Doğu vb. değerler -360 ile 360 arasında değişir. Duyarlık en fazla bir ondalık basamak içerebilir |
|
language
|
query |
string |
Arama sonuçlarının döndürülmesi gereken dil. Büyük/küçük harfe duyarsız, desteklenen IETF dil etiketlerinden biri olmalıdır. Belirtilen dildeki veriler belirli bir alan için kullanılabilir olmadığında, varsayılan dil kullanılır. Ayrıntılar için lütfen Desteklenen Diller'e bakın. |
|
limit
|
query |
integer |
Döndürülecek en fazla yanıt sayısı. Varsayılan: 10, en az: 1 ve maksimum: 100 |
|
radius
|
query |
integer |
Sonuçların tanımlı alanla kısıtlanması için metre cinsinden yarıçap |
|
view
|
query |
Localized |
View parametresi ("kullanıcı bölgesi" parametresi olarak da adlandırılır), coğrafi olarak tartışmalı bölgeler için belirli bir ülke/bölge için doğru haritaları göstermenizi sağlar. Farklı ülkelerin/bölgelerin bu tür bölgelerin farklı görünümleri vardır ve View parametresi uygulamanızın, uygulamanızın hizmet verecek olduğu ülke/bölge için gereken görünümle uyumlu olmasını sağlar. Varsayılan olarak, görünüm parametresi istekte tanımlamamış olsanız bile "Birleştirilmiş" olarak ayarlanır. Kullanıcılarınızın konumunu belirlemek ve ardından bu konum için View parametresini doğru ayarlamak sizin sorumluluğunuzdadır. Alternatif olarak, isteğin IP adresine göre harita verilerini döndürecek olan 'View=Auto' ayarını da belirleyebilirsiniz. Azure Haritalar'de View parametresi, haritaların, görüntülerin ve diğer verilerin ve Azure Haritalar üzerinden erişim yetkisine sahip olduğunuz üçüncü taraf içeriğinin bulunduğu ülkenin/bölgenin haritalanmasıyla ilgili olanlar da dahil olmak üzere geçerli yasalara uygun olarak kullanılmalıdır. Örnek: view=IN. 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 Microsoft Entra ID 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 Microsoft Entra ID güvenliği kullanmak için rehberlik için aşağıdaki makalelere bakın. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Reverse |
Tamam |
Other Status Codes |
Error |
Beklenmeyen bir hata oluştu. |
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 Azure Haritalar hesabı oluşturduğunuzda veya PowerShell, CLI, Azure SDK'ları veya REST API'sini kullandığınızda 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 gizli istemci uygulamaları yaklaşımını kullanarak Azure Haritalar REST API'lerine erişmenizi öneririz.
Type:
apiKey
In:
query
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
Search address of the nearest intersection/crossroad
Sample Request
GET https://atlas.microsoft.com/search/address/reverse/crossStreet/json?api-version=1.0&query=37.337,-121.89
Sample Response
{
"summary": {
"numResults": 1,
"queryTime": 41
},
"addresses": [
{
"address": {
"streetName": "East Santa Clara Street & North 2nd Street",
"crossStreet": "East Santa Clara Street",
"municipalitySubdivision": "San Jose, Downtown San Jose",
"municipality": "San Jose",
"countrySecondarySubdivision": "Santa Clara",
"countryTertiarySubdivision": "San Jose",
"countrySubdivisionCode": "CA",
"postalCode": "95113",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "East Santa Clara Street & North 2nd Street, San Jose, CA 95113",
"countrySubdivisionName": "California"
},
"position": "37.33666,-121.88951"
}
]
}
Tanımlar
Name | Description |
---|---|
Address |
Sonucun adresi |
Bounding |
Konumun sınırlayıcı kutusu. |
Entity |
Sınırlayıcı kutunun varlık türü kaynağı. Ters coğrafi kodlama için bu her zaman konuma eşittir. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı |
Lat |
'lon' & 'lat' kısa adları kullanılarak enlem ve boylam olarak temsil edilen konum. |
Localized |
View parametresi ("kullanıcı bölgesi" parametresi olarak da adlandırılır), coğrafi olarak tartışmalı bölgeler için belirli bir ülke/bölge için doğru haritaları göstermenizi sağlar. Farklı ülkelerin/bölgelerin bu tür bölgelerin farklı görünümleri vardır ve View parametresi uygulamanızın, uygulamanızın hizmet verecek olduğu ülke/bölge için gereken görünümle uyumlu olmasını sağlar. Varsayılan olarak, görünüm parametresi istekte tanımlamamış olsanız bile "Birleştirilmiş" olarak ayarlanır. Kullanıcılarınızın konumunu belirlemek ve ardından bu konum için View parametresini doğru ayarlamak sizin sorumluluğunuzdadır. Alternatif olarak, isteğin IP adresine göre harita verilerini döndürecek olan 'View=Auto' ayarını da belirleyebilirsiniz. Azure Haritalar'de View parametresi, haritaların, görüntülerin ve diğer verilerin ve Azure Haritalar üzerinden erişim yetkisine sahip olduğunuz üçüncü taraf içeriğinin bulunduğu ülkenin/bölgenin haritalanmasıyla ilgili olanlar da dahil olmak üzere geçerli yasalara uygun olarak kullanılmalıdır. Örnek: view=IN. Ayrıntılar ve kullanılabilir Görünümleri görmek için lütfen Desteklenen Görünümler'e bakın. |
Query |
Döndürülen sorgu türü: YAKINDA veya NON_NEAR. |
Response |
Yanıtın istenen biçimi. Değer json veya xml olabilir. |
Reverse |
Bu nesne başarılı bir Arama Address Reverse CrossStreet çağrısından döndürülür |
Reverse |
Arama Adres Ters Cadde yanıtı için sonuç nesnesi |
Search |
Arama API yanıtı için özet nesnesi. |
Address
Sonucun adresi
Name | Tür | Description |
---|---|---|
boundingBox |
Bounding |
Konumun sınırlayıcı kutusu. |
buildingNumber |
string |
Sokaktaki bina numarası. KULLANIMSIZ, bunun yerine streetNumber kullanın. |
country |
string |
ülke/bölge adı |
countryCode |
string |
Ülke (Not: Bu iki harfli bir koddur, ülke/bölge adı değildir.) |
countryCodeISO3 |
string |
ISO alfa-3 ülke kodu |
countrySecondarySubdivision |
string |
İlçe |
countrySubdivision |
string |
Eyalet veya İl |
countrySubdivisionCode |
string |
|
countrySubdivisionName |
string |
Ülke/bölge yönetim hiyerarşisinin ilk düzeyinin tam adı. Bu alan yalnızca countrySubdivision'ın kısaltılmış bir biçimde sunulması durumunda görünür. Yalnızca ABD, Kanada ve Birleşik Krallık için desteklenir. |
countryTertiarySubdivision |
string |
Adlandırılmış Alan |
crossStreet |
string |
Geçilen caddenin adı. |
extendedPostalCode |
string |
Genişletilmiş posta kodu (kullanılabilirlik bölgeye bağlıdır). |
freeformAddress |
string |
Bir Sonucun çıkış ülkesinin/bölgesinin biçimlendirme kurallarına göre veya bir ülke/bölge söz konusu olduğunda tam ülke/bölge adına göre biçimlendirilmiş bir adres satırı. |
localName |
string |
Yönetim birimi olmadan birden çok adreslenebilir nesneyi adresleme amacıyla gruplandıran bir coğrafi alanın veya yerelliğin adını temsil eden bir adres bileşeni. Bu alan özelliği oluşturmak |
municipality |
string |
Şehir / Şehir |
municipalitySubdivision |
string |
Sub / Super City |
neighbourhood |
string |
Komşuluk, bir şehir veya kasaba içinde yer alan ve sakinleri arasındaki ayırt edici özelliklere ve sosyal etkileşimlere sahip coğrafi olarak yerelleştirilmiş bir alandır. |
postalCode |
string |
Posta Kodu / Posta Kodu |
routeNumbers |
string[] |
Açık bir şekilde sokak tanımlamak için kullanılan kodlar |
street |
string |
Sokak adı. KULLANIMSIZ, bunun yerine streetName kullanın. |
streetName |
string |
Sokak adı. |
streetNameAndNumber |
string |
Sokak adı ve numarası. |
streetNumber |
string |
Sokaktaki bina numarası. |
BoundingBoxCompassNotation
Konumun sınırlayıcı kutusu.
Name | Tür | Description |
---|---|---|
entity |
Sınırlayıcı kutunun varlık türü kaynağı. Ters coğrafi kodlama için bu her zaman konuma eşittir. |
|
northEast |
string |
Virgülle ayrılmış float olarak sınırlayıcı kutunun kuzey-doğu enlemi,boylam koordinatı |
southWest |
string |
Virgülle ayrılmış float olarak sınırlayıcı kutunun güney-batı enlem,boylam koordinatı |
Entity
Sınırlayıcı kutunun varlık türü kaynağı. Ters coğrafi kodlama için bu her zaman konuma eşittir.
Name | Tür | Description |
---|---|---|
position |
string |
Konum varlığı |
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 |
Error |
Hata ek bilgileri. |
code |
string |
Hata kodu. |
details |
Error |
Hata ayrıntıları. |
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
Name | Tür | Description |
---|---|---|
error |
Error |
Hata nesnesi. |
LatLongPairAbbreviated
'lon' & 'lat' kısa adları kullanılarak enlem ve boylam olarak temsil edilen konum.
Name | Tür | Description |
---|---|---|
lat |
number |
Latitude özelliği |
lon |
number |
Boylam özelliği |
LocalizedMapView
View parametresi ("kullanıcı bölgesi" parametresi olarak da adlandırılır), coğrafi olarak tartışmalı bölgeler için belirli bir ülke/bölge için doğru haritaları göstermenizi sağlar. Farklı ülkelerin/bölgelerin bu tür bölgelerin farklı görünümleri vardır ve View parametresi uygulamanızın, uygulamanızın hizmet verecek olduğu ülke/bölge için gereken görünümle uyumlu olmasını sağlar. Varsayılan olarak, görünüm parametresi istekte tanımlamamış olsanız bile "Birleştirilmiş" olarak ayarlanır. Kullanıcılarınızın konumunu belirlemek ve ardından bu konum için View parametresini doğru ayarlamak sizin sorumluluğunuzdadır. Alternatif olarak, isteğin IP adresine göre harita verilerini döndürecek olan 'View=Auto' ayarını da belirleyebilirsiniz. Azure Haritalar'de View parametresi, haritaların, görüntülerin ve diğer verilerin ve Azure Haritalar üzerinden erişim yetkisine sahip olduğunuz üçüncü taraf içeriğinin bulunduğu ülkenin/bölgenin haritalanmasıyla ilgili olanlar da dahil olmak üzere geçerli yasalara uygun olarak kullanılmalıdır. Örnek: view=IN.
Ayrıntılar ve kullanılabilir Görünümleri görmek için lütfen Desteklenen Görünümler'e bakın.
Name | Tür | Description |
---|---|---|
AE |
string |
Birleşik Arap Emirlikleri (Arap Görünümü) |
AR |
string |
Arjantin (Arjantin Görünümü) |
Auto |
string |
harita verilerini isteğin IP adresine göre döndürür. |
BH |
string |
Bahreyn (Arapça Görünümü) |
IN |
string |
Hindistan (Hint Görünümü) |
IQ |
string |
Irak (Arapça Görünümü) |
JO |
string |
Ürdün (Arapça Görünüm) |
KW |
string |
Kuveyt (Arapça Görünüm) |
LB |
string |
Lübnan (Arapça Görünümü) |
MA |
string |
Fas (Fas Görünümü) |
OM |
string |
Umman (Arapça Görünümü) |
PK |
string |
Pakistan (Pakistan Görünümü) |
PS |
string |
Filistin Yönetimi (Arap Görünümü) |
QA |
string |
Katar (Arapça Görünümü) |
SA |
string |
Suudi Arabistan (Arap Görünümü) |
SY |
string |
Suriye (Arapça Görünümü) |
Unified |
string |
Birleşik Görünüm (Diğerleri) |
YE |
string |
Yemen (Arapça Görünümü) |
QueryType
Döndürülen sorgu türü: YAKINDA veya NON_NEAR.
Name | Tür | Description |
---|---|---|
NEARBY |
string |
Arama, tanımlanmış yarıçaplı belirli bir enlem ve boylam etrafında gerçekleştirildi |
NON_NEAR |
string |
Arama, belirli bir enlem ve boylama sapma olmadan ve tanımlı yarıçap olmadan küresel olarak gerçekleştirildi |
ResponseFormat
Yanıtın istenen biçimi. Değer json veya xml olabilir.
Name | Tür | Description |
---|---|---|
json |
string |
|
xml |
string |
ReverseSearchCrossStreetAddressResult
Bu nesne başarılı bir Arama Address Reverse CrossStreet çağrısından döndürülür
Name | Tür | Description |
---|---|---|
addresses |
Reverse |
Diziyi adresler |
summary |
Search |
Arama Adres Ters Cadde yanıtı için özet nesnesi |
ReverseSearchCrossStreetAddressResultItem
Arama Adres Ters Cadde yanıtı için sonuç nesnesi
Name | Tür | Description |
---|---|---|
address |
Sonucun adresi |
|
position |
string |
"{latitude},{longitude}" biçiminde konum özelliği |
SearchSummary
Arama API yanıtı için özet nesnesi.
Name | Tür | Description |
---|---|---|
fuzzyLevel |
integer |
Sonuçları sağlamak için gereken en yüksek bulanıklık düzeyi. |
geoBias |
Lat |
İç arama motorunun sonuçların derecelendirmesini geliştirmek için jeo-uzamsal sapma uyguladığını gösterir. Bazı yöntemlerde, kullanılabilir durumdaki lat ve lon parametreleri ayarlanarak bu durum etkilenebilir. Diğer durumlarda tamamen içseldir. |
limit |
integer |
Döndürülecek en fazla yanıt sayısı |
numResults |
integer |
Yanıttaki sonuç sayısı. |
offset |
integer |
Döndürülen Sonuçların tam Sonuç kümesi içindeki başlangıç uzaklığı. |
query |
string |
Bu arama sonuçlarını üretmek için kullanılan sorgu parametresi. |
queryTime |
integer |
Milisaniye cinsinden sorguyu çözümlemek için harcanan süre. |
queryType |
Query |
Döndürülen sorgu türü: YAKINDA veya NON_NEAR. |
totalResults |
integer |
Bulunan toplam Sonuç sayısı. |