Search - Post Search Fuzzy Batch
Tek bir zaman uyumsuz istekte Arama Benzer API'sine bir grup sorgu göndermek için kullanın.
Post Search Fuzzy Batch
API, tek bir zaman uyumsuz çağrıda Arama Benzer API'ye toplu sorgular gönderen bir HTTP POST
isteğidir. Zaman uyumsuz (zaman uyumsuz) veya zaman uyumlu (eşitleme) çalıştırmak için Arama Benzer Batch API'sini çağırabilirsiniz. Zaman uyumsuz API, çağıranın en fazla 10.000 sorguyu toplu olarak toplamasına ve API'yi 100 sorguya kadar eşitlemesine olanak tanır.
Zaman Uyumlu Toplu İş İsteği Gönderme
Basit toplu istekler için Zaman Uyumlu API önerilir. Hizmet bir istek aldığında, toplu iş öğeleri hesaplandığında hemen yanıt verir ve sonuçları daha sonra alma imkanı olmaz. İstek 60 saniyeden uzun sürerse Zaman Uyumlu API bir zaman aşımı hatası (408 yanıtı) döndürür. Bu API için toplu iş öğelerinin sayısı 100 ile sınırlıdır.
POST https://atlas.microsoft.com/search/fuzzy/batch/sync/json?api-version=1.0&subscription-key={subscription-key}
Zaman Uyumsuz Toplu İş İsteği Gönderme
Zaman Uyumsuz API, görece karmaşık arama isteklerinin büyük hacimlerini işlemek için uygundur
- Sonuçların ayrı bir çağrıda alınmasına izin verir (birden çok indirme mümkündür).
- Zaman uyumsuz API güvenilirlik için iyileştirilmiştir ve zaman aşımına uğrması beklenmez.
- Bu API için toplu iş öğelerinin sayısı 10.000 ile sınırlıdır.
Zaman uyumsuz istek kullanarak istekte bulunduğunuzda, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanındaki yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenmelidir. Zaman uyumsuz yanıtlar 14 gün boyunca depolanır. Yeniden yönlendirme URL'si, süre sonundan sonra kullanılırsa bir 404 yanıtı döndürür.
Zaman uyumsuz toplu iş isteğinin uzun süre çalışan bir işlem olduğunu lütfen unutmayın. Aşağıda tipik bir işlem dizisi verilmiştir:
- İstemci, Azure Haritalar Arama Benzer Toplu İş
POST
isteği gönderir.
POST https://atlas.microsoft.com/search/fuzzy/batch/json?api-version=1.0&subscription-key={subscription-key}
Sunucu aşağıdakilerden biriyle yanıt verir:
HTTP
202 Accepted
- Toplu iş isteği kabul edildi.HTTP
Error
- Batch isteğiniz işlenirken bir hata oluştu. Bu bir veya başkaError
bir400 Bad Request
durum kodu olabilir.Toplu istek başarıyla kabul edildiyse, yanıttaki
Location
üst bilgi toplu iş isteğinin sonuçlarını indirmek için URL'yi içerir. Bu durum URI'sı aşağıdaki gibi görünür:
GET https://atlas.microsoft.com/search/fuzzy/batch/{batch-id}?api-version=1.0&subscription-key={subscription-key}
- İstemci, toplu iş sonuçlarını indirmek için 3. Adımda alınan indirme URL'sinde bir
GET
istek gönderir.
Toplu İstek için POST Gövdesi
Arama benzeri sorgularını göndermek için istek gövdesinin diziyi batchItems
json
biçiminde içerdiği ve Content-Type
üst bilginin olarak ayarlanacağı application/json
bir POST
istek kullanacaksınız. Aşağıda 5 arama belirsiz sorgusu içeren bir örnek istek gövdesi verilmişti :
{
"batchItems": [
{"query": "?query=atm&lat=47.639769&lon=-122.128362&radius=5000&limit=5"},
{"query": "?query=Statue Of Liberty&limit=2"},
{"query": "?query=Starbucks&lat=47.639769&lon=-122.128362&radius=5000"},
{"query": "?query=Space Needle"},
{"query": "?query=pizza&limit=10"}
]
}
Toplu işteki arama belirsiz sorgusu yalnızca protokol, temel URL, yol, api sürümü ve abonelik anahtarı olmayan kısmi bir URL'dir. Desteklenen arama belirsizURI parametrelerinden herhangi birini kabul edebilir. Arama belirsiz sorgusundaki dize değerlerinin doğru şekilde kaçış karakteri (örneğin , " karakteri \ ile kaçış karakteri) ve ayrıca düzgün URL ile kodlanmış olması gerekir.
Zaman uyumsuz API, çağıranın en fazla 10.000 sorguyu toplu işlemesine ve API'yi en çok 100 sorguyu eşitlemesine olanak tanır ve toplu işlem en az 1 sorgu içermelidir.
Zaman Uyumsuz Toplu İş Sonuçlarını İndirme
Zaman uyumsuz toplu iş sonuçlarını indirmek için toplu indirme uç noktasına bir GET
istek gönderirsiniz. Bu indirme URL'si başarılı POST
bir toplu iş isteğinin Location
üst bilgisinden alınabilir ve aşağıdaki gibi görünür:
https://atlas.microsoft.com/search/fuzzy/batch/{batch-id}?api-version=1.0&subscription-key={subscription-key}
Toplu iş sonuçlarını indirmek için tipik işlem dizisi aşağıda verilmiştir:
İstemci, indirme URL'sini kullanarak bir
GET
istek gönderir.Sunucu aşağıdakilerden biriyle yanıt verir:
HTTP
202 Accepted
- Toplu istek kabul edildi ancak hala işleniyor. Lütfen bir süre sonra yeniden deneyin.HTTP
200 OK
- Toplu iş isteği başarıyla işlendi. Yanıt gövdesi tüm toplu iş sonuçlarını içerir.
Toplu Yanıt Modeli
Döndürülen veri içeriği, zaman uyumsuz ve eşitleme istekleri için benzerdir. Zaman uyumsuz bir toplu iş isteğinin sonuçları indirilirken, toplu işin işlenmesi tamamlandıysa yanıt gövdesi toplu iş yanıtını içerir. Bu toplu yanıt, özgün toplu iş isteğinin totalRequests
parçası olan öğesini ve successfulRequests
örneğin başarıyla yürütülen sorguları gösteren bir summary
bileşen içerir. Toplu yanıt, toplu iş isteğindeki her sorgu için bir yanıt içeren bir batchItems
dizi de içerir. , batchItems
sonuçları özgün sorguların toplu istekte gönderildiği sırayla içerir. içindeki batchItems
her öğe ve response
alanlarını içerirstatusCode
. içindeki batchItems
her response
biri aşağıdaki türlerden biridir:
SearchAddressResult
- Sorgu başarıyla tamamlanırsa.Error
- Sorgu başarısız olduysa. Yanıt, bu durumda bircode
vemessage
içerir.
Aşağıda 2 başarılı ve 1 başarısız sonuç içeren örnek bir Toplu yanıt verilmişti :
{
"summary": {
"successfulRequests": 2,
"totalRequests": 3
},
"batchItems": [
{
"statusCode": 200,
"response":
{
"summary": {
"query": "atm"
},
"results": [
{
"type": "POI",
"poi": {
"name": "ATM at Wells Fargo"
},
"address": {
"country": "United States Of America",
"freeformAddress": "3240 157th Ave NE, Redmond, WA 98052"
}
}
]
}
},
{
"statusCode": 200,
"response":
{
"summary": {
"query": "statue of liberty"
},
"results": [
{
"type": "POI",
"poi": {
"name": "Statue of Liberty"
},
"address": {
"country": "United States Of America",
"freeformAddress": "New York, NY 10004"
}
}
]
}
},
{
"statusCode": 400,
"response":
{
"error":
{
"code": "400 BadRequest",
"message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
}
}
}
]
}
POST https://atlas.microsoft.com/search/fuzzy/batch/json?api-version=1.0
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
format
|
path | True |
Yanıtın istenen biçimi. Yalnızca |
|
api-version
|
query | True |
string |
Azure Haritalar API'sinin sürüm numarası. |
İ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. |
İstek Gövdesi
Name | Tür | Description |
---|---|---|
batchItems |
İşlenmek üzere sorguların listesi. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam |
|
202 Accepted |
Yalnızca zaman uyumsuz istek için desteklenir. İstek Kabul Edildi: İstek işlenmek üzere kabul edildi. Sonuçları yeniden denemek veya sonuçlara erişmek için lütfen Konum Üst Bilgisindeki URL'yi kullanın. Headers Location: string |
|
Other Status Codes |
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
A Search Fuzzy Batch API call containing 5 Search Fuzzy API queries
Sample Request
POST https://atlas.microsoft.com/search/fuzzy/batch/json?api-version=1.0
{
"batchItems": [
{
"query": "?query=atm&lat=47.639769&lon=-122.128362&radius=5000&limit=5"
},
{
"query": "?query=Statue Of Liberty&limit=2"
},
{
"query": "?query=Starbucks&lat=47.639769&lon=-122.128362&radius=5000"
}
]
}
Sample Response
{
"batchItems": [
{
"statusCode": 200,
"response": {
"summary": {
"query": "atm",
"queryType": "NON_NEAR",
"queryTime": 5,
"numResults": 5,
"offset": 0,
"totalResults": 262,
"fuzzyLevel": 1,
"geoBias": {
"lat": 47.639769,
"lon": -122.128362
}
},
"results": [
{
"type": "POI",
"id": "US/POI/p0/3656546",
"score": 2.671,
"dist": 1336.1815386162032,
"info": "search:ta:840539002005905-US",
"poi": {
"name": "US Bank ATM-MONEYPASS",
"brands": [
{
"name": "US Bank ATM"
}
],
"categorySet": [
{
"id": 7397
}
],
"classifications": [
{
"code": "CASH_DISPENSER",
"names": [
{
"nameLocale": "en-US",
"name": "cash dispenser"
}
]
}
]
},
"address": {
"streetNumber": "14808",
"streetName": "NE 24th St",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98052",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "14808 NE 24th St, Redmond, WA 98052",
"localName": "Redmond",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.63229,
"lon": -122.14232
},
"viewport": {
"topLeftPoint": {
"lat": 47.63319,
"lon": -122.14365
},
"btmRightPoint": {
"lat": 47.63139,
"lon": -122.14099
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.63154,
"lon": -122.1423
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/8673325",
"score": 2.671,
"dist": 1206.8488178244172,
"info": "search:ta:840539002022072-US",
"poi": {
"name": "US Bank ATM NATIONAL ASSOCIATION",
"brands": [
{
"name": "US Bank ATM"
}
],
"categorySet": [
{
"id": 7397
}
],
"classifications": [
{
"code": "CASH_DISPENSER",
"names": [
{
"nameLocale": "en-US",
"name": "cash dispenser"
}
]
}
]
},
"address": {
"streetNumber": "15000",
"streetName": "Northeast 24Th Street",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98052",
"extendedPostalCode": "980525522",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "15000 Northeast 24Th Street, Redmond, WA 98052",
"localName": "Redmond",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.63265,
"lon": -122.14052
},
"viewport": {
"topLeftPoint": {
"lat": 47.63355,
"lon": -122.14185
},
"btmRightPoint": {
"lat": 47.63175,
"lon": -122.13919
}
},
"entryPoints": [
{
"type": "minor",
"position": {
"lat": 47.63156,
"lon": -122.14056
}
},
{
"type": "minor",
"position": {
"lat": 47.63156,
"lon": -122.14058
}
},
{
"type": "main",
"position": {
"lat": 47.63156,
"lon": -122.14048
}
},
{
"type": "main",
"position": {
"lat": 47.6324,
"lon": -122.13938
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/2736315",
"score": 2.671,
"dist": 864.7591776519859,
"info": "search:ta:840539002187855-US",
"poi": {
"name": "US Bank ATM-MONEYPASS",
"brands": [
{
"name": "US Bank ATM"
}
],
"categorySet": [
{
"id": 7397
}
],
"classifications": [
{
"code": "CASH_DISPENSER",
"names": [
{
"nameLocale": "en-US",
"name": "cash dispenser"
}
]
}
]
},
"address": {
"streetNumber": "15521",
"streetName": "Bel Red Rd",
"municipalitySubdivision": "Redmond, Northeast Bellevue, Bellevue",
"municipality": "Redmond, Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98052",
"extendedPostalCode": "980525501",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "15521 Bel Red Rd, Redmond, WA 98052",
"localName": "Redmond",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.63259,
"lon": -122.1328
},
"viewport": {
"topLeftPoint": {
"lat": 47.63349,
"lon": -122.13413
},
"btmRightPoint": {
"lat": 47.63169,
"lon": -122.13147
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.63255,
"lon": -122.13275
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/3656412",
"score": 2.67,
"dist": 2140.198538580941,
"info": "search:ta:840539001998867-US",
"poi": {
"name": "US Bank ATM NATIONAL ASSOCIATION",
"brands": [
{
"name": "US Bank ATM"
}
],
"categorySet": [
{
"id": 7397
}
],
"classifications": [
{
"code": "CASH_DISPENSER",
"names": [
{
"nameLocale": "en-US",
"name": "cash dispenser"
}
]
}
]
},
"address": {
"streetNumber": "1128",
"streetName": "156th Ave NE",
"municipalitySubdivision": "Crossroads, Bellevue",
"municipality": "Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98007",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "1128 156th Ave NE, Bellevue, WA 98007",
"localName": "Bellevue",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.62069,
"lon": -122.13213
},
"viewport": {
"topLeftPoint": {
"lat": 47.62159,
"lon": -122.13346
},
"btmRightPoint": {
"lat": 47.61979,
"lon": -122.1308
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.62069,
"lon": -122.13236
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/2736876",
"score": 2.67,
"dist": 2140.198538580941,
"info": "search:ta:840539001396789-US",
"poi": {
"name": "US Bank ATM",
"phone": "+(1)-(800)-8722657",
"brands": [
{
"name": "US Bank ATM"
}
],
"categorySet": [
{
"id": 7397
}
],
"url": "www.usbank.com",
"classifications": [
{
"code": "CASH_DISPENSER",
"names": [
{
"nameLocale": "en-US",
"name": "cash dispenser"
}
]
}
]
},
"address": {
"streetNumber": "1128",
"streetName": "156th Ave NE",
"municipalitySubdivision": "Crossroads, Bellevue",
"municipality": "Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98007",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "1128 156th Ave NE, Bellevue, WA 98007",
"localName": "Bellevue",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.62069,
"lon": -122.13213
},
"viewport": {
"topLeftPoint": {
"lat": 47.62159,
"lon": -122.13346
},
"btmRightPoint": {
"lat": 47.61979,
"lon": -122.1308
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.62069,
"lon": -122.13236
}
}
]
}
]
}
},
{
"statusCode": 200,
"response": {
"summary": {
"query": "statue of liberty",
"queryType": "NON_NEAR",
"queryTime": 37,
"numResults": 2,
"offset": 0,
"totalResults": 18,
"fuzzyLevel": 1
},
"results": [
{
"type": "POI",
"id": "US/POI/p0/9189660",
"score": 6.942,
"info": "search:ta:840369001174316-US",
"poi": {
"name": "Statue of Liberty",
"categorySet": [
{
"id": 7376003
}
],
"classifications": [
{
"code": "IMPORTANT_TOURIST_ATTRACTION",
"names": [
{
"nameLocale": "en-US",
"name": "monument"
},
{
"nameLocale": "en-US",
"name": "important tourist attraction"
}
]
}
]
},
"address": {
"municipalitySubdivision": "New York",
"municipality": "New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "New York, NY 10004",
"localName": "New York",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.68955,
"lon": -74.04483
},
"viewport": {
"topLeftPoint": {
"lat": 40.69045,
"lon": -74.04602
},
"btmRightPoint": {
"lat": 40.68865,
"lon": -74.04364
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.69001,
"lon": -74.04683
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/3264566",
"score": 6.942,
"info": "search:ta:840019000670588-US",
"poi": {
"name": "Statue of Liberty",
"phone": "+(1)-(205)-9700251",
"categorySet": [
{
"id": 7376003
}
],
"url": "www.1bsa.org",
"classifications": [
{
"code": "IMPORTANT_TOURIST_ATTRACTION",
"names": [
{
"nameLocale": "en-US",
"name": "important tourist attraction"
}
]
}
]
},
"address": {
"streetNumber": "516",
"streetName": "Liberty Pkwy",
"municipalitySubdivision": "Vestavia Hills",
"municipality": "Vestavia Hills, Birmingham",
"countrySecondarySubdivision": "Jefferson",
"countryTertiarySubdivision": "Leeds",
"countrySubdivisionCode": "AL",
"postalCode": "35242",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "516 Liberty Pkwy, Vestavia Hills, AL 35242",
"localName": "Vestavia Hills",
"countrySubdivisionName": "Alabama"
},
"position": {
"lat": 33.48234,
"lon": -86.70719
},
"viewport": {
"topLeftPoint": {
"lat": 33.48324,
"lon": -86.70827
},
"btmRightPoint": {
"lat": 33.48144,
"lon": -86.70611
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 33.48129,
"lon": -86.7065
}
}
]
}
]
}
},
{
"statusCode": 200,
"response": {
"summary": {
"query": "starbucks",
"queryType": "NON_NEAR",
"queryTime": 35,
"numResults": 10,
"offset": 0,
"totalResults": 17,
"fuzzyLevel": 1,
"geoBias": {
"lat": 47.639769,
"lon": -122.128362
}
},
"results": [
{
"type": "POI",
"id": "US/POI/p0/153678",
"score": 2.671,
"dist": 1206.8488178244172,
"info": "search:ta:840531000006554-US",
"poi": {
"name": "Starbucks",
"phone": "+(1)-(425)-8695816",
"brands": [
{
"name": "Starbucks"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.starbucks.com/site-selector",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "15000",
"streetName": "NE 24th St",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98052",
"extendedPostalCode": "980525522",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "15000 NE 24th St, Redmond, WA 98052",
"localName": "Redmond",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.63265,
"lon": -122.14052
},
"viewport": {
"topLeftPoint": {
"lat": 47.63355,
"lon": -122.14185
},
"btmRightPoint": {
"lat": 47.63175,
"lon": -122.13919
}
},
"entryPoints": [
{
"type": "minor",
"position": {
"lat": 47.63156,
"lon": -122.14056
}
},
{
"type": "minor",
"position": {
"lat": 47.63156,
"lon": -122.14058
}
},
{
"type": "main",
"position": {
"lat": 47.63156,
"lon": -122.14048
}
},
{
"type": "main",
"position": {
"lat": 47.6324,
"lon": -122.13938
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/152316",
"score": 2.67,
"dist": 2315.294397491255,
"info": "search:ta:840539000484552-US",
"poi": {
"name": "Starbucks",
"phone": "+(1)-(425)-6436471",
"brands": [
{
"name": "Starbucks"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.starbucks.com/store/15097",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "15600",
"streetName": "NE 8th St",
"municipalitySubdivision": "Crossroads, Bellevue",
"municipality": "Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98008",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "15600 NE 8th St, Bellevue, WA 98008",
"localName": "Bellevue",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.61896,
"lon": -122.12945
},
"viewport": {
"topLeftPoint": {
"lat": 47.61986,
"lon": -122.13078
},
"btmRightPoint": {
"lat": 47.61806,
"lon": -122.12812
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.619,
"lon": -122.12945
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/167545",
"score": 2.67,
"dist": 1979.2222952267998,
"info": "search:ta:840539001950429-US",
"poi": {
"name": "Starbucks",
"phone": "+(1)-(425)-7470690",
"brands": [
{
"name": "Starbucks"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.starbucks.com/site-selector",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "1350",
"streetName": "156th Ave NE",
"municipalitySubdivision": "Crossroads, Bellevue",
"municipality": "Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98007",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "1350 156th Ave NE, Bellevue, WA 98007",
"localName": "Bellevue",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.62212,
"lon": -122.13179
},
"viewport": {
"topLeftPoint": {
"lat": 47.62302,
"lon": -122.13312
},
"btmRightPoint": {
"lat": 47.62122,
"lon": -122.13046
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.62213,
"lon": -122.13236
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/168519",
"score": 2.67,
"dist": 2490.3337046455963,
"info": "search:ta:840539001015090-US",
"poi": {
"name": "Starbucks",
"phone": "+(1)-(425)-4556500",
"brands": [
{
"name": "Starbucks"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "https://www.starbucks.com/store-locator/store/15901",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "1645",
"streetName": "140th Ave NE",
"municipalitySubdivision": "Crossroads, Bellevue",
"municipality": "Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98005",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "1645 140th Ave NE, Bellevue, WA 98005",
"localName": "Bellevue",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.62626,
"lon": -122.15487
},
"viewport": {
"topLeftPoint": {
"lat": 47.62716,
"lon": -122.1562
},
"btmRightPoint": {
"lat": 47.62536,
"lon": -122.15354
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.62645,
"lon": -122.15446
}
},
{
"type": "minor",
"position": {
"lat": 47.62579,
"lon": -122.15377
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/152428",
"score": 2.668,
"dist": 3529.7080738812224,
"info": "search:ta:840539001033722-US",
"poi": {
"name": "Starbucks",
"phone": "+(1)-(425)-3789496",
"brands": [
{
"name": "Starbucks"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.starbucks.com/site-selector",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "180",
"streetName": "148th Ave SE",
"municipalitySubdivision": "West Lake Hills, Bellevue",
"municipality": "Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98007",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "180 148th Ave SE, Bellevue, WA 98007",
"localName": "Bellevue",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.60901,
"lon": -122.14
},
"viewport": {
"topLeftPoint": {
"lat": 47.60991,
"lon": -122.14133
},
"btmRightPoint": {
"lat": 47.60811,
"lon": -122.13867
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.60901,
"lon": -122.14008
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/167147",
"score": 2.668,
"dist": 3479.393294615887,
"info": "search:ta:840539000326896-US",
"poi": {
"name": "Starbucks",
"phone": "+(1)-(425)-8619198",
"brands": [
{
"name": "Starbucks"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.starbucks.com/site-selector",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "7425",
"streetName": "166th Ave NE",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98052",
"extendedPostalCode": "980526288",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "7425 166th Ave NE, Redmond, WA 98052",
"localName": "Redmond",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.67055,
"lon": -122.12001
},
"viewport": {
"topLeftPoint": {
"lat": 47.67145,
"lon": -122.12135
},
"btmRightPoint": {
"lat": 47.66965,
"lon": -122.11867
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.67069,
"lon": -122.11889
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/153695",
"score": 2.667,
"dist": 3622.441074618729,
"info": "search:ta:840531000006551-US",
"poi": {
"name": "Starbucks",
"phone": "+(1)-(425)-8822881",
"brands": [
{
"name": "Starbucks"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.starbucks.com/store/15022",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "7625",
"streetName": "170th Ave NE",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98052",
"extendedPostalCode": "980520910",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "7625 170th Ave NE, Redmond, WA 98052",
"localName": "Redmond",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.67086,
"lon": -122.11392
},
"viewport": {
"topLeftPoint": {
"lat": 47.67176,
"lon": -122.11526
},
"btmRightPoint": {
"lat": 47.66996,
"lon": -122.11258
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.67073,
"lon": -122.1135
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/167420",
"score": 2.667,
"dist": 3818.293513029088,
"info": "search:ta:840539000640782-US",
"poi": {
"name": "Starbucks",
"phone": "+(1)-(425)-8853323",
"brands": [
{
"name": "Starbucks"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.starbucks.com/site-selector",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "17246",
"streetName": "Redmond Way",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98052",
"extendedPostalCode": "980524403",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "17246 Redmond Way, Redmond, WA 98052",
"localName": "Redmond",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.67174,
"lon": -122.10976
},
"viewport": {
"topLeftPoint": {
"lat": 47.67264,
"lon": -122.1111
},
"btmRightPoint": {
"lat": 47.67084,
"lon": -122.10842
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.6706,
"lon": -122.11026
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/153686",
"score": 2.666,
"dist": 4009.922205147074,
"info": "search:ta:840531000006548-US",
"poi": {
"name": "Starbucks",
"phone": "+(1)-(425)-8859590",
"brands": [
{
"name": "Starbucks"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.starbucks.com/site-selector",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "15738",
"streetName": "Redmond Way Pad 3 Redmond Center",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98052",
"extendedPostalCode": "980523873",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "15738 Redmond Way Pad 3 Redmond Center, Redmond, WA 98052",
"localName": "Redmond",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.67583,
"lon": -122.12877
},
"viewport": {
"topLeftPoint": {
"lat": 47.67673,
"lon": -122.13011
},
"btmRightPoint": {
"lat": 47.67493,
"lon": -122.12743
}
},
"entryPoints": [
{
"type": "minor",
"position": {
"lat": 47.67456,
"lon": -122.12887
}
},
{
"type": "main",
"position": {
"lat": 47.67668,
"lon": -122.12829
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/168511",
"score": 2.666,
"dist": 3987.80992387863,
"info": "search:ta:840531000006669-US",
"poi": {
"name": "Starbucks",
"phone": "+(1)-(425)-8818265",
"brands": [
{
"name": "Starbucks"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.starbucks.com/site-selector",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "6617",
"streetName": "132Nd Ave Ne Bridle Trails Shopping Center",
"municipalitySubdivision": "Kirkland, Bridle Trails",
"municipality": "Kirkland",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivisionCode": "WA",
"postalCode": "98033",
"extendedPostalCode": "980338234",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "6617 132Nd Ave Ne Bridle Trails Shopping Center, Kirkland, WA 98033",
"localName": "Kirkland",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.66514,
"lon": -122.16599
},
"viewport": {
"topLeftPoint": {
"lat": 47.66604,
"lon": -122.16733
},
"btmRightPoint": {
"lat": 47.66424,
"lon": -122.16465
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.666,
"lon": -122.16669
}
},
{
"type": "minor",
"position": {
"lat": 47.66553,
"lon": -122.16405
}
}
]
}
]
}
}
],
"summary": {
"successfulRequests": 3,
"totalRequests": 3
}
}
Operation-Location: URL to download the results of the long-running batch request.
Tanımlar
Name | Description |
---|---|
Address |
Sonucun adresi |
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. |
Batch |
Bu tür, Batch hizmeti için istek gövdesini temsil eder. |
Batch |
Batch istek nesnesi |
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 kullanmak için başvuru kimlikleri. |
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. |
Json |
Yanıtın istenen biçimi. Yalnızca |
Lat |
'lon' & 'lat' kısa adları kullanılarak enlem ve boylam olarak temsil edilen konum. |
Match |
Ters adres arama işlemi için eşleşme türleri. |
Operating |
PoI için çalışma saatleri (İlgi Çekici Noktalar). |
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 |
Sorgunun sonucu. Sorgu başarıyla tamamlandıysa SearchAddressResult, aksi takdirde ErrorResponse. |
Search |
Arama Adres Toplu İş hizmeti çağrısından döndürülen bir öğe. |
Search |
Bu nesne, başarılı bir Arama Adresi Batch hizmet çağrısından döndürülür. |
Search |
Arama API yanıtı için sonuç nesnesi. |
Search |
Bunlardan biri:
|
Search |
Arama API yanıtı için özet nesnesi. |
Summary |
Toplu istek sonuçlarının özeti |
Address
Sonucun adresi
Name | Tür | Description |
---|---|---|
boundingBox |
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ı. |
AddressRanges
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.
Name | Tür | Description |
---|---|---|
from |
'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 |
'lon' & 'lat' kısa adları kullanılarak enlem ve boylam olarak temsil edilen konum. |
BatchRequest
Bu tür, Batch hizmeti için istek gövdesini temsil eder.
Name | Tür | Description |
---|---|---|
batchItems |
İşlenmek üzere sorguların listesi. |
BatchRequestItem
Batch istek nesnesi
Name | Tür | Description |
---|---|---|
query |
string |
Bu parametre, yapılandırılmamış bir coğrafi kodlama işlemi gerçekleştirmek için kullanılan bir sorgu dizesi içerir. Sorgu dizesi, işlenmek üzere arama API'sine ayrıntılı olarak geçirilir. |
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 |
'lon' & 'lat' kısa adları kullanılarak enlem ve boylam olarak temsil edilen konum. |
|
topLeftPoint |
'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 |
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ı |
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 |
Ad dizisi |
ClassificationName
Sınıflandırmanın adı
Name | Tür | Description |
---|---|---|
name |
string |
Name özelliği |
nameLocale |
string |
Ad Yerel Ayarı özelliği |
DataSources
İsteğe bağlı bölüm. Get Arama Polygon API'si ile kullanmak için başvuru kimlikleri.
Name | Tür | Description |
---|---|---|
geometry |
Sonucun geometrik şekli hakkında bilgi. Yalnızca == Coğrafya türünde mevcut. |
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 |
'lon' & 'lat' kısa adları kullanılarak enlem ve boylam olarak temsil edilen konum. |
|
type |
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 |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
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. |
JsonFormat
Yanıtın istenen biçimi. Yalnızca json
biçim desteklenir.
Name | Tür | Description |
---|---|---|
json |
string |
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 |
Longitude özelliği |
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 çalışma saatleri (İlgi Çekici Noktalar).
Name | Tür | Description |
---|---|---|
mode |
string |
İstekte kullanılan değer: none veya "nextSevenDays" |
timeRanges |
Sonraki 7 günün zaman aralıkları listesi |
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 |
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 |
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[] |
Brands dizisi. İade edilen POI markasının adı. |
categories |
string[] |
Kategoriler dizisi |
categorySet |
En özel POI kategorilerinin listesi |
|
classifications |
Sınıflandırma dizisi |
|
name |
string |
POI özelliğinin adı |
openingHours |
PoI için çalışma 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 |
Response
Sorgunun sonucu. Sorgu başarıyla tamamlandıysa SearchAddressResult, aksi takdirde ErrorResponse.
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
|
results |
Arama API sonuçlarının listesi. |
|
summary |
Arama API yanıtı için özet nesnesi |
SearchAddressBatchItem
Arama Adres Toplu İş hizmeti çağrısından döndürülen bir öğe.
Name | Tür | Description |
---|---|---|
response |
Sorgunun sonucu. Sorgu başarıyla tamamlandıysa SearchAddressResult, aksi takdirde ErrorResponse. |
|
statusCode |
integer |
HTTP isteği durum kodu. |
SearchAddressBatchProcessResult
Bu nesne, başarılı bir Arama Adresi Batch hizmet çağrısından döndürülür.
Name | Tür | Description |
---|---|---|
batchItems |
Toplu iş sonuçlarını içeren dizi. |
|
summary |
Toplu istek sonuçlarının özeti |
SearchAddressResultItem
Arama API yanıtı için sonuç nesnesi.
Name | Tür | Description |
---|---|---|
address |
Sonucun adresi |
|
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. |
|
dataSources |
İsteğe bağlı bölüm. Get Arama Polygon API'si ile kullanmak için başvuru geometri 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 |
Coğrafya varlık türü. Yalnızca entityType istendiğinde ve kullanılabilir olduğunda bulunur. |
|
entryPoints |
EntryPoint dizisi. Bunlar, konumdaki mevcut 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 |
Eşleşme türüyle ilgili bilgiler. Bunlardan biri:
|
|
poi |
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 |
'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ı belirtmek için bir sonuç kümesi içindeki değer. X değerinin y değerinin 2 katı olması durumunda x sonucunun y sonucunun iki katı kadar uygun 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 ifade edilir. |
type |
Bunlardan biri:
|
|
viewport |
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 |
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 belirsiz düzey. |
geoBias |
İç arama motorunun sonuçların derecelendirmesini geliştirmek için jeo-uzamsal sapma uyguladığının göstergesi. Bazı yöntemlerde, bu durum lat ve lon parametrelerinin uygun olduğu durumlarda ayarlanmasından 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 |
Sorguyu çözümlemek için harcanan süre (milisaniye cinsinden). |
queryType |
Döndürülen sorgu türü: YAKINDA veya NON_NEAR. |
|
totalResults |
integer |
Bulunan toplam Sonuç sayısı. |
Summary
Toplu istek sonuçlarının özeti
Name | Tür | Description |
---|---|---|
successfulRequests |
integer |
Toplu işlemdeki başarılı istek sayısı |
totalRequests |
integer |
Toplu işlemdeki toplam istek sayısı |