Search - Get Search Fuzzy
Adres ve POI belirteçlerinin birleşimlerini işleyebilen bir arama isteğine ihtiyacınız olduğunda kullanın.
Get Search Fuzzy
POI arama ve coğrafi kodlamanın bir bileşimini sorunsuz bir şekilde işleyen bir HTTP GET
isteği olan (Ücretsiz Form Arama) API'si. Bu, herhangi bir adres veya POI belirteci bileşimini içeren girişlerin benzerini kurallı bir 'tek satırlı arama' olarak işleyen bir Ücretsiz Form Arama API'dir. Bağlamsal bir konumla (lat/lon çifti) ağırlıklandırılabilir veya koordinat ve yarıçapla tamamen kısıtlanabilir veya coğrafi sapma noktası olmadan daha genel olarak yürütülebilir.
Varsayılan davranış, gereksiz sonuçlar döndürebilecek şekilde tüm dünyada arama yapmak olduğundan, yalnızca uygulamanızın kapsama ihtiyacı olan ülkeleri/bölgeleri belirtmek için 'countrySet' parametresini kullanmanızı kesinlikle öneririz.
Örneğin: countrySet
=ABD,FR
Desteklenen tüm ülkelerin/bölgelerin tam listesi için lütfen Arama Kapsamı'na bakın.
Çoğu Arama sorgu, performans elde etmek maxFuzzyLevel
ve olağan dışı sonuçları azaltmak için varsayılan olarak =2 olarak ayarlanır. Bu yeni varsayılan değer, =3 veya 4 sorgusunu maxFuzzyLevel
geçirerek istek başına gerektiğinde geçersiz kılınabilir.
GET https://atlas.microsoft.com/search/fuzzy/{format}?api-version=1.0&query={query}
GET https://atlas.microsoft.com/search/fuzzy/{format}?api-version=1.0&query={query}&typeahead={typeahead}&limit={limit}&ofs={ofs}&categorySet={categorySet}&countrySet={countrySet}&lat={lat}&lon={lon}&radius={radius}&topLeft={topLeft}&btmRight={btmRight}&language={language}&extendedPostalCodesFor={extendedPostalCodesFor}&minFuzzyLevel={minFuzzyLevel}&maxFuzzyLevel={maxFuzzyLevel}&idxSet={idxSet}&brandSet={brandSet}&connectorSet={connectorSet}&entityType={entityType}&view={view}&openingHours=nextSevenDays
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 |
string |
Geçerli sorgu dizesi (örn. "seattle", "pizza"). Enlem ve ardından boylam (örneğin, "47.641268, -122.125679") tarafından oluşturulan virgülle ayrılmış bir dize olarak da belirtilebilir. URL'nin doğru kodlanmış olması gerekir. |
brand
|
query |
string[] |
Sonucu belirli markalarla kısıtlamak için kullanılabilecek marka adlarının virgülle ayrılmış listesi. Madde siparişi önemli değil. Birden çok marka sağlandığında, yalnızca sağlanan listeden birine (en az) ait olan sonuçlar döndürülür. Adında "," bulunan markalar tırnak içine alınmalıdır. Kullanım örnekleri: brandSet=Foo brandSet=Foo,Bar brandSet="A,B,C Virgül",Çubuk |
|
btm
|
query |
string |
Sınırlayıcı kutunun sağ alt konumu. Örn. 37.553,-122.453 |
|
category
|
query |
integer[] |
Sonucu belirli İlgi Çekici Noktalar kategorileriyle kısıtlamak için kullanılabilecek kategori kümesi kimliklerinin virgülle ayrılmış listesi. Kimlik sırası önemli değildir. İstek başına desteklenen en fazla
|
|
connector
|
query |
Electric |
Sonucu belirli bağlayıcı türlerini destekleyen Elektrikli Araç İstasyonu ile kısıtlamak için kullanılabilecek bağlayıcı türlerinin virgülle ayrılmış listesi. Madde siparişi önemli değil. Birden çok bağlayıcı türü sağlandığında, yalnızca sağlanan listeden birine (en az) ait olan sonuçlar döndürülür. Kullanılabilir bağlayıcı türleri şunlardır:
Kullanım örnekleri: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
|
country
|
query |
string[] |
Ülke/bölge kodlarının virgülle ayrılmış dizesi, örneğin FR,ES. Bu, aramayı belirtilen ülkeler/bölgeler ile sınırlandıracaktır |
|
entity
|
query |
Geographic |
Coğrafyalarda gerçekleştirilen filtreleme düzeyini belirtir. Belirtilen coğrafya varlık türleri için aramayı daraltıyor, örneğin yalnızca belediyeyi döndür. Sonuçta elde edilen yanıt, hem coğrafya kimliğini hem de eşleşen varlık türünü içerir. Virgülle ayrılmış liste olarak birden fazla varlık sağlarsanız, uç nokta 'kullanılabilir en küçük varlık' değerini döndürür. Döndürülen Geometri Kimliği, Get Arama Polygon API aracılığıyla bu coğrafyanın geometrisini almak için kullanılabilir. entityType ayarlandığında aşağıdaki parametreler yoksayılır:
|
|
extended
|
query |
Search |
Genişletilmiş posta kodlarının sonuçlara eklenmesi gereken dizinler. Kullanılabilir dizinler şunlardır: Addr = Adres aralıkları Coğrafi = Coğrafyalar PAD = Nokta Adresleri POI = İlgi Çekici Noktalar Str = Sokaklar XStr = Caddeler Arası (kesişimler) Değer, dizin türlerinin virgülle ayrılmış bir listesi (herhangi bir sırada ) veya dizin yok olmalıdır. Varsayılan olarak, Geo dışındaki tüm dizinler için genişletilmiş posta kodları eklenir. Coğrafyalar için genişletilmiş posta kodu listeleri oldukça uzun olabilir, bu nedenle gerektiğinde açıkça istenmeleri gerekir. Kullanım örnekleri: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Genişletilmiş posta kodu, bir adresin extendedPostalCode özelliği olarak döndürülür. Kullanılabilirlik bölgeye bağlıdır. |
|
idx
|
query |
Search |
Arama için kullanılması gereken dizinlerin virgülle ayrılmış listesi. Madde siparişi önemli değil. Kullanılabilir dizinler şunlardır: Addr = Adres aralığı ilişkilendirmesi, Coğrafi = Coğrafyalar, PAD = Nokta Adresleri, POI = İlgi çekici noktalar, Str = Sokaklar, Xstr = Caddeler (kesişimler) |
|
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. |
|
lat
|
query |
number double |
Sonuçların sapmalı olması gereken enlem. Örn. 37.337 |
|
limit
|
query |
integer |
Döndürülecek en fazla yanıt sayısı. Varsayılan: 10, en az: 1 ve maksimum: 100 |
|
lon
|
query |
number double |
Sonuçların sapmalı olması gereken boylam. Örn. -121.89 |
|
max
|
query |
integer |
Kullanılacak maksimum bulanıklık düzeyi. Varsayılan: 2, en az: 1 ve maksimum: 4
Arama motoru minFuzzyLevel tarafından tanımlanan düzeyde bir eşleşme aramaya başlar ve maxFuzzyLevel tarafından belirtilen düzeyde aramayı durdurur. |
|
min
|
query |
integer |
Kullanılacak minimum bulanıklık düzeyi. Varsayılan: 1, en az: 1 ve maksimum: 4
Arama altyapısı minFuzzyLevel tarafından tanımlanan düzeyde bir eşleşme aramaya başlar ve maxFuzzyLevel tarafından belirtilen düzeyde aramayı durdurur. |
|
ofs
|
query |
integer |
Döndürülen sonuçların tam sonuç kümesi içindeki uzaklığını başlatma. Varsayılan: 0 |
|
opening
|
query |
Operating |
PoI için çalışma saatleri (İlgi Çekici Noktalar). Çalışma saatlerinin kullanılabilirliği, kullanılabilir verilere göre değişir. Geçirilmediyse, hiçbir çalışma saati bilgisi döndürülmeyecektir. Desteklenen değer: nextSevenDays |
|
radius
|
query |
integer |
Sonuçların tanımlı alanla kısıtlanması için metre cinsinden yarıçap |
|
top
|
query |
string |
Sınırlayıcı kutunun sol üst konumu. Örn. 37.553,-122.453 |
|
typeahead
|
query |
boolean |
Boolean. Typeahead bayrağı ayarlanırsa, sorgu kısmi giriş olarak yorumlanır ve arama tahmin moduna girer |
|
view
|
query |
Localized |
View parametresi ("kullanıcı bölgesi" parametresi olarak da adlandırılır), jeopolitik olarak tartışmalı bölgeler için belirli bir ülke/bölge için doğru haritaları göstermenizi sağlar. Farklı ülkeler/bölgeler bu tür bölgelerin farklı görünümlerine sahiptir ve Görünüm parametresi uygulamanızın, uygulamanızın hizmet verecek olduğu ülke/bölge için gereken görünüme uyması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' seçeneğini ayarlayabilirsiniz. Azure Haritalar'deki 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 yasalar 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 Microsoft Entra ID güvenliğini kullanmak için kılavuz için aşağıdaki makalelere bakın. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Search |
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 City Seattle
Sample Request
GET https://atlas.microsoft.com/search/fuzzy/json?api-version=1.0&query=seattle&openingHours=nextSevenDays
Sample Response
{
"summary": {
"query": "seattle",
"queryType": "NON_NEAR",
"queryTime": 66,
"numResults": 10,
"offset": 0,
"totalResults": 3720,
"fuzzyLevel": 1
},
"results": [
{
"type": "Geography",
"id": "US/GEO/p0/188055",
"score": 2.531,
"entityType": "Municipality",
"address": {
"municipality": "Seattle",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle",
"countrySubdivisionCode": "WA",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Seattle, WA",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.60323,
"lon": -122.33028
},
"viewport": {
"topLeftPoint": {
"lat": 47.7344,
"lon": -122.4594
},
"btmRightPoint": {
"lat": 47.48106,
"lon": -122.22497
}
},
"dataSources": {
"geometry": {
"id": "00005557-4100-3c00-0000-0000596ae8ed"
}
}
},
{
"type": "Geography",
"id": "US/GEO/p0/183911",
"score": 2.382,
"entityType": "Municipality",
"address": {
"municipality": "Seattle",
"countrySecondarySubdivision": "King",
"countrySubdivisionCode": "WA",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Seattle, WA",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.55342,
"lon": -122.25007
},
"viewport": {
"topLeftPoint": {
"lat": 47.58995,
"lon": -122.26723
},
"btmRightPoint": {
"lat": 47.5169,
"lon": -122.23291
}
},
"dataSources": {
"geometry": {
"id": "00005557-4100-3c00-0000-00006553f33d"
}
}
},
{
"type": "POI",
"id": "ZA/POI/p0/449288",
"score": 2.226,
"info": "search:ta:710009004165863-ZA",
"poi": {
"name": "Seattle Coffee Co - Groote Kerk Sentrum",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetName": "Kloof Street",
"municipalitySubdivision": "Cape Town",
"municipality": "Cape Town",
"countrySecondarySubdivision": "City of Cape Town",
"countrySubdivisionCode": "Western Cape",
"postalCode": "8001",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Kloof Street, Gardens, City of Cape Town, Western Cape, 8001",
"localName": "Gardens"
},
"position": {
"lat": -33.92917,
"lon": 18.41178
},
"viewport": {
"topLeftPoint": {
"lat": -33.92827,
"lon": 18.4107
},
"btmRightPoint": {
"lat": -33.93007,
"lon": 18.41286
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -33.92907,
"lon": 18.41162
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/449396",
"score": 2.226,
"info": "search:ta:710009004163591-ZA",
"poi": {
"name": "Seattle Coffee Co - Pietermaritzburg",
"phone": "+(27)-(33)-3458486",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "9",
"streetName": "Armitage Road",
"municipalitySubdivision": "Pietermaritzburg City, Pietermaritzburg",
"municipality": "Pietermaritzburg",
"countrySecondarySubdivision": "The Msunduzi",
"countrySubdivisionCode": "KwaZulu-Natal",
"postalCode": "3201",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Armitage Road 9, Athlone, The Msunduzi, KwaZulu-Natal, 3201",
"localName": "Athlone"
},
"position": {
"lat": -29.58611,
"lon": 30.37508
},
"viewport": {
"topLeftPoint": {
"lat": -29.58521,
"lon": 30.37405
},
"btmRightPoint": {
"lat": -29.58701,
"lon": 30.37611
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -29.58668,
"lon": 30.37531
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/451868",
"score": 2.226,
"info": "search:ta:710009002195538-ZA",
"poi": {
"name": "Seattle Coffee Co - Bedford Village",
"phone": "+(27)-(84)-5451111",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetName": "Van Buuren Road",
"municipalitySubdivision": "Bedfordview",
"municipality": "Germiston",
"countrySecondarySubdivision": "Ekurhuleni",
"countrySubdivisionCode": "Gauteng",
"postalCode": "2007",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Van Buuren Road, Bedfordview, Ekurhuleni, Gauteng, 2007",
"localName": "Bedfordview"
},
"position": {
"lat": -26.18009,
"lon": 28.13544
},
"viewport": {
"topLeftPoint": {
"lat": -26.17919,
"lon": 28.13444
},
"btmRightPoint": {
"lat": -26.18099,
"lon": 28.13644
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -26.18006,
"lon": 28.13636
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/488888",
"score": 2.226,
"info": "search:ta:710009002102639-ZA",
"poi": {
"name": "Seattle Coffee Co - Caltex Starstop Milly's",
"phone": "+(27)-(13)-2560340",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"municipality": "Wonderfontein",
"countrySecondarySubdivision": "Emakhazeni",
"countrySubdivisionCode": "Mpumalanga",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Wonderfontein, Emakhazeni, Mpumalanga"
},
"position": {
"lat": -25.68842,
"lon": 30.21291
},
"viewport": {
"topLeftPoint": {
"lat": -25.68752,
"lon": 30.21191
},
"btmRightPoint": {
"lat": -25.68932,
"lon": 30.21391
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -25.68913,
"lon": 30.21343
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/489433",
"score": 2.226,
"info": "search:ta:710009002184068-ZA",
"poi": {
"name": "Seattle Coffee Co - Southcoast Mall",
"phone": "+(27)-(39)-3150816",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"municipalitySubdivision": "Shelly Beach",
"municipality": "Shelly Beach",
"countrySecondarySubdivision": "Hibiscus Coast",
"countrySubdivisionCode": "KwaZulu-Natal",
"postalCode": "4265",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Shelly Beach, Hibiscus Coast, KwaZulu-Natal, 4265",
"localName": "Shelly Beach"
},
"position": {
"lat": -30.79937,
"lon": 30.40569
},
"viewport": {
"topLeftPoint": {
"lat": -30.79847,
"lon": 30.40464
},
"btmRightPoint": {
"lat": -30.80027,
"lon": 30.40674
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -30.7994,
"lon": 30.40618
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/489976",
"score": 2.226,
"info": "search:ta:710009004261897-ZA",
"poi": {
"name": "Seattle Cofee Co",
"phone": "+(27)-(39)-3150816",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"municipalitySubdivision": "Shelly Beach",
"municipality": "Shelly Beach",
"countrySecondarySubdivision": "Hibiscus Coast",
"countrySubdivisionCode": "KwaZulu-Natal",
"postalCode": "4265",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Shelly Beach, Hibiscus Coast, KwaZulu-Natal, 4265",
"localName": "Shelly Beach"
},
"position": {
"lat": -30.79801,
"lon": 30.40557
},
"viewport": {
"topLeftPoint": {
"lat": -30.79711,
"lon": 30.40452
},
"btmRightPoint": {
"lat": -30.79891,
"lon": 30.40662
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -30.79784,
"lon": 30.40523
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/490056",
"score": 2.226,
"info": "search:ta:710009004149612-ZA",
"poi": {
"name": "Seattle Coffee Co - Constantia Village",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetName": "Constantia Main Road",
"municipalitySubdivision": "Cape Town",
"municipality": "Cape Town",
"countrySecondarySubdivision": "City of Cape Town",
"countrySubdivisionCode": "Western Cape",
"postalCode": "7708",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Constantia Main Road, Constantia, City of Cape Town, Western Cape, 7708",
"localName": "Constantia"
},
"position": {
"lat": -34.02087,
"lon": 18.44503
},
"viewport": {
"topLeftPoint": {
"lat": -34.01997,
"lon": 18.44394
},
"btmRightPoint": {
"lat": -34.02177,
"lon": 18.44612
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -34.02017,
"lon": 18.44476
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/494340",
"score": 2.226,
"info": "search:ta:710009004152570-ZA",
"poi": {
"name": "Seattle Coffee Co - Canal Walk Shopping Centre",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetName": "Century Boulevard",
"municipalitySubdivision": "Milnerton",
"municipality": "Cape Town",
"countrySecondarySubdivision": "City of Cape Town",
"countrySubdivisionCode": "Western Cape",
"postalCode": "7441",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Century Boulevard, Century City, City of Cape Town, Western Cape, 7441",
"localName": "Century City"
},
"position": {
"lat": -33.89348,
"lon": 18.5122
},
"viewport": {
"topLeftPoint": {
"lat": -33.89258,
"lon": 18.51112
},
"btmRightPoint": {
"lat": -33.89438,
"lon": 18.51328
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -33.8943,
"lon": 18.51328
}
}
]
}
]
}
Tanımlar
Name | Description |
---|---|
Address |
Sonucun adresi |
Address |
Arama sonucu için caddenin her iki tarafındaki adres aralığını açıklar. Adres aralığının başlangıç ve bitiş konumlarının koordinatları eklenir. |
Bounding |
Görünüm penceresinin sol üst ve sağ alt koordinatlarıyla gösterilen sonucu kapsayan görünüm penceresi. |
Bounding |
Konumun sınırlayıcı kutusu. |
Brand |
POI ile ilişkili marka |
Classification |
Döndürülen POI sınıflandırması |
Classification |
Sınıflandırmanın adı |
Data |
İsteğe bağlı bölüm. Get Arama Polygon API'si ile kullanım için başvuru kimlikleri. |
Electric |
Sonucu belirli bağlayıcı türlerini destekleyen Elektrikli Araç İstasyonu ile kısıtlamak için kullanılabilecek bağlayıcı türlerinin virgülle ayrılmış listesi. Madde siparişi önemli değil. Birden çok bağlayıcı türü sağlandığında, yalnızca sağlanan listeden birine (en az) ait olan sonuçlar döndürülür. Kullanılabilir bağlayıcı türleri şunlardır:
Kullanım örnekleri: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
Entity |
Sınırlayıcı kutunun varlık türü kaynağı. Ters coğrafi kodlama için bu her zaman konuma eşittir. |
Entry |
Döndürülen POI için giriş noktası. |
Entry |
Giriş noktası türü. Değer ana veya küçük olabilir. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı |
Geographic |
Coğrafya varlık türü. Yalnızca entityType istendiğinde ve kullanılabilir olduğunda bulunur. |
Geometry |
Sonucun geometrik şekli hakkında bilgi. Yalnızca == Coğrafya türünde mevcut. |
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), jeopolitik olarak tartışmalı bölgeler için belirli bir ülke/bölge için doğru haritaları göstermenizi sağlar. Farklı ülkeler/bölgeler bu tür bölgelerin farklı görünümlerine sahiptir ve Görünüm parametresi uygulamanızın, uygulamanızın hizmet verecek olduğu ülke/bölge için gereken görünüme uyması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' seçeneğini ayarlayabilirsiniz. Azure Haritalar'deki 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 yasalar 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. |
Match |
Ters adres arama işlemi için eşleşme türleri. |
Operating |
PoI için açılış saatleri (İlgi Çekici Noktalar). |
Operating |
PoI için çalışma saatleri (İlgi Çekici Noktalar). Çalışma saatlerinin kullanılabilirliği, kullanılabilir verilere göre değişir. Geçirilmediyse, hiçbir çalışma saati bilgisi döndürülmeyecektir. Desteklenen değer: nextSevenDays |
Operating |
Tarih ve saati temsil eder |
Operating |
Bir gün için açık zaman aralığı |
Point |
Ad, telefon, URL adresi ve sınıflandırmalar gibi bilgiler de dahil olmak üzere döndürülen POI'nin ayrıntıları. |
Point |
POI kategorisi |
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. |
Search |
Bu nesne başarılı bir Arama çağrılarından döndürülür. |
Search |
Arama API yanıtı için sonuç nesnesi. |
Search |
Bunlardan biri:
|
Search |
Genişletilmiş posta kodlarının sonuçlara eklenmesi gereken dizinler. Kullanılabilir dizinler şunlardır: Ekleyici = Adres aralıkları Coğrafi = Coğrafyalar PAD = Nokta Adresleri POI = İlgi Çekici Noktalar Str = Sokaklar XStr = Caddeler Arası (kesişimler) Değer, dizin türlerinin virgülle ayrılmış bir listesi (herhangi bir sırada) veya dizin olmadan Hiçbiri olmalıdır. Varsayılan olarak, Geo dışındaki tüm dizinler için genişletilmiş posta kodları eklenir. Coğrafyalar için genişletilmiş posta kodu listeleri oldukça uzun olabilir, bu nedenle gerektiğinde açıkça istenmeleri gerekir. Kullanım örnekleri: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Genişletilmiş posta kodu bir adresin extendedPostalCode özelliği olarak döndürülür. Kullanılabilirlik bölgeye bağlıdır. |
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 |
Karşıya geçilen caddenin adı. |
extendedPostalCode |
string |
Genişletilmiş posta kodu (kullanılabilirlik bölgeye bağlıdır). |
freeformAddress |
string |
Sonucun kaynak ü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 |
Bir yönetim birimi olmadan adresleme amacıyla birden çok adreslenebilir nesneyi 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, ayırt edici özelliklere ve sakinler arasındaki sosyal etkileşimlere sahip coğrafi olarak yerelleştirilmiş bir alandır. |
postalCode |
string |
Posta Kodu / Posta Kodu |
routeNumbers |
string[] |
Caddeyi net bir şekilde 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ı. |
AddressRanges
Arama sonucu için caddenin her iki tarafındaki adres aralığını açıklar. Adres aralığının başlangıç ve bitiş konumlarının koordinatları eklenir.
Name | Tür | Description |
---|---|---|
from |
Lat |
'lon' & 'lat' kısa adları kullanılarak enlem ve boylam olarak temsil edilen konum. |
rangeLeft |
string |
Caddenin sol tarafındaki adres aralığı. |
rangeRight |
string |
Caddenin sağ tarafındaki adres aralığı. |
to |
Lat |
'lon' & 'lat' kısa adları kullanılarak enlem ve boylam olarak temsil edilen konum. |
BoundingBox
Görünüm penceresinin sol üst ve sağ alt koordinatlarıyla gösterilen sonucu kapsayan görünüm penceresi.
Name | Tür | Description |
---|---|---|
btmRightPoint |
Lat |
'lon' & 'lat' kısa adları kullanılarak enlem ve boylam olarak temsil edilen konum. |
topLeftPoint |
Lat |
'lon' & 'lat' kısa adları kullanılarak enlem ve boylam olarak temsil edilen konum. |
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 |
Sınırlayıcı kutunun virgülle ayrılmış float'lar olarak kuzey-doğu enlem,boylam koordinatı |
southWest |
string |
Virgülle ayrılmış float olarak sınırlayıcı kutunun güney-batı enlemi,boylam koordinatı |
Brand
POI ile ilişkili marka
Name | Tür | Description |
---|---|---|
name |
string |
Markanın adı |
Classification
Döndürülen POI sınıflandırması
Name | Tür | Description |
---|---|---|
code |
string |
Kod özelliği |
names |
Classification |
Ad dizisi |
ClassificationName
Sınıflandırmanın adı
Name | Tür | Description |
---|---|---|
name |
string |
Name özelliği |
nameLocale |
string |
Name Locale özelliği |
DataSources
İsteğe bağlı bölüm. Get Arama Polygon API'si ile kullanım için başvuru kimlikleri.
Name | Tür | Description |
---|---|---|
geometry |
Sonucun geometrik şekli hakkında bilgi. Yalnızca == Coğrafya türünde mevcut. |
ElectricVehicleConnector
Sonucu belirli bağlayıcı türlerini destekleyen Elektrikli Araç İstasyonu ile kısıtlamak için kullanılabilecek bağlayıcı türlerinin virgülle ayrılmış listesi. Madde siparişi önemli değil. Birden çok bağlayıcı türü sağlandığında, yalnızca sağlanan listeden birine (en az) ait olan sonuçlar döndürülür.
Kullanılabilir bağlayıcı türleri şunlardır:
StandardHouseholdCountrySpecific
- Bunlar belirli bir bölge için standart ev bağlayıcılarıdır. Hepsi AC tek fazlı ve standart Gerilim ve standart Amperajdır. Ayrıca bkz. Fiş & yuva türleri - Dünya Standartları.IEC62196Type1
- IEC 62196-2 standardında tanımlandığı gibi tür 1 bağlayıcısı. Orijinal üreticiden sonra Yazaki veya ilk yayımlayan standart sonrasında SAE J1772 olarak da adlandırılır. Çoğunlukla 120V tek fazlı veya 240V'a kadar tek fazlı altyapı ile birlikte kullanılır.IEC62196Type1CCS
- IEC 62196-3 standardında tanımlanan tür 1 tabanlı birleşik bağlayıcı. Bağlayıcı, DC hızlı şarja izin vermek için iki ek doğrudan akım (DC) kişisi ile IEC 62196-2 standardında tanımlandığı gibi Tür 1 bağlayıcısını temel alır.IEC62196Type2CableAttached
- IEC 62196-2 standardında tanımlandığı gibi tür 2 bağlayıcısı. Şarj noktasına takılı bir kablo ve fiş olarak sağlanır.IEC62196Type2Outlet
- IEC 62196-2 standardında tanımlandığı gibi tür 2 bağlayıcısı. Şarj noktasına bir yuva kümesi olarak sağlanır.IEC62196Type2CCS
- IEC 62196-3 standardında tanımlanan tür 2 tabanlı birleşik bağlayıcı. Bağlayıcı, IEC 62196-2 standardında tanımlandığı gibi, DC hızlı şarja izin vermek için iki ek doğrudan akım (DC) kişisi ile Tip 2 bağlayıcısını temel alır.IEC62196Type3
- IEC 62196-2 standardında tanımlandığı gibi tür 3 bağlayıcısı. Orijinal üreticiden sonra Scame olarak da adlandırılır. Çoğunlukla 240V'a kadar tek fazlı veya 420V'ye kadar üç fazlı altyapı ile birlikte kullanılır.Chademo
- CHAdeMO bağlayıcısı, Tokyo Electric Power Company ve endüstriyel iş ortakları tarafından kurulan bir ilişkilendirmenin adını almıştır. Bu yüzden TEPCO bağlayıcısı olarak da bilinir. Hızlı DC şarjı destekler.IEC60309AC1PhaseBlue
- Endüstriyel Mavi bağlayıcı, IEC 60309 standardında tanımlanan bir bağlayıcıdır. Bazen standart, renk ve tek fazlı bağlayıcı olduğu gerçeğinin bir bileşimi tarafından adlandırılır. Bağlayıcı genellikle "P+N+E, 6h" yapılandırmasına sahiptir.IEC60309DCWhite
- Endüstriyel Beyaz bağlayıcı, IEC 60309 standardında tanımlanan bir DC bağlayıcıdır.Tesla
- Tesla bağlayıcısı bölgesel olarak özel Tesla Supercharger bağlayıcısıdır. Yani, Tesla'nın özel bağlayıcısını ifade eder; bazen Tesla Bağlantı Noktası çoğunlukla Kuzey Amerika veya Avrupa'daki değiştirilmiş Tip 2 (DC, Type 2 üzerinde) ile sınırlıdır.
Kullanım örnekleri:
connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached
Name | Tür | Description |
---|---|---|
Chademo |
string |
CHAdeMO bağlayıcısı, Tokyo Electric Power Company ve endüstriyel ortaklar tarafından oluşturulan bir ilişkilendirmenin adını almıştır. Bu yüzden TEPCO bağlayıcısı olarak da bilinir. Hızlı DC şarjı destekler. |
IEC60309AC1PhaseBlue |
string |
Endüstriyel Mavi bağlayıcı, IEC 60309 standardında tanımlanan bir bağlayıcıdır. Bazen standart, renk ve tek fazlı bağlayıcı olduğu gerçeğinin bir bileşimi tarafından adlandırılır. Bağlayıcı genellikle "P+N+E, 6h" yapılandırmasına sahiptir. |
IEC60309DCWhite |
string |
Endüstriyel Beyaz bağlayıcı, IEC 60309 standardında tanımlanan bir DC bağlayıcıdır. |
IEC62196Type1 |
string |
IEC 62196-2 standardında tanımlanan tür 1 bağlayıcısı. Orijinal üreticiden sonra Yazaki veya ilk yayımlayan standart sonrasında SAE J1772 olarak da adlandırılır. Çoğunlukla 120V tek fazlı veya 240V'a kadar tek fazlı altyapı ile birlikte kullanılır. |
IEC62196Type1CCS |
string |
IEC 62196-3 standardında tanımlandığı gibi tür 1 tabanlı birleşik bağlayıcı. Bağlayıcı, DC hızlı şarja izin vermek için iki ek doğrudan akım (DC) kişisi ile IEC 62196-2 standardında tanımlandığı gibi Tür 1 bağlayıcısını temel alır. |
IEC62196Type2CCS |
string |
IEC 62196-3 standardında tanımlanan tür 2 tabanlı birleşik bağlayıcı. Bağlayıcı, IEC 62196-2 standardında tanımlandığı gibi, DC hızlı şarja izin vermek için iki ek doğrudan akım (DC) kişisi ile Tip 2 bağlayıcısını temel alır. |
IEC62196Type2CableAttached |
string |
IEC 62196-2 standardında tanımlandığı gibi tür 2 bağlayıcısı. Şarj noktasına takılı bir kablo ve fiş olarak sağlanır |
IEC62196Type2Outlet |
string |
IEC 62196-2 standardında tanımlandığı gibi tür 2 bağlayıcısı. Şarj noktasına bir yuva kümesi olarak sağlanır. |
IEC62196Type3 |
string |
IEC 62196-2 standardında tanımlandığı gibi 3 bağlayıcı yazın. Orijinal üreticiden sonra Scame olarak da adlandırılır. Çoğunlukla 240V'a kadar tek fazlı veya 420V'ye kadar üç fazlı altyapı ile birlikte kullanılır. |
StandardHouseholdCountrySpecific |
string |
Bunlar belirli bir bölge için standart ev bağlayıcılarıdır. Hepsi AC tek fazlı ve standart Gerilim ve standart Amperajdır. Ayrıca bkz. Fiş & yuva türleri - Dünya Standartları |
Tesla |
string |
Tesla bağlayıcısı bölgesel olarak özel Tesla Supercharger bağlayıcısıdır. Yani, Tesla'nın özel bağlayıcısını ifade eder; bazen Tesla Bağlantı Noktası çoğunlukla Kuzey Amerika veya Avrupa'daki değiştirilmiş Tip 2 (DC, Type 2 üzerinde) ile sınırlıdır. |
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ığı |
EntryPoint
Döndürülen POI için giriş noktası.
Name | Tür | Description |
---|---|---|
position |
Lat |
'lon' & 'lat' kısa adları kullanılarak enlem ve boylam olarak temsil edilen konum. |
type |
Entry |
Giriş noktası türü. Değer ana veya küçük olabilir. |
EntryPointType
Giriş noktası türü. Değer ana veya küçük olabilir.
Name | Tür | Description |
---|---|---|
main |
string |
|
minor |
string |
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. |
GeographicEntityType
Coğrafya varlık türü. Yalnızca entityType istendiğinde ve kullanılabilir olduğunda bulunur.
Name | Tür | Description |
---|---|---|
Country |
string |
ülke/bölge adı |
CountrySecondarySubdivision |
string |
İlçe |
CountrySubdivision |
string |
Eyalet veya İl |
CountryTertiarySubdivision |
string |
Adlandırılmış Alan |
Municipality |
string |
Şehir / Şehir |
MunicipalitySubdivision |
string |
Sub / Super City |
Neighbourhood |
string |
Mahalle |
PostalCodeArea |
string |
Posta Kodu / Posta Kodu |
Geometry
Sonucun geometrik şekli hakkında bilgi. Yalnızca == Coğrafya türünde mevcut.
Name | Tür | Description |
---|---|---|
id |
string |
Bu sonucun geometri bilgilerini getirmek için bunu Get Arama Polygon API'sine geometryId olarak geçirin. |
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), jeopolitik olarak tartışmalı bölgeler için belirli bir ülke/bölge için doğru haritaları göstermenizi sağlar. Farklı ülkeler/bölgeler bu tür bölgelerin farklı görünümlerine sahiptir ve Görünüm parametresi uygulamanızın, uygulamanızın hizmet verecek olduğu ülke/bölge için gereken görünüme uyması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' seçeneğini ayarlayabilirsiniz. Azure Haritalar'deki 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 yasalar 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ü) |
MatchType
Ters adres arama işlemi için eşleşme türleri.
Name | Tür | Description |
---|---|---|
AddressPoint |
string |
|
HouseNumberRange |
string |
|
Street |
string |
OperatingHours
PoI için açılış saatleri (İlgi Çekici Noktalar).
Name | Tür | Description |
---|---|---|
mode |
string |
İstekte kullanılan değer: none veya "nextSevenDays" |
timeRanges |
Operating |
Sonraki 7 günün zaman aralıkları listesi |
OperatingHoursRange
PoI için çalışma saatleri (İlgi Çekici Noktalar). Çalışma saatlerinin kullanılabilirliği, kullanılabilir verilere göre değişir. Geçirilmediyse, hiçbir çalışma saati bilgisi döndürülmeyecektir. Desteklenen değer: nextSevenDays
Name | Tür | Description |
---|---|---|
nextSevenDays |
string |
POI'nin yerel saatindeki geçerli günden başlayarak sonraki haftanın çalışma saatlerini gösterir. |
OperatingHoursTime
Tarih ve saati temsil eder
Name | Tür | Description |
---|---|---|
date |
string |
POI saat dilimindeki geçerli takvim tarihini temsil eder, örneğin "2019-02-07". |
hour |
integer |
Saatler, POI'nin yerel saatinde 24 saat biçimindedir; olası değerler 0 - 23'dür. |
minute |
integer |
Dakikalar bir POI'nin yerel saatindedir; olası değerler 0 - 59'dır. |
OperatingHoursTimeRange
Bir gün için açık zaman aralığı
Name | Tür | Description |
---|---|---|
endTime |
Operating |
Belirli bir POI'nin kapatıldığı sonraki 7 gün aralığındaki nokta veya aralık öncesinde kapalıysa aralığın başlangıcı. |
startTime |
Operating |
Belirli bir POI'nin açıldığı sonraki 7 gün aralığındaki nokta veya aralık öncesinde açılmışsa aralığın başlangıcı. |
PointOfInterest
Ad, telefon, URL adresi ve sınıflandırmalar gibi bilgiler de dahil olmak üzere döndürülen POI'nin ayrıntıları.
Name | Tür | Description |
---|---|---|
brands |
Brand[] |
Markalar dizisi. İade edilen POI markasının adı. |
categories |
string[] |
Kategoriler dizisi |
categorySet |
Point |
En özel POI kategorilerinin listesi |
classifications |
Sınıflandırma dizisi |
|
name |
string |
POI özelliğinin adı |
openingHours |
Operating |
PoI için açılış saatleri (İlgi Çekici Noktalar). |
phone |
string |
Telefon numarası özelliği |
url |
string |
Web sitesi URL özelliği |
PointOfInterestCategorySet
POI kategorisi
Name | Tür | Description |
---|---|---|
id |
integer |
Kategori Kimliği |
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 |
SearchAddressResult
Bu nesne başarılı bir Arama çağrılarından döndürülür.
Name | Tür | Description |
---|---|---|
results |
Search |
Arama API sonuçlarının listesi. |
summary |
Search |
Arama API yanıtı için özet nesnesi |
SearchAddressResultItem
Arama API yanıtı için sonuç nesnesi.
Name | Tür | Description |
---|---|---|
address |
Sonucun adresi |
|
addressRanges |
Address |
Bir arama sonucu için caddenin her iki tarafındaki adres aralığını açıklar. Adres aralığının başlangıç ve bitiş konumları için koordinatlar eklenir. |
dataSources |
Data |
İsteğe bağlı bölüm. Get Arama Polygon API'si ile kullanmak için başvuru geometrisi kimliği. |
detourTime |
integer |
Saniyeler içinde dolambaçlı zaman. Yalnızca Arama Yol Boyunca API'sine yapılan çağrılar için döndürülür. |
dist |
number |
Ölçümlerdeki sonuç ve coğrafi konum arasındaki düz çizgi uzaklığı. |
entityType |
Geographic |
Coğrafya varlık türü. Yalnızca entityType istendiğinde ve kullanılabilir olduğunda bulunur. |
entryPoints |
Entry |
EntryPoint dizisi. Bunlar, konumda bulunan giriş türlerini açıklar. Tür, ön kapı veya lobi gibi ana girişler için "ana" ve yan ve arka kapılar için "küçük" olabilir. |
id |
string |
Kimlik özelliği |
info |
string |
Sonucun özgün veri kaynağı hakkında bilgi. Destek istekleri için kullanılır. |
matchType |
Match |
Eşleşme türü hakkında bilgi. Bunlardan biri:
|
poi |
Point |
Ad, telefon, URL adresi ve sınıflandırmalar gibi bilgiler de dahil olmak üzere döndürülen POI'nin ayrıntıları. |
position |
Lat |
'lon' & 'lat' kısa adları kullanılarak enlem ve boylam olarak temsil edilen konum. |
score |
number |
Sonuçlar arasındaki göreli eşleştirme puanını göstermek için sonuç kümesi içindeki değer. X değerinin y değerinin 2 katı olması durumunda x sonucunun y sonucunun iki katı kadar ilgili olma olasılığını belirlemek için bunu kullanabilirsiniz. Değerler sorgular arasında farklılık gösterir ve yalnızca bir sonuç kümesi için göreli değer olarak amaçlanır. |
type |
Search |
Bunlardan biri:
|
viewport |
Bounding |
Görünüm penceresinin sol üst ve sağ alt koordinatlarıyla gösterilen sonucu kapsayan görünüm penceresi. |
SearchAddressResultType
Bunlardan biri:
- POI
- Sokak
- Coğrafya
- Nokta Adresi
- Adres Aralığı
- Çapraz Cadde
Name | Tür | Description |
---|---|---|
Address Range |
string |
|
Cross Street |
string |
|
Geography |
string |
|
POI |
string |
|
Point Address |
string |
|
Street |
string |
SearchIndexes
Genişletilmiş posta kodlarının sonuçlara eklenmesi gereken dizinler.
Kullanılabilir dizinler şunlardır:
Ekleyici = Adres aralıkları
Coğrafi = Coğrafyalar
PAD = Nokta Adresleri
POI = İlgi Çekici Noktalar
Str = Sokaklar
XStr = Caddeler Arası (kesişimler)
Değer, dizin türlerinin virgülle ayrılmış bir listesi (herhangi bir sırada) veya dizin olmadan Hiçbiri olmalıdır.
Varsayılan olarak, Geo dışındaki tüm dizinler için genişletilmiş posta kodları eklenir. Coğrafyalar için genişletilmiş posta kodu listeleri oldukça uzun olabilir, bu nedenle gerektiğinde açıkça istenmeleri gerekir.
Kullanım örnekleri:
extendedPostalCodesFor=POI
extendedPostalCodesFor=PAD,Addr,POI
extendedPostalCodesFor=None
Genişletilmiş posta kodu bir adresin extendedPostalCode özelliği olarak döndürülür. Kullanılabilirlik bölgeye bağlıdır.
Name | Tür | Description |
---|---|---|
Addr |
string |
|
Geo |
string |
|
PAD |
string |
|
POI |
string |
|
Str |
string |
|
Xstr |
string |
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ı. |