Search - Get Geocode Autocomplete
Kullanıcının konumuna ve kısmi sorguya göre önerilen varlıkların sıralanmış listesini almak için kullanın.
Kullanıcının konumu ve tam bir sorgu dizesinin (sorgu öneki olarak adlandırılır) öneki olarak hizmet eden kısmi bir sorgu verildiğinde, Azure Haritalar Otomatik Tamamlama API'si kullanıcının muhtemelen aradığı önerilen varlıkların listesini döndürür. Bu varlıklar en olasıdan en az olasıya doğru sıralanır.
GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query={query}
GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query={query}&coordinates={coordinates}&bbox={bbox}&top={top}&resultTypeGroups={resultTypeGroups}&resultTypes={resultTypes}&view={view}&countryRegion={countryRegion}
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ü. |
|
query
|
query | True |
string |
Gerekli. Kullanıcının sorgu ön eki. Örnek: "1 Mikro" veya "Muir Ormanı". |
|
bbox
|
query |
number[] |
Sağlanmadığında gereklidir Örnek: lon1,enlem1,boylam2,enlem2. Minimum boyut yaklaşık 0.00001 derece (~1.1 metre) Maksimum boyut: tüm küresel kapsama kadar (-180,-90 ila 180,90) |
|
|
coordinates
|
query |
number[] |
Sağlanmadığında gereklidir
Not: |
|
|
country
|
query |
string |
Otomatik tamamlama sonucu için belirtilen bir ISO 3166-1 Alfa-2 bölge/ülke koduna sinyal verin, örneğin FR. Yalnızca belirtilen ülkedeki/bölgedeki sonuçlar döndürülür. |
|
|
result
|
query |
Döndürülen varlık türü gruplarının virgülle ayrılmış listesi. Olası değerler şunlardır:
|
||
|
result
|
query |
Döndürülen varlık türlerinin virgülle ayrılmış listesi. Tür grubu Adres olarak ayarlandığında, desteklenen türler şunlardır:
Diğer tüm türler Yer türü grubuna aittir. Bunlar AdminDivision1, Neighborhood, PopulatedPlace ve daha fazlası gibi varlıkları içerebilir. Varsayılan değer, tüm olası varlık türleridir. |
||
|
top
|
query |
integer (int32) minimum: 1maximum: 20 |
Döndürülecek en fazla yanıt sayısı. Varsayılan: 5, minimum: 1 ve maksimum: 20. |
|
|
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
Autocomplete API call to search for '1 Microsoft'
Örnek isteği
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=1 Microsoft&coordinates=-122.136833,47.642282
Örnek yanıt
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"locality": "Redmond",
"adminDistricts": [
{
"name": "Washington",
"shortName": "WA"
},
{
"name": "King"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "98052",
"streetNumber": "1",
"streetName": "Microsoft Way",
"addressLine": "1 Microsoft Way",
"formattedAddress": "1 Microsoft Way, Redmond, WA 98052, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"locality": "Redmond",
"adminDistricts": [
{
"name": "Washington",
"shortName": "WA"
},
{
"name": "King"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"streetNumber": "1",
"streetName": "Microsoft West Campus Rd",
"addressLine": "1 Microsoft West Campus Rd",
"formattedAddress": "1 Microsoft West Campus Rd, Redmond, WA, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"locality": "Charlotte",
"adminDistricts": [
{
"name": "North Carolina",
"shortName": "NC"
},
{
"name": "Mecklenburg"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"streetNumber": "1",
"streetName": "Microsoft Way",
"addressLine": "1 Microsoft Way",
"formattedAddress": "1 Microsoft Way, Charlotte, NC, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"locality": "Reading",
"adminDistricts": [
{
"name": "England"
},
{
"name": "Reading"
}
],
"countryRegion": {
"ISO": "GB",
"name": "United Kingdom"
},
"streetNumber": "1",
"streetName": "Microsoft Campus",
"addressLine": "1 Microsoft Campus",
"formattedAddress": "1 Microsoft Campus, Earley, Reading, England, United Kingdom"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"locality": "Sonning",
"adminDistricts": [
{
"name": "England"
},
{
"name": "Reading"
}
],
"countryRegion": {
"ISO": "GB",
"name": "United Kingdom"
},
"streetNumber": "1",
"streetName": "Microsoft Campus",
"addressLine": "1 Microsoft Campus",
"formattedAddress": "1 Microsoft Campus, Sonning, England, United Kingdom"
}
}
}
]
}
Autocomplete API call to search for '1 Microsoft Way, Redmond', filtered by roadblock resultTypes, place resultTypeGroups, and return empty result
Örnek isteği
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=1 Microsoft Way, Redmond&coordinates=-113.301894,49.201888&resultTypeGroups=Place&resultTypes=RoadBlock
Örnek yanıt
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": []
}
Autocomplete API call to search for '15010 NE 36th St WA'
Örnek isteği
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=15010 NE 36th St WA&coordinates=-122.13704445129011,47.642303642565686&top=5
Örnek yanıt
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"locality": "Redmond",
"adminDistricts": [
{
"name": "Washington",
"shortName": "WA"
},
{
"name": "King"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "98052",
"streetNumber": "15010",
"streetName": "NE 36th St",
"addressLine": "15010 NE 36th St",
"formattedAddress": "15010 NE 36th St, Redmond, WA 98052, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"locality": "Bellevue",
"adminDistricts": [
{
"name": "Washington",
"shortName": "WA"
},
{
"name": "King"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "98007",
"streetNumber": "15010",
"streetName": "NE 36th St",
"addressLine": "15010 NE 36th St",
"formattedAddress": "15010 NE 36th St, Bellevue, WA 98007, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"locality": "Sammamish",
"adminDistricts": [
{
"name": "Washington",
"shortName": "WA"
},
{
"name": "King"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "98074",
"streetNumber": "15010",
"streetName": "NE 36th St",
"addressLine": "15010 NE 36th St",
"formattedAddress": "15010 NE 36th St, Sammamish, WA 98074, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"locality": "Yarrow Point",
"adminDistricts": [
{
"name": "Washington",
"shortName": "WA"
},
{
"name": "King"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "98004",
"streetNumber": "15010",
"streetName": "NE 36th St",
"addressLine": "15010 NE 36th St",
"formattedAddress": "15010 NE 36th St, Yarrow Point, WA 98004, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"locality": "Seattle",
"adminDistricts": [
{
"name": "Washington",
"shortName": "WA"
},
{
"name": "King"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "98105",
"streetNumber": "15010",
"streetName": "NE 36th St",
"addressLine": "15010 NE 36th St",
"formattedAddress": "15010 NE 36th St, Seattle, WA 98105, United States"
}
}
}
]
}
Autocomplete API call to search for 'Muir Woods', filtered by park and populated place resultTypes, place resultTypeGroups
Örnek isteği
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-122.581711,37.896980&resultTypeGroups=Place&resultTypes=Park,PopulatedPlace
Örnek yanıt
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "PopulatedPlace",
"address": {
"locality": "Muir Woods",
"adminDistricts": [
{
"name": "Georgia"
},
{
"name": "Fulton County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "30349",
"formattedAddress": "Muir Woods, Georgia 30349, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "Park",
"address": {
"adminDistricts": [
{
"name": "California"
},
{
"name": "Marin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "California"
},
"name": "Muir Woods National Park"
}
}
]
}
Autocomplete API call to search for 'Muir Woods', filtered by park resultTypes
Örnek isteği
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-122.581711,37.896980&resultTypes=Park
Örnek yanıt
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "Park",
"address": {
"adminDistricts": [
{
"name": "California"
},
{
"name": "Marin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "California"
},
"name": "Muir Woods National Monument"
}
}
]
}
Autocomplete API call to search for 'Muir Woods', filtered by place resultTypeGroups
Örnek isteği
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-122.581711,37.896980&resultTypeGroups=Place
Örnek yanıt
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "Forest",
"address": {
"adminDistricts": [
{
"name": "Wisconsin"
},
{
"name": "Dane County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "Wisconsin"
},
"name": "Muir Woods"
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "PopulatedPlace",
"address": {
"locality": "Muir Woods",
"adminDistricts": [
{
"name": "Georgia"
},
{
"name": "Fulton County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "30349",
"formattedAddress": "Muir Woods, Georgia 30349, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "Park",
"address": {
"adminDistricts": [
{
"name": "California"
},
{
"name": "Marin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "California"
},
"name": "Muir Woods National Monument"
}
}
]
}
Autocomplete API call to search for 'Muir Woods', filtered by roadblock resultTypes, address resultTypeGroups
Örnek isteği
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-113.301894,49.201888&resultTypeGroups=Address&resultTypes=RoadBlock
Örnek yanıt
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "RoadBlock",
"address": {
"streetName": "Muir St",
"addressLine": "Muir St",
"locality": "Grosse Pointe Farms",
"adminDistricts": [
{
"name": "Michigan"
},
{
"name": "Wayne County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "48236",
"formattedAddress": "Muir St, Grosse Pointe Farms, Michigan 48236, United States"
}
}
}
]
}
Tanımlar
| Veri Akışı Adı | Description |
|---|---|
| Address |
Coğrafi kodlanmış veya otomatik tamamlanmış önerilen bir konumun adresi, yapılandırılmış alanlara ayrıştırılır.
Sedirlik normaldir: yalnızca çözülmüş varlığın sağladığı alanlar doldurulur. Örneğin, |
|
Address |
Bir adres içeren idari alt bölüm. Örneğin, bir eyalet, eyalet veya ilçe. Ana dizide tek bir giriş |
|
Address |
Adresi içeren ülke veya bölge, gösterim adı ve ISO 3166-1 Alpha-2 ülke kodu ile tanımlanır. Her iki alan da verilen bir yanıtta atlanabilir. |
|
Autocomplete |
Bir |
|
Autocomplete |
Bir |
|
Autocomplete |
Başarılı yanıt organı tarafından geri döndü. |
|
Autocomplete |
Hem giriş filtresi ( |
|
Autocomplete |
Bir otomatik tamamlama önerisinin iki gruptan birine kabaca bir sınıflandırması. Hem sorgu parametresi üzerinden |
|
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. |
|
Feature |
İleri |
|
Feature |
|
|
Geo |
|
|
Geo |
Geçerli bir |
| Intersection |
Yol kavşağı olarak çözülen bir adres için kavşak detayları — iki veya daha fazla isimli caddenin birleştiği köşe. Yalnızca çözümlenen varlık bir |
Address
Coğrafi kodlanmış veya otomatik tamamlanmış önerilen bir konumun adresi, yapılandırılmış alanlara ayrıştırılır.
Sedirlik normaldir: yalnızca çözülmüş varlığın sağladığı alanlar doldurulur. Örneğin, streetName ve streetNumber sadece sokak seviyesindeki adresler için görünür ve intersection sadece yol kavşağı sonuçları için görünür.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| addressLine |
string |
Adresin ilk satırı, genellikle sokak adı ve numarası. Örneğin, |
| adminDistricts |
Adresi içeren idari alt bölümler, en kabalıktan en iyisine sıralanmıştır. İlk giriş genellikle birinci dereceden alt bölümdür (örneğin bir ABD eyaleti veya Kanada eyaleti gibi); Sonraki girişler, ülke, bağımlılık veya bölgenin onları tanımladığı daha ince bölümleri kapsar (örneğin Index 1'deki bir ilçe). |
|
| countryRegion |
Adresin yer aldığı ülke veya bölge, gösterim adı ve ISO 3166-1 Alpha-2 ülke kodu. |
|
| formattedAddress |
string |
Tam adres, adresin ülke veya bölgesinin konvansiyonlarına göre birleştirildiği tek bir insan tarafından okunabilir bir dizi olarak sunulur. Örnek: |
| intersection |
Adresin kesişen sokak detayları, çözülen varlık bir |
|
| locality |
string |
Adresin bulunduğu yerleşim yeri: genellikle bir şehir, kasaba veya köy. Örneğin: |
| neighborhood |
string |
Yerleşim alanı içinde adlandırılmış mahalle, biri tanımlandığında. |
| postalCode |
string |
Adresin posta kodu, tanımlandığında. Örnek: |
| streetName |
string |
Adresin sokak adı bileşeni, çözülen varlık sokak düzeyinde bir adres olduğunda. Örnek: |
| streetNumber |
string |
Sokaktaki ev veya bina numarası, karar verilen varlık sokak düzeyinde bir adres olduğunda. Örnek: |
AddressAdminDistrictsItem
Bir adres içeren idari alt bölüm. Örneğin, bir eyalet, eyalet veya ilçe. Ana dizide tek bir giriş Address.adminDistricts olarak döner; girdiler en kabalıktan en iyiye doğru sıralanır.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| name |
string |
Yerleşimin tam adı. Örneğin, |
| shortName |
string |
Alt bölüm adının kısa veya kısaltılmış biçimi, tanımlandığında. Örneğin, |
AddressCountryRegion
Adresi içeren ülke veya bölge, gösterim adı ve ISO 3166-1 Alpha-2 ülke kodu ile tanımlanır. Her iki alan da verilen bir yanıtta atlanabilir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| ISO |
string |
Ülke veya bölge için ISO 3166-1 Alpha-2 ülke kodu. Örneğin, |
| name |
string |
Ülkenin veya bölgenin gösterim adı. Örneğin, |
AutocompleteFeature
Bir featuresdizideki AutocompleteResponse tek bir giriş, nesne GeoJSON Feature şekline uymak.
Bir otomatik tamamlama önerisini temsil eder: sınıflandırma (type, typeGroup), ayrıştırılmış adres ve isteğe bağlı yer adı ile propertiesile gösterilir, geometry bir koordinat varsa temsilci koordinat gösterilir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| geometry |
Otomatik tamamlama önerisinin koordinatı |
|
| properties |
Otomatik tamamlama önerisi hakkında yapılandırılmış veriler, sınıflandırması, ayrıştırılmış adres ve (-tipli öneriler için) |
|
| type |
Nesne |
AutocompleteProperties
Bir propertiesAutocompleteFeatureyükün yükü. Sonucun sınıflandırmasını (typeGroup, type), ayrıştırılmış adresini ve (birçok Place-tipli sonuç için) ayrı bir gösterim adını taşır.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| address |
Otomatik tamamlama sonucunun adresi, yapılandırılmış alanlara ayrılmıştır.
|
|
| name |
string |
Önerilen yerin gösterim adı. İsim yapılandırılmış |
| type |
Sonucun çözüldüğü özel varlık türü. Örneğin, bir adres, nüfuslu bir yer, bir park veya bir simge yapı.
|
|
| typeGroup |
Sonucun adres veya isimli yer olarak geniş şekilde sınıflandırılması. Değer listesi için bakınız |
AutocompleteResponse
Başarılı yanıt organı tarafından geri döndü.Get Autocomplete
GeoJSON FeatureCollection
features Otomatik tamamlama önerisi için bir Feature dizi, en en az olasılıktan en düşük seviyeye kadar sıralanmış bir dizi olarak kodlanmıştır.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| features |
Sorgu tarafından döndürülen nesne |
|
| nextLink |
string |
Yanıt sayfalıysa, sonraki sonuç sayfasını getirecek URL'yi içerir. Bu, yanıt tek bir aramada geri dönüşü için çok büyük olduğunda faydalıdır ve kullanıcıların birden fazla sayfa sonucu gezmesini sağlar. |
| type |
Başarılı |
AutocompleteResultTypeEnum
Hem giriş filtresi (Get Autocompletesorgu parametresi aracılığıyla) hem de çıkış etiketi olarak (her biri resultTypesüzerindeki alan aracılığıylatype) tarafından kullanılan otomatik tamamlama AutocompleteProperties önerilerinin sınıflandırılmasıdır. Üyeler, adresleri, yol bölümlerini, idari bölgeleri, nüfuslu yerleri, doğal özellikleri ve ilgi noktalarını kapsayan gazeteci tarzı bir taksonomi tanımlar. Bu taksonomi, adresleri ve yol segmentlerini AutocompleteResultTypeGroupsEnumkapsayan , ve diğer tüm sonuç türlerini kapsayan iki daha geniş gruba AddressPlaceayrılır.
| Değer | Description |
|---|---|
| Address |
Belirli bir sokak adresi. |
| AdminDivision1 |
Ülke/bölge içinde ilk idari seviye, örneğin bir eyalet veya eyalet. |
| AdminDivision2 |
Ülke/bölge içinde ikinci idari seviye, örneğin bir ilçe. |
| AdminDivision3 |
Ülke/bölge içinde üçüncü idari seviye, örneğin bir ilçe, cemaat veya belediye. API uyumluluğu için korunmuştur. Bu tür şu anda Otomatik Tamamlama hizmeti tarafından döndürülmez; yalnızca bu tipe filtrelenen talepler boş bir sonuç kümesi döndürür. |
| AdministrativeBuilding |
Devlet ofisleri veya kamu idari işlevlerine ev sahipliği yapan bir bina. |
| Airport |
Uçakların düzenli olarak kalkış ve iniş yaptığı bir tesis, yolcu ve yük için olanaklar sunuyor. |
| AirportTerminal |
Bir havaalanı içinde bir yolcu terminali binası. Kullanılabilirlik coğrafyaya göre değişir ve Azure Haritalar arama verileri güncellendikçe değişebilir. Her sorgu için eşleşen öneriler garanti değildir. |
| AmusementPark |
Eğlence merkezleri, oyunlar ve temalı atraksiyonlar sunar. |
| AncientSite |
Antik bir uygarlığa ait arkeolojik kalıntıların veya kültürel eserlerin korunduğu bir yer. |
| Aquarium |
Sucul bitkiler ve hayvanların sergilendiği ve incelendiği bir kamu tesisi. |
| Archipelago |
Bir ada grubu veya zinciri. |
| Basin |
Kara yüzeyinde doğal bir çukur, genellikle daha yüksek arazilerle çevrilidir. |
| Battlefield |
Tarihi açıdan önemli bir kara savaşının yaşandığı bir yer. |
| Bay |
Kısmen karayla çevrili, bir körfezden küçük ve bir koydan daha büyük bir su kütlesi. |
| Beach |
Bir su kütlesi boyunca kum, çakıl veya diğer konsolide olmayan tortulardan oluşan bir kıyı. |
| Bridge |
Bir yolu, demiryolunu veya yolu nehir, vadi veya başka bir yol gibi bir engelin üzerinden taşıyan bir yapı. |
| BusinessStructure |
Genel iş veya ticari faaliyetler için kullanılan ve daha spesifik bir kategoriye uymayan bir bina. |
| Camp |
Geçici yerleşim için barınaklar veya tesisler olan bir alan, örneğin kamp alanı veya mevsimlik yerleşim yeri. |
| Canal |
Ulaşım, sulama veya drenaj için kullanılan yapay bir su yolu. |
| Casino |
Kumar ve şans oyunları için kullanılan bir tesis. |
| Castle |
Genellikle soylu veya kraliyet ikametgahıyla ilişkilendirilen, tarihsel olarak tahkimatlı bir bina veya bina kompleksi. |
| Cave |
Kayadan oluşmuş doğal bir yeraltı odası veya geçidi. |
| Cemetery |
Bir mezarlık ya da mezarlık. |
| Channel |
İki kara kütlesi veya daha büyük bir su kütlesinin ana akış yolu arasında seyrüsefer yapılabilir bir su yolu. |
| Church |
Hristiyan ibadetinde kullanılan bir bina. |
| Cliff |
Yüksek, dik bir kaya ya da toprak yüzeyi, genellikle bir kıyı veya vadiye bakıyordu. |
| Coast |
Denize kıyıda isimlendirilmiş bir arazi parçası. |
| CommunityCenter |
Topluluk etkinlikleri, toplantılar ve sosyal hizmetlere ev sahipliği yapan bir tesis. |
| Continent |
Dünya'nın büyük kara kütlelerinden biri. |
| CountryRegion |
Bir ülke ya da bölge. |
| Crater |
Volkanik aktivite veya meteor çarpmasıyla oluşan dairesel bir çukur. |
| CulturalRegion |
Dil, etnik köken veya miras gibi ortak kültürel özelliklerle ayırt edilen bir alan. |
| Dam |
Bir dere veya nehir üzerinde su tutmak için inşa edilen bir bariyer. |
| Delta |
Bir nehirin daha büyük bir su kütlesiyle buluştuğu yerde oluşan alüvyal birikintilerden oluşan bir arazi formu. |
| Desert |
Sınırlı yağış nedeniyle seyrek bitki örtüsü bulunan büyük ve kurak bir bölge. |
| DrainageBasin |
Bir nehir sistemi ve kollarıyla drenaj edilen bir arazi alanı. |
| Dune |
Rüzgarla savrulan kumdan oluşan bir tepe ya da sırt. |
| FacilityStructure |
Bir elektrik tesisi veya servis tesisi gibi özel bir tesisi barındıran bir yapı. |
| FerryTerminal |
Yolcu ve araçların feribotlara binip indiği bir tesis. |
| FinancialStructure |
Bir banka, kredi birliği veya başka bir finansal hizmet kurumuna ev sahipliği yapan bir bina. Kullanılabilirlik coğrafyaya göre değişir ve Azure Haritalar arama verileri güncellendikçe değişebilir. Her sorgu için eşleşen öneriler garanti değildir. |
| FireStation |
İtfaiyeciler, ekipman ve acil müdahale araçlarının bulunduğu bir bina. |
| Forest |
Ağaçların hakim olduğu geniş bir arazi alanı. |
| Fort |
Savunma amaçlı bir askeri yapı veya toprak yapı. |
| Garden |
Süs amaçlı veya bilimsel olarak seçilmiş bitkilerin sergilendiği bir tarım alanı. |
| Geyser |
Zaman zaman su ve buhar jetleri püskürten bir kaplıca. |
| Glacier |
Kendi ağırlığı altında yavaşça hareket eden kalıcı bir buz kütlesi. |
| GolfCourse |
Golf oynamak için bir alan düzenlendi. |
| GreaterPopulatedPlace |
Nüfuslu bir yeri kapsayan ve onun ötesine uzanan bir metropol alan veya şehir bölgesi. API uyumluluğu için korunmuştur. Bu tür şu anda Otomatik Tamamlama hizmeti tarafından döndürülmez; yalnızca bu tipe filtrelenen talepler boş bir sonuç kümesi döndürür. |
| HigherEducationFacility |
Bir kolej, üniversite veya benzeri yükseköğretim kurumu. |
| HistoricalSite |
Tarihi öneme sahip bir alan, genellikle kültürel miras alanı olarak korunmaktadır. |
| Hospital |
Yatarak ve ayaktan tedavi sağlayan bir tıbbi tesis. |
| HotSpring |
Jeotermal olarak ısıtılan yeraltı suyunun yüzeyde ortaya çıktığı doğal bir kaynaktır. |
| Ice |
Doğal bir kütle veya yüzey tabakası olan donmuş su yüzeyi, arazi veya su kaplar. |
| IndigenousPeoplesReserve |
Bir yerli halkın veya topluluğun anavatanı olarak tanınan bir toprak. |
| IndustrialStructure |
Üretim, üretim veya diğer endüstriyel operasyonlar için kullanılan bir bina veya tesis. |
| Island |
Su ile çevrili, bir kıtadan daha küçük, bir kara kütlesi. |
| Isthmus |
İki büyük kara kütlesini birbirine bağlayan ve iki su kütlesini ayıran dar bir arazi şeridi. |
| Lake |
Kara ile çevrili bir iç kesim su kütlesi. |
| LandArea |
Daha spesifik bir coğrafi kategoriye uymayan adlandırılmış bir arazi bölgesi. |
| Landform |
Daha spesifik bir kategoriye uymayan doğal bir arazi özelliği, örneğin |
| LandmarkBuilding |
Mimari, kültürel veya tarihsel öneme sahip ve tanınabilir bir simge olarak hizmet veren dikkat çekici bir bina. |
| Library |
Halka açık kitap ve diğer medya koleksiyonlarına ev sahipliği yapan bir bina. |
| Lighthouse |
Gemileri yönlendirmek için navigasyon ışığı gösteren bir kıyı veya liman yapısı. |
| Marina |
Küçük tekneler ve yatlar için demirleme ve hizmet sağlayan bir liman tesisi. |
| Market |
Ürünlerin genellikle perakende olarak alınıp satıldığı bir yer. |
| MedicalStructure |
Klinik veya tıbbi ofis gibi bir diğer |
| MetroStation |
Metro, yeraltı veya diğer kentsel hızlı toplu tren sisteminde bir istasyon. |
| MilitaryBase |
Silahlı kuvvetler tarafından eğitim, ikmal veya operasyonlar için işletilen bir tesis. |
| Mission |
Dini bir grup tarafından topluma hizmet vermek ve inancı yaymak amacıyla işletilen bir kompleks. |
| Monument |
Bir kişiyi, etkinliği veya fikri onurlandırmak için dikilmiş anı yapı veya heykel. |
| Mosque |
Kamusal İslami ibadet için kullanılan bir bina. |
| Mountain |
Çevresinin üzerinde belirgin şekilde yükselen, genellikle dik yamaçlara ve belirli bir zirveye sahip bir arazi formu. |
| MountainRange |
Sürekli bir sıradağ oluşturan bağlı bir dağ dizisi. |
| MultiModalStation |
Birleşik demiryolu, otobüs veya metro hizmetleri gibi birden fazla ulaşım biçimine hizmet veren bir istasyon. |
| Museum |
Sanatsal, bilimsel veya tarihi ilgi alanına sahip nesnelerin korunduğu ve sergilendiği bir tesis. |
| NauticalStructure |
İskele, iskele veya şamandıra gibi denizcilik veya denizcilik faaliyetleriyle ilgili bir yapı. |
| 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. |
| Oasis |
Doğal su kaynağıyla beslenen verimli bir çöl alanı. |
| ObservationPoint |
Çevredeki bölgenin manzaralı manzaralarını sunan bir bakış noktası veya gözlem noktası. |
| Ocean |
Dünya'nın küresel okyanusunun başlıca bölümlerinden biri. |
| OfficeBuilding |
Öncelikle profesyonel veya idari ofis alanı olarak kullanılan bir bina. |
| Other |
Başka tanımlanmış bir türe uymayan bir öneri. |
| Park |
Kamusal eğlence veya manzara keyfi için bakımı yapılan bir alan. |
| ParkingStructure |
Araç park yerlerine adanmış çok katlı bir yapı. |
| Pass |
Bir dağ silsilesi veya benzeri engel içinden geçilebilen veya üzerinden geçilebilir bir güzergah. |
| Peninsula |
Bir su kütlesine doğru uzanan ve neredeyse onunla çevrili bir kara kütlesi. |
| Plain |
Görece düz veya hafif dalgalı geniş bir arazi alanı. |
| Planet |
Bir yıldızın etrafında dönen bir gök cismi, genellikle coğrafi hiyerarşinin kökü olarak Dünya'yı temsil etmek için kullanılır. Kullanılabilirlik coğrafyaya göre değişir ve Azure Haritalar arama verileri güncellendikçe değişebilir. Her sorgu için eşleşen öneriler garanti değildir. |
| Plateau |
Bir veya birkaç tarafında dik eğimli, nispeten düz bir arazi alandır. |
| Playground |
Çocukların oyunları için donatılmış bir rekreasyon alanı. |
| PlayingField |
Organize sporların oynandığı açık bir alan. |
| Pole |
Kuzey veya Güney Kutbu gibi coğrafi bir kutbu. Kullanılabilirlik coğrafyaya göre değişir ve Azure Haritalar arama verileri güncellendikçe değişebilir. Her sorgu için eşleşen öneriler garanti değildir. |
| PoliticalUnit |
Bağımsız veya bağımlı bir devlet veya toprak gibi kendi kendini yöneten siyasi bir varlık. API uyumluluğu için korunmuştur. Bu tür şu anda Otomatik Tamamlama hizmeti tarafından döndürülmez; yalnızca bu tipe filtrelenen talepler boş bir sonuç kümesi döndürür. |
| PopulatedPlace |
Şehir, kasaba veya köy gibi insan yerleşiminin yoğunlaştığı bir alan. |
| Port |
Suda bulunan yük veya yolcuların yükleme ve boşaltılması için terminallere sahip bir denizcilik tesisi. |
| Postcode1 |
Posta kodu gibi en küçük posta kodu kategorisi. |
| Promontory |
Alçak veya su kütlesine doğru çıkıntılı belirgin yükseltilmiş bir arazi şekli. |
| RaceTrack |
Yarış araçları, hayvanlar veya sporcular için düzenlenmiş bir pist veya parkur. |
| RailwayStation |
Yolcuların trenlere binip indiği bir tesis. |
| Reef |
Su yüzeyine yakın bir kaya, kum veya mercan sırtı olan su altında kalmış veya kısmen suya batık bir sırt. |
| ReligiousStructure |
Daha spesifik bir kategoriye uymayan dini ibadet veya uygulama için kullanılan bir bina, örneğin |
| Reserve |
Koruma, yaban hayatı veya başka kısıtlı kullanım için ayrılmış korunan bir arazi. |
| ResidentialStructure |
Öncelikle insan konutu için kullanılan bir bina, örneğin bir apartman veya konut kompleksi. |
| River |
Daha düşük bir rakıma doğru akan doğal bir su yolu, genellikle deniz, göl veya başka bir nehre doğru. |
| RoadBlock |
Belirli bir ev numarası olmayan bir sokak segmenti, coğrafi kodlama servisi sorgu için kesin ev numarasını bulamayınca geri döner. Adına rağmen, bu değer fiziksel bir yol kapanıtını göstermez. |
| Ruin |
Artık orijinal işlevini yerine getirmeyen, yıkılmış veya çürümüş bir yapı. |
| ScientificResearchBase |
Bilimsel araştırmalar için genellikle uzak veya aşırı ortamlarda kullanılan bir tesis. |
| Sea |
Kısmen karayla çevrili, okyanustan daha küçük, büyük bir tuzlu su kütlesi. |
| SeaplaneLandingArea |
Deniz uçaklarının kalkış ve iniş yapması için ayrılmış bir su alanı. |
| Shrine |
Bir kişiyi anan veya kutsal bir olayı veya kavramı anan bir yapı veya alan. |
| SkiArea |
Kayak ve diğer kış sporları için bir rekreasyon alanı geliştirilmiştir. |
| Spring |
Yeraltı suyunun yer yüzeyinden aktığı doğal bir kaynak. |
| Stadium |
Seyirci sporları veya etkinlikleri için katmanlı oturma alanları olan büyük bir mekan. |
| StatisticalDistrict |
İstatistiksel veya nüfus sayımı amaçları için tanımlanan bir bölge, örneğin metropol istatistiksel alan veya nüfus sayımı bölgesi. |
| Temple |
Dini ibadetlere adanmış bir bina. |
| Theater |
Oyunların, filmlerin veya diğer canlı veya kayıtlı performansların sunulduğu bir mekan. |
| TouristRailway |
Manzaralı veya miras demiryolu, düzenli toplu taşıma yerine öncelikle turizm için işletiliyordu. Kullanılabilirlik coğrafyaya göre değişir ve Azure Haritalar arama verileri güncellendikçe değişebilir. Her sorgu için eşleşen öneriler garanti değildir. |
| TouristStructure |
Turistlere hizmet veren bir bina, örneğin bir ziyaretçi merkezi veya turistik bilgi ofisi. |
| Trailhead |
Yürüyüş, bisiklet veya rekreasyon parkuru için başlangıç noktası. |
| TransportationStructure |
Ücret noktası, tartı istasyonu veya toplu taşıma barınağı gibi ulaşım altyapısını destekleyen bir yapı. |
| Tunnel |
Karayolu, demiryolu veya yaya geçişi için yeraltı veya su altı geçidi. |
| Valley |
Tepeler veya dağlar arasında uzun ve alçak bir alan, genellikle bir su yolu içerir. |
| Volcano |
Volkanik aktivite ile oluşan bir dağ veya tepe, genellikle zirvesinde bir krater bulunur. |
| Walkway |
Yaya kullanımı için belirlenmiş bir yol veya döşenmiş zemin. |
| Wall |
Sürekli dikey sınır oluşturan inşa edilmiş bir bariyer, genellikle savunma, ayrım veya anma için kullanılır. Kullanılabilirlik coğrafyaya göre değişir ve Azure Haritalar arama verileri güncellendikçe değişebilir. Her sorgu için eşleşen öneriler garanti değildir. |
| Waterfall |
Bir dere veya nehrin dikey veya dik bir şekilde düştüğü bir nokta. |
| WaterFeature |
Daha spesifik bir kategoriye uymayan bir su kütlesi, örneğin |
| Wetland |
Suyla doygun ve bataklık veya bataklık gibi destekleyici su bitki örtüsüyle dolu bir arazi alanı. |
| Winery |
Şarap üretildiği ve genellikle tadım veya satışa sunulduğu bir tesis. |
| Zoo |
Vahşi hayvanların halka açık sergi ve inceleme için tutulduğu bir tesis. |
AutocompleteResultTypeGroupsEnum
Bir otomatik tamamlama önerisinin iki gruptan birine kabaca bir sınıflandırması. Hem sorgu parametresi üzerinden Get Autocomplete giriş filtresi olarak (hangi tür önerinin geri döneceğini kısıtlamak) hem de her resultTypeGroups birinin alan aracılığıyla typeGroup çıktı sınıflandırıcısı olarak (geri dönen önerinin hangi gruba ait olduğunu belirlemek) olarak kullanılırAutocompleteProperties. Grup, Address bireysel adresleri ve sokak segmentlerini kapsar; Place grup diğer tüm varlık türlerini (idari bölgeler, nüfuslu yerler, doğal özellikler ve ilgi çekici noktalar) kapsar.
| Değer | Description |
|---|---|
| Address |
Belirli bir adrese veya yol segmentine bağlı öneriler. |
| Place |
Isimlendirilmiş yerlere odaklanan öneriler, idari bölgeler, nüfuslu yerler, mahalleler, doğal özellikler ve ilgi çekici noktalar dahil. Örnek olarak |
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. |
FeatureCollectionEnum
İleri GeoJSON jeokodlama, ters coğrafi kodlama ve otomatik tamamlama işlemlerinden (toplu varyantları dahil) başarılı yanıtların kökünde kullanılan nesne türü. Tek değer, FeatureCollectionRFC 7946'da tanımlandığı gibi 'dir.
Get Polygontek istisnadır: yanıt kökü a'dırGeoJSON Feature, bkz.FeatureTypeEnum
| Değer | Description |
|---|---|
| FeatureCollection |
Nesne |
FeatureTypeEnum
GeoJSON Nesneler için Feature nesne türü. Yanıtın dizisindeki features her girişi FeatureCollection 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 |
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 |
|
Intersection
Yol kavşağı olarak çözülen bir adres için kavşak detayları — iki veya daha fazla isimli caddenin birleştiği köşe. Yalnızca çözümlenen varlık bir RoadIntersectionolduğunda doldurulur; ebeveyn Address.intersection aksi takdirde atlanır.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| baseStreet |
string |
Kavşağın ana caddesi — genellikle adres numarasının referans verdiği sokak. |
| displayName |
string |
Kavşak için insan tarafından okunabilir bir isim, kesişme sokaklarını birleştiren, örneğin |
| intersectionType |
string |
Kesişimin şeklini tanımlayan kısa bir etiket. Örneğin, seviyede bir kavşağı köprü veya üst geçit gibi seviye mesafeli bir geçişten ayırt etmek. |
| secondaryStreet1 |
string |
Kavşakta buluşan |
| secondaryStreet2 |
string |
Kavşakta ikinci kavşak var, biri varsa. Sadece üç veya daha fazla caddenin kesiştiği yerlerde nüfusludur. |