Search - Get Search POI Category
A használatával kategóriák szerint keresheti meg a kívánt pontokat.
Az Get Search POI Category
API egy HTTP-kérés GET
, amely lehetővé teszi a POI-eredmények lekérését az adott kategóriából. A POI-k egyszerre egy kategóriából való lekérdezéséhez hasznos. A végpont csak olyan POI-eredményeket ad vissza, amelyek a megadottak szerint vannak kategorizálva. A válasz olyan POI-adatokat tartalmaz, mint a cím, a koordináta helye és a besorolás.
GET https://atlas.microsoft.com/search/poi/category/{format}?api-version=1.0&query={query}
GET https://atlas.microsoft.com/search/poi/category/{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}&brandSet={brandSet}&connectorSet={connectorSet}&view={view}&openingHours=nextSevenDays
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
format
|
path | True |
Response |
A válasz kívánt formátuma. Az érték lehet json vagy xml. |
api-version
|
query | True |
string |
Azure Maps API verziószáma. |
query
|
query | True |
string |
A keresendő POI-kategóriának (pl. "AIRPORT", "RESTAURANT" ) megfelelően kell kódolnia az URL-címet. A támogatott fő kategóriák a Get Keresés POI Category Tree API meghívásával kérhetők. Az elérhető kategóriák listájáért lásd: Azure Maps támogatott kategóriák. Javasoljuk, hogy a támogatott kategóriák igényléséhez használja a POI Keresés Category Tree API-t. |
brand
|
query |
string[] |
A márkanevek vesszővel tagolt listája, amellyel az eredmény adott márkákra korlátozható. A cikk sorrendje nem számít. Ha több márkát ad meg, a rendszer csak azokat az eredményeket adja vissza, amelyek a megadott lista valamelyikéhez tartoznak (legalább). A nevükben ""-t tartalmazó márkákat idézőjelek közé kell tenni. Használati példák: brandSet=Foo brandSet=Foo,Bar brandSet="A,B,C vessző",Sáv |
|
btm
|
query |
string |
A határolókeret jobb alsó helyzete. Pl. 37.553,-122.453 |
|
category
|
query |
integer[] |
A kategóriakészletek azonosítóinak vesszővel tagolt listája, amellyel az eredmény adott érdeklődési pontok kategóriáira korlátozható. Az azonosító sorrendje nem számít. A kérésenként támogatott értékek maximális száma
|
|
connector
|
query |
Electric |
Az összekötőtípusok vesszővel tagolt listája, amellyel az eredményt az elektromos járműállomásra korlátozhatja, amely bizonyos összekötőtípusokat támogat. A cikk sorrendje nem számít. Ha több összekötőtípus van megadva, a rendszer csak azokat az eredményeket adja vissza, amelyek a megadott lista egyikéhez tartoznak (legalább). Az elérhető összekötőtípusok a következők:
Használati példák: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
|
country
|
query |
string[] |
Ország-/régiókódok vesszővel tagolt sztringje, például FR,ES. Ez korlátozza a keresést a megadott országokra/régiókra |
|
extended
|
query |
Search |
Indexek, amelyekhez kiterjesztett irányítószámokat kell felvenni az eredményekbe. Az elérhető indexek a következők: Addr = Címtartományok Geo = Földrajzi helyek PAD = Pontcímek POI = Érdekes pontok Str = Utcák XStr = Keresztutcák (kereszteződések) Az értéknek az indextípusok vesszővel tagolt listájának kell lennie (bármilyen sorrendben), indexek nélkül pedig a Nincs értéknek. Alapértelmezés szerint a kiterjesztett irányítószámokat a Geo kivételével minden index tartalmazza. A földrajzi helyekre vonatkozó kiterjesztett irányítószám-listák meglehetősen hosszúak lehetnek, ezért szükség esetén explicit módon kell őket kérni. Használati példák: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None A kiterjesztett irányítószám egy cím extendedPostalCode tulajdonságaként lesz visszaadva. A rendelkezésre állás régiófüggő. |
|
language
|
query |
string |
Az a nyelv, amelyben a keresési eredményeket vissza kell adni. A támogatott IETF nyelvcímkék egyikének kell lennie, a kis- és nagybetűk nem különböztethetők meg. Ha a megadott nyelvű adatok nem érhetők el egy adott mezőhöz, a rendszer az alapértelmezett nyelvet használja. Részletekért tekintse meg a támogatott nyelveket ismertető cikket. |
|
lat
|
query |
number double |
Szélesség, ahol az eredményeket elfogultnak kell lennie. Pl. 37.337 |
|
limit
|
query |
integer |
A visszaadott válaszok maximális száma. Alapértelmezett: 10, minimum: 1 és maximum: 100 |
|
lon
|
query |
number double |
Hosszúság, ahol az eredményeket elfogultnak kell lennie. Pl. -121,89 |
|
ofs
|
query |
integer |
A visszaadott eredmények eltolása a teljes eredményhalmazon belül. Alapértelmezett: 0 |
|
opening
|
query |
Operating |
A POI (érdeklődési pontok) nyitvatartási ideje. A rendelkezésre álló munkaórák elérhetősége a rendelkezésre álló adatoktól függően változik. Ha nem érkezik meg, akkor a rendszer nem ad vissza nyitvatartási adatokat. Támogatott érték: nextSevenDays |
|
radius
|
query |
integer |
Az eredmények meghatározott területre való korlátozásának mérőben megadott sugara |
|
top
|
query |
string |
A határolókeret bal felső helyzete. Pl. 37.553,-122.453 |
|
typeahead
|
query |
boolean |
Logikai. Ha a typeahead jelző be van állítva, a lekérdezés részleges bemenetként lesz értelmezve, és a keresés prediktív módba lép |
|
view
|
query |
Localized |
A View paraméter (más néven "felhasználói régió" paraméter) lehetővé teszi egy adott ország/régió megfelelő térképeinek megjelenítését a geopolitikailag vitatott régiókhoz. A különböző országok/régiók eltérő nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen annak az országnak/régiónak, amelyet az alkalmazás használni fog. Alapértelmezés szerint a Nézet paraméter "Egyesített" értékre van állítva, még akkor is, ha még nem definiálta a kérésben. Az Ön felelőssége meghatározni a felhasználók helyét, majd helyesen beállítani a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást, amely a kérelem IP-címe alapján adja vissza a térképadatokat. A View paramétert Azure Maps a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a térképekkel kapcsolatos jogszabályokat is, azon ország/régió vonatkozásában, ahol a térképeket, képeket és egyéb adatokat, valamint a Azure Maps keresztüli hozzáférésre jogosult harmadik féltől származó tartalmakat elérhetővé teszik. Példa: view=IN. A részletekért tekintse meg a Támogatott nézetek című témakört , és tekintse meg az elérhető nézeteket. |
Kérelem fejléce
Name | Kötelező | Típus | Description |
---|---|---|---|
x-ms-client-id |
string |
Meghatározza, hogy melyik fiók legyen használatban a Microsoft Entra ID biztonsági modellel együtt. A Azure Maps fiók egyedi azonosítóját jelöli, és lekérhető a Azure Maps felügyeleti sík fiók API-jából. A biztonsági Microsoft Entra ID Azure Maps az alábbi cikkekben talál útmutatást. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
Search |
OK |
Other Status Codes |
Error |
Váratlan hiba történt. |
Biztonság
AADToken
Ezek az OAuth 2.0-folyamatok Microsoft Entra. Az Azure-beli szerepköralapú hozzáférés-vezérléssel párosítva szabályozható a Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlése egy vagy több Azure Maps erőforrásfiókhoz vagy alerőforráshoz való hozzáférés kijelölésére szolgál. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörrel vagy egy vagy több rest API-Azure Maps ra vonatkozó engedélyből álló egyéni szerepkörrel.
A forgatókönyvek implementálásához javasoljuk, hogy tekintse meg a hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást nyújt az alkalmazás(ok) adott API-k és hatókörök hozzáférés-vezérlésére képes objektumokon keresztüli modellezésére.
Megjegyzés
- Ez a biztonsági definíció megköveteli a fejléc használatát annak
x-ms-client-id
jelzéséhez, hogy melyik Azure Maps erőforráshoz kér hozzáférést az alkalmazás. Ez a Maps management API-ból szerezhető be. - A
Authorization URL
az Azure nyilvános felhőpéldányára vonatkozik. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra ID konfigurációkkal rendelkeznek. - Az Azure szerepköralapú hozzáférés-vezérlése az Azure felügyeleti síkjáról van konfigurálva Azure Portal, PowerShell, CLI, Azure SDK-k vagy REST API-k használatával.
- A Azure Maps Web SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esetben.
- A Microsoft Identitásplatform kapcsolatos további információkért lásd: Microsoft Identitásplatform áttekintése.
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
Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps fiókot hoz létre a Azure Portal vagy PowerShell, CLI, Azure SDK vagy REST API használatával.
Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.
Nyilvánosan közzétett alkalmazások esetén javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítését használja Azure Maps REST API-k eléréséhez, hogy a kulcs biztonságosan tárolható legyen.
Type:
apiKey
In:
query
SAS Token
Ez egy közös hozzáférésű jogosultságkód-jogkivonat a listázási SAS műveletből jön létre az Azure Maps erőforráson keresztül az Azure felügyeleti síkján keresztül Azure Portal, PowerShell, CLI, Azure SDK-k vagy REST API-k használatával.
Ezzel a jogkivonattal minden alkalmazás jogosult hozzáférni az Azure szerepköralapú hozzáférés-vezérlőihez, valamint az adott jogkivonathoz használt lejárati időhöz, sebességhez és régióhoz. Más szóval az SAS-jogkivonattal az alkalmazások a megosztott kulcsnál biztonságosabb módon szabályozhatják a hozzáférést.
Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfiguráljon egy adott listát az engedélyezett forrásokról a térképfiók-erőforráson a leképezési visszaélések korlátozásához és az SAS-jogkivonat rendszeres megújításához.
Type:
apiKey
In:
header
Példák
Search for ATM's within 2 miles of Times Square NY and return the top 3 results
Sample Request
GET https://atlas.microsoft.com/search/poi/category/json?api-version=1.0&query=atm&limit=3&lat=40.758953&lon=-73.985263&radius=3200&openingHours=nextSevenDays
Sample Response
{
"summary": {
"query": "atm",
"queryType": "NON_NEAR",
"queryTime": 28,
"numResults": 3,
"offset": 0,
"totalResults": 3696,
"fuzzyLevel": 1,
"geoBias": {
"lat": 40.758953,
"lon": -73.985263
}
},
"results": [
{
"type": "POI",
"id": "US/POI/p0/7014613",
"score": 2.575,
"dist": 10.743802093311858,
"info": "search:ta:840369001846523-US",
"poi": {
"name": "FISERV MASTERMONEY",
"categorySet": [
{
"id": 7397
}
],
"classifications": [
{
"code": "CASH_DISPENSER",
"names": [
{
"nameLocale": "en-US",
"name": "cash dispenser"
}
]
}
]
},
"address": {
"streetNumber": "1560",
"streetName": "Broadway",
"municipalitySubdivision": "Times Square, New York, Midtown",
"municipality": "New York, Manhattan",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10036",
"extendedPostalCode": "100361517",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "1560 Broadway, New York, NY 10036",
"localName": "New York",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.75901,
"lon": -73.98516
},
"viewport": {
"topLeftPoint": {
"lat": 40.75991,
"lon": -73.98635
},
"btmRightPoint": {
"lat": 40.75811,
"lon": -73.98397
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.75902,
"lon": -73.98522
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/6830011",
"score": 2.575,
"dist": 58.68107354501256,
"info": "search:ta:840369011803697-US",
"poi": {
"name": "METABANK",
"categorySet": [
{
"id": 7397
}
],
"classifications": [
{
"code": "CASH_DISPENSER",
"names": [
{
"nameLocale": "en-US",
"name": "cash dispenser"
}
]
}
]
},
"address": {
"streetNumber": "1567",
"streetName": "Broadway",
"municipalitySubdivision": "Times Square, New York, Midtown",
"municipality": "New York, Manhattan",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10036",
"extendedPostalCode": "100361517",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "1567 Broadway, New York, NY 10036",
"localName": "New York",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.75937,
"lon": -73.98569
},
"viewport": {
"topLeftPoint": {
"lat": 40.76027,
"lon": -73.98688
},
"btmRightPoint": {
"lat": 40.75847,
"lon": -73.9845
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.75924,
"lon": -73.98513
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/6830013",
"score": 2.575,
"dist": 55.009653221373966,
"info": "search:ta:840369010525390-US",
"poi": {
"name": "ATM",
"categorySet": [
{
"id": 7397
}
],
"classifications": [
{
"code": "CASH_DISPENSER",
"names": [
{
"nameLocale": "en-US",
"name": "cash dispenser"
}
]
}
]
},
"address": {
"streetNumber": "1552",
"streetName": "Broadway",
"municipalitySubdivision": "Times Square, New York, Midtown",
"municipality": "New York, Manhattan",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10036",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "1552 Broadway, New York, NY 10036",
"localName": "New York",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.75873,
"lon": -73.98468
},
"viewport": {
"topLeftPoint": {
"lat": 40.75963,
"lon": -73.98587
},
"btmRightPoint": {
"lat": 40.75783,
"lon": -73.98349
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.7588,
"lon": -73.98492
}
}
]
}
]
}
Definíciók
Name | Description |
---|---|
Address |
Az eredmény címe |
Address |
Az utca mindkét oldalán található címtartományt ismerteti a keresési eredményhez. A címtartomány kezdő és záró helyének koordinátáit tartalmazza. |
Bounding |
A nézetport bal felső és jobb alsó koordinátái által képviselt eredményt lefedő nézetport. |
Bounding |
A hely határolókerete. |
Brand |
A POI-hoz társított márka |
Classification |
A visszaadott POI besorolása |
Classification |
A besorolás neve |
Data |
Nem kötelező szakasz. Referenciaazonosítók a Get Keresés Polygon API-hoz. |
Electric |
Az összekötőtípusok vesszővel tagolt listája, amellyel az eredményt az elektromos járműállomásra lehetne korlátozni, amely támogatja az adott összekötőtípusokat. A cikk sorrendje nem számít. Ha több összekötőtípus van megadva, a rendszer csak a megadott lista egyikéhez (legalább) tartozó eredményeket adja vissza. Az elérhető összekötőtípusok a következők:
Használati példák: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
Entity |
A határolókeret entitástípus-forrása. Fordított geokódolás esetén ez mindig egyenlő a pozícióval. |
Entry |
A visszaadott POI belépési pontja. |
Entry |
A belépési pont típusa. Az érték lehet fő vagy alérték. |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Geographic |
Földrajzi entitás típusa. Csak akkor jelenik meg, ha az entityType kérése megtörtént, és elérhető. |
Geometry |
Információ az eredmény geometriai alakjáról. Csak akkor jelenik meg, ha a típus == Földrajzi hely. |
Lat |
Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid névvel, & "lon". |
Localized |
A View paraméter (más néven "felhasználói régió" paraméter) lehetővé teszi egy adott ország/régió megfelelő térképeinek megjelenítését a geopolitikailag vitatott régiókhoz. A különböző országok/régiók eltérő nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen annak az országnak/régiónak, amelyet az alkalmazás használni fog. Alapértelmezés szerint a Nézet paraméter "Egyesített" értékre van állítva, még akkor is, ha még nem definiálta a kérésben. Az Ön felelőssége meghatározni a felhasználók helyét, majd helyesen beállítani a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást, amely a kérelem IP-címe alapján adja vissza a térképadatokat. A View paramétert Azure Maps a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a térképekkel kapcsolatos jogszabályokat is, azon ország/régió vonatkozásában, ahol a térképeket, képeket és egyéb adatokat, valamint a Azure Maps keresztüli hozzáférésre jogosult harmadik féltől származó tartalmakat elérhetővé teszik. Példa: view=IN. A részletekért tekintse meg a Támogatott nézetek című témakört , és tekintse meg az elérhető nézeteket. |
Match |
A fordított címkeresési művelet egyezésének típusai. |
Operating |
A POI nyitvatartási ideje (érdekes pontok). |
Operating |
PoI (érdeklődési pontok) nyitvatartási ideje. A rendelkezésre álló munkaórák elérhetősége a rendelkezésre álló adatoktól függően változik. Ha nem adták át, akkor a rendszer nem ad vissza nyitvatartási adatokat. Támogatott érték: nextSevenDays |
Operating |
Dátumot és időpontot jelöl |
Operating |
Nyitott időtartomány egy napra |
Point |
A visszaadott POI részletei, beleértve az olyan információkat, mint a név, a telefon, az URL-cím és a besorolások. |
Point |
POI-kategória |
Query |
A visszaadott lekérdezés típusa: KÖZELI vagy NON_NEAR. |
Response |
A válasz kívánt formátuma. Az érték lehet json vagy xml. |
Search |
Ezt az objektumot egy sikeres Keresés hívás adja vissza. |
Search |
Eredményobjektum egy Keresés API-válaszhoz. |
Search |
Az alábbiak egyike:
|
Search |
Indexek, amelyekhez kiterjesztett irányítószámokat kell felvenni az eredményekbe. Az elérhető indexek a következők: Addr = Címtartományok Geo = Földrajzi helyek PAD = Pontcímek POI = Érdekes pontok Str = Utcák XStr = Keresztutcák (metszetek) Az értéknek az indextípusok vesszővel tagolt listájának kell lennie (bármilyen sorrendben), indexek nélkül pedig Nincs . Alapértelmezés szerint a kiterjesztett irányítószámokat a Geo kivételével minden index tartalmazza. A földrajzi helyekre vonatkozó kiterjesztett irányítószám-listák meglehetősen hosszúak lehetnek, ezért szükség esetén explicit módon kell kérni őket. Használati példák: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None A kiterjesztett irányítószám egy cím extendedPostalCode tulajdonságaként lesz visszaadva. A rendelkezésre állás régiófüggő. |
Search |
Egy Keresés API-válasz összefoglaló objektuma. |
Address
Az eredmény címe
Name | Típus | Description |
---|---|---|
boundingBox |
Bounding |
A hely határolókerete. |
buildingNumber |
string |
Az épület száma az utcán. ELAVULT, használja helyette a streetNumber parancsot. |
country |
string |
ország/régió neve |
countryCode |
string |
Ország (Megjegyzés: Ez egy kétbetűs kód, nem ország/régió neve.) |
countryCodeISO3 |
string |
ISO alpha-3 országkód |
countrySecondarySubdivision |
string |
Megye |
countrySubdivision |
string |
Állam vagy tartomány |
countrySubdivisionCode |
string |
|
countrySubdivisionName |
string |
Az ország-/régiószintű felügyeleti hierarchia első szintjének teljes neve. Ez a mező csak abban az esetben jelenik meg, ha a countrySubdivision rövidített formában jelenik meg. Csak az USA, Kanada és az Egyesült Királyság esetében támogatott. |
countryTertiarySubdivision |
string |
Névvel ellátott terület |
crossStreet |
string |
A keresztezett utca neve. |
extendedPostalCode |
string |
Kiterjesztett irányítószám (a rendelkezésre állás a régiótól függ). |
freeformAddress |
string |
Az eredmény származási országának/régiójának formázási szabályai szerint formázott címsor, ország/régió esetén a teljes ország/régió neve. |
localName |
string |
Olyan címösszetevő, amely egy olyan földrajzi terület vagy hely nevét jelöli, amely több címezhető objektumot csoportosít címzés céljából, felügyeleti egység nélkül. Ez a mező a tulajdonság létrehozásához |
municipality |
string |
Város / Város |
municipalitySubdivision |
string |
Al/Szuperváros |
neighbourhood |
string |
A szomszédság egy földrajzilag honosított terület egy városban vagy városban, amely megkülönböztető jellemzőkkel és társadalmi interakciókkal rendelkezik a lakosok között. |
postalCode |
string |
Irányítószám / Irányítószám |
routeNumbers |
string[] |
Az utca egyértelmű azonosítására használt kódok |
street |
string |
Az utcanév. ELAVULT, használja helyette a streetName nevet. |
streetName |
string |
Az utcanév. |
streetNameAndNumber |
string |
Az utcanév és a szám. |
streetNumber |
string |
Az épület száma az utcán. |
AddressRanges
Az utca mindkét oldalán található címtartományt ismerteti a keresési eredményhez. A címtartomány kezdő és záró helyének koordinátáit tartalmazza.
Name | Típus | Description |
---|---|---|
from |
Lat |
Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid nevek használatával & "lon". |
rangeLeft |
string |
Címtartomány az utca bal oldalán. |
rangeRight |
string |
Címtartomány az utca jobb oldalán. |
to |
Lat |
Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid nevek használatával & "lon". |
BoundingBox
A nézetport bal felső és jobb alsó koordinátái által képviselt eredményt lefedő nézetport.
Name | Típus | Description |
---|---|---|
btmRightPoint |
Lat |
Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid nevek használatával & "lon". |
topLeftPoint |
Lat |
Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid nevek használatával & "lon". |
BoundingBoxCompassNotation
A hely határolókerete.
Name | Típus | Description |
---|---|---|
entity |
A határolókeret entitástípus-forrása. Fordított geokódolás esetén ez mindig egyenlő a pozícióval. |
|
northEast |
string |
Észak-keleti szélesség, a határolókeret hosszúsági koordinátája vesszővel elválasztott úszókként |
southWest |
string |
Dél-nyugati szélesség, a határolókeret hosszúsági koordinátája vesszővel elválasztott úszóként |
Brand
A POI-hoz társított márka
Name | Típus | Description |
---|---|---|
name |
string |
A márka neve |
Classification
A visszaadott POI besorolása
Name | Típus | Description |
---|---|---|
code |
string |
Code tulajdonság |
names |
Classification |
Névtömb |
ClassificationName
A besorolás neve
Name | Típus | Description |
---|---|---|
name |
string |
Név tulajdonság |
nameLocale |
string |
Name Locale tulajdonság |
DataSources
Nem kötelező szakasz. Referenciaazonosítók a Get Keresés Polygon API-hoz.
Name | Típus | Description |
---|---|---|
geometry |
Információ az eredmény geometriai alakjáról. Csak akkor jelenik meg, ha a típus == Földrajzi hely. |
ElectricVehicleConnector
Az összekötőtípusok vesszővel tagolt listája, amellyel az eredményt az elektromos járműállomásra lehetne korlátozni, amely támogatja az adott összekötőtípusokat. A cikk sorrendje nem számít. Ha több összekötőtípus van megadva, a rendszer csak a megadott lista egyikéhez (legalább) tartozó eredményeket adja vissza.
Az elérhető összekötőtípusok a következők:
StandardHouseholdCountrySpecific
- Ezek a standard háztartási összekötők egy adott régióban. Ezek mind AC egyfázisú és a standard feszültség és a standard amperage. Lásd még: Plug & socket types – World Standards.IEC62196Type1
– Írja be az IEC 62196-2 szabványban meghatározott 1-es összekötőt. Yazaki néven is ismert az eredeti gyártó vagy SAE J1772 után a szabvány, hogy először közzétette azt. Többnyire 120V egyfázisú vagy akár 240V egyfázisú infrastruktúrával kombinálva használják.IEC62196Type1CCS
– Írja be az IEC 62196-3 szabványban meghatározott 1-alapú kombinált összekötőt. Az összekötő az IEC 62196-2 szabványban meghatározott 1. típusú összekötőn alapul, két további egyenáramú (DC) érintkezővel, amelyek lehetővé teszik a dc gyors töltését.IEC62196Type2CableAttached
– Írja be a 2. összekötőt az IEC 62196-2 szabványban meghatározottak szerint. A töltési ponthoz csatlakozó kábelként és dugóként van megadva.IEC62196Type2Outlet
– Írja be a 2. összekötőt az IEC 62196-2 szabványban meghatározottak szerint. A töltőponthoz csatlakozó aljzatként van megadva.IEC62196Type2CCS
– Írja be az IEC 62196-3 szabványban meghatározott 2-alapú kombinált összekötőt. Az összekötő az IEC 62196-2 szabványban meghatározott 2. típusú összekötőn alapul, két további egyenáramú (DC) érintkezővel, amelyek lehetővé teszik a dc gyors töltését.IEC62196Type3
– Írja be a 3-as összekötőt az IEC 62196-2 szabványban meghatározott módon. Más néven Scame után az eredeti gyártó. Többnyire legfeljebb 240V egyfázisú vagy akár 420V háromfázisú infrastruktúrával kombinálva használják.Chademo
- A CHAdeMO-összekötőt a Tokyo Electric Power Company és az ipari partnerek által létrehozott társulásról nevezték el. Emiatt a TEPCO összekötőjeként is ismert. Támogatja a gyors DC-töltést.IEC60309AC1PhaseBlue
– Az Industrial Blue-összekötő az IEC 60309 szabványban meghatározott összekötő. Ezt néha a standard, a szín és az a tény, hogy egyfázisú összekötőnek nevezik. Az összekötő általában a "P+N+E, 6h" konfigurációval rendelkezik.IEC60309DCWhite
– Az Industrial White-összekötő az IEC 60309 szabványban meghatározott DC-összekötő.Tesla
- A Tesla-összekötő a régióspecifikus Tesla Supercharger-összekötő. Azaz vagy a Tesla saját tulajdonú összekötőjét jelenti, amelyet néha Tesla Portnak is neveznek, többnyire Észak-Amerika vagy a módosított 2- es típusra (DC a 2-es típuson keresztül) Európában.
Használati példák:
connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached
Name | Típus | Description |
---|---|---|
Chademo |
string |
A CHAdeMO-összekötőt a Tokyo Electric Power Company és az ipari partnerek által létrehozott társulásról nevezték el. Emiatt a TEPCO összekötőjeként is ismert. Támogatja a gyors DC-töltést. |
IEC60309AC1PhaseBlue |
string |
Az Industrial Blue-összekötő az IEC 60309 szabványban meghatározott összekötő. Ezt néha a standard, a szín és az a tény, hogy egyfázisú összekötőnek nevezik. Az összekötő általában a "P+N+E, 6h" konfigurációval rendelkezik. |
IEC60309DCWhite |
string |
Az Industrial White-összekötő az IEC 60309 szabványban meghatározott DC-összekötő. |
IEC62196Type1 |
string |
Írja be az IEC 62196-2 szabványban meghatározott 1-es összekötőt. Yazaki néven is ismert az eredeti gyártó vagy SAE J1772 után a szabvány, hogy először közzétette azt. Többnyire 120V egyfázisú vagy akár 240V egyfázisú infrastruktúrával kombinálva használják. |
IEC62196Type1CCS |
string |
Írja be az IEC 62196-3 szabványban meghatározott 1-alapú kombinált összekötőt. Az összekötő az IEC 62196-2 szabványban meghatározott 1. típusú összekötőn alapul, két további egyenáramú (DC) érintkezővel, amelyek lehetővé teszik a dc gyors töltését. |
IEC62196Type2CCS |
string |
Írja be az IEC 62196-3 szabványban meghatározott 2-alapú kombinált összekötőt. Az összekötő az IEC 62196-2 szabványban meghatározott 2. típusú összekötőn alapul, két további egyenáramú (DC) érintkezővel, amelyek lehetővé teszik a dc gyors töltését. |
IEC62196Type2CableAttached |
string |
Írja be a 2. összekötőt az IEC 62196-2 szabványban meghatározottak szerint. A töltési ponthoz csatlakozó kábelként és dugóként van megadva |
IEC62196Type2Outlet |
string |
Írja be a 2. összekötőt az IEC 62196-2 szabványban meghatározottak szerint. A töltőponthoz csatlakozó aljzatként van megadva. |
IEC62196Type3 |
string |
Írja be az IEC 62196-2 szabványban meghatározott 3-as összekötőt. Más néven Scame után az eredeti gyártó. Többnyire legfeljebb 240V egyfázisú vagy akár 420V háromfázisú infrastruktúrával kombinálva használják. |
StandardHouseholdCountrySpecific |
string |
Ezek egy adott régió standard háztartási összekötői. Ezek mind AC egyfázisú és a standard feszültség és a standard amperage. Lásd még: Plug & socket types – World Standards |
Tesla |
string |
A Tesla-összekötő a régióspecifikus Tesla Supercharger-összekötő. Azaz vagy a Tesla saját tulajdonú összekötőjét jelenti, amelyet néha Tesla Portnak is neveznek, többnyire Észak-Amerika vagy a módosított 2- es típusra (DC a 2-es típuson keresztül) Európában. |
Entity
A határolókeret entitástípus-forrása. Fordított geokódolás esetén ez mindig egyenlő a pozícióval.
Name | Típus | Description |
---|---|---|
position |
string |
Pozíció entitás |
EntryPoint
A visszaadott POI belépési pontja.
Name | Típus | Description |
---|---|---|
position |
Lat |
Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid nevek használatával & "lon". |
type |
Entry |
A belépési pont típusa. Az érték lehet fő vagy alérték. |
EntryPointType
A belépési pont típusa. Az érték lehet fő vagy alérték.
Name | Típus | Description |
---|---|---|
main |
string |
|
minor |
string |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
Error |
A hiba további információi. |
code |
string |
A hibakód. |
details |
Error |
A hiba részletei. |
message |
string |
A hibaüzenet. |
target |
string |
A hiba célja. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
Error |
A hibaobjektum. |
GeographicEntityType
Földrajzi entitás típusa. Csak akkor jelenik meg, ha az entityType kérése megtörtént, és elérhető.
Name | Típus | Description |
---|---|---|
Country |
string |
ország/régió neve |
CountrySecondarySubdivision |
string |
Megye |
CountrySubdivision |
string |
Állam vagy tartomány |
CountryTertiarySubdivision |
string |
Elnevezett terület |
Municipality |
string |
Város /város |
MunicipalitySubdivision |
string |
Al- és Szuperváros |
Neighbourhood |
string |
Szomszédságában |
PostalCodeArea |
string |
Irányítószám / Irányítószám |
Geometry
Információ az eredmény geometriai alakjáról. Csak akkor jelenik meg, ha a típus == Földrajzi hely.
Name | Típus | Description |
---|---|---|
id |
string |
Adja át ezt geometriaazonosítóként a Get Keresés Polygon API-nak az eredmény geometriai adatainak lekéréséhez. |
LatLongPairAbbreviated
Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid névvel, & "lon".
Name | Típus | Description |
---|---|---|
lat |
number |
Latitude tulajdonság |
lon |
number |
Hosszúság tulajdonság |
LocalizedMapView
A View paraméter (más néven "felhasználói régió" paraméter) lehetővé teszi egy adott ország/régió megfelelő térképeinek megjelenítését a geopolitikailag vitatott régiókhoz. A különböző országok/régiók eltérő nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen annak az országnak/régiónak, amelyet az alkalmazás használni fog. Alapértelmezés szerint a Nézet paraméter "Egyesített" értékre van állítva, még akkor is, ha még nem definiálta a kérésben. Az Ön felelőssége meghatározni a felhasználók helyét, majd helyesen beállítani a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást, amely a kérelem IP-címe alapján adja vissza a térképadatokat. A View paramétert Azure Maps a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a térképekkel kapcsolatos jogszabályokat is, azon ország/régió vonatkozásában, ahol a térképeket, képeket és egyéb adatokat, valamint a Azure Maps keresztüli hozzáférésre jogosult harmadik féltől származó tartalmakat elérhetővé teszik. Példa: view=IN.
A részletekért tekintse meg a Támogatott nézetek című témakört , és tekintse meg az elérhető nézeteket.
Name | Típus | Description |
---|---|---|
AE |
string |
Egyesült Arab Emírségek (arab nézet) |
AR |
string |
Argentína (argentin nézet) |
Auto |
string |
Adja vissza a leképezési adatokat a kérelem IP-címe alapján. |
BH |
string |
Bahrein (arab nézet) |
IN |
string |
India (indiai nézet) |
IQ |
string |
Irak (arab nézet) |
JO |
string |
Jordánia (arab nézet) |
KW |
string |
Kuvait (arab nézet) |
LB |
string |
Libanon (arab nézet) |
MA |
string |
Marokkó (marokkói nézet) |
OM |
string |
Omán (arab nézet) |
PK |
string |
Pakisztán (pakisztáni nézet) |
PS |
string |
Palesztin Hatóság (arab nézet) |
QA |
string |
Katar (arab nézet) |
SA |
string |
Szaúd-Arábia (arab nézet) |
SY |
string |
Szíria (arab nézet) |
Unified |
string |
Egyesített nézet (egyebek) |
YE |
string |
Jemen (arab nézet) |
MatchType
A fordított címkeresési művelet egyezésének típusai.
Name | Típus | Description |
---|---|---|
AddressPoint |
string |
|
HouseNumberRange |
string |
|
Street |
string |
OperatingHours
A POI nyitvatartási ideje (érdekes pontok).
Name | Típus | Description |
---|---|---|
mode |
string |
A kérelemben használt érték: nincs vagy "nextSevenDays" |
timeRanges |
Operating |
A következő 7 nap időtartományainak listája |
OperatingHoursRange
PoI (érdeklődési pontok) nyitvatartási ideje. A rendelkezésre álló munkaórák elérhetősége a rendelkezésre álló adatoktól függően változik. Ha nem adták át, akkor a rendszer nem ad vissza nyitvatartási adatokat. Támogatott érték: nextSevenDays
Name | Típus | Description |
---|---|---|
nextSevenDays |
string |
A következő hét működési idejét jeleníti meg a poI helyi idejének aktuális napjával kezdődően. |
OperatingHoursTime
Dátumot és időpontot jelöl
Name | Típus | Description |
---|---|---|
date |
string |
Az aktuális naptárdátumot jelöli a POI időzónájában, például "2019-02-07". |
hour |
integer |
Az órák 24 órás formátumban vannak a POI helyi idejében; lehetséges értékek: 0 – 23. |
minute |
integer |
A percek a poI helyi idejében vannak; lehetséges értékek: 0 – 59. |
OperatingHoursTimeRange
Nyitott időtartomány egy napra
Name | Típus | Description |
---|---|---|
endTime |
Operating |
A következő 7 napos tartomány azon pontja, amikor egy adott POI bezárul, vagy a tartomány kezdete, ha a tartomány előtt bezárták. |
startTime |
Operating |
A következő 7 napos tartomány azon pontja, amikor egy adott POI meg van nyitva, vagy a tartomány kezdete, ha azt a tartomány előtt nyitották meg. |
PointOfInterest
A visszaadott POI részletei, beleértve az olyan információkat, mint a név, a telefon, az URL-cím és a besorolások.
Name | Típus | Description |
---|---|---|
brands |
Brand[] |
Márkák tömb. A visszaadott POI márkaneve. |
categories |
string[] |
Kategóriák tömb |
categorySet |
Point |
A legspecifikusabb POI-kategóriák listája |
classifications |
Besorolási tömb |
|
name |
string |
A POI tulajdonság neve |
openingHours |
Operating |
A POI nyitvatartási ideje (érdekes pontok). |
phone |
string |
Telefonszám tulajdonság |
url |
string |
Webhely URL-címe tulajdonság |
PointOfInterestCategorySet
POI-kategória
Name | Típus | Description |
---|---|---|
id |
integer |
Kategóriaazonosító |
QueryType
A visszaadott lekérdezés típusa: KÖZELI vagy NON_NEAR.
Name | Típus | Description |
---|---|---|
NEARBY |
string |
Keresés egy meghatározott sugarú szélesség és hosszúság körül hajtották végre |
NON_NEAR |
string |
Keresés globálisan, egy bizonyos szélességre és hosszúságra való torzítás nélkül, meghatározott sugár nélkül hajtották végre |
ResponseFormat
A válasz kívánt formátuma. Az érték lehet json vagy xml.
Name | Típus | Description |
---|---|---|
json |
string |
|
xml |
string |
SearchAddressResult
Ezt az objektumot egy sikeres Keresés hívás adja vissza.
Name | Típus | Description |
---|---|---|
results |
Search |
A Keresés API-eredmények listája. |
summary |
Search |
Keresés API-válasz összefoglaló objektuma |
SearchAddressResultItem
Eredményobjektum egy Keresés API-válaszhoz.
Name | Típus | Description |
---|---|---|
address |
Az eredmény címe |
|
addressRanges |
Address |
Az utca mindkét oldalán található címtartományt ismerteti a keresési eredményekhez. A címtartomány kezdő és záró helyének koordinátáit is tartalmazza. |
dataSources |
Data |
Nem kötelező szakasz. Referenciageometria-azonosító a Get Keresés Polygon API-val való használathoz. |
detourTime |
integer |
Kitérő idő másodpercben. Csak a Keresés Route API-nak indított hívások esetén adva vissza. |
dist |
number |
Egyenes vonal távolsága az eredmény és a földrajzi hely között méterben. |
entityType |
Geographic |
Földrajzi entitás típusa. Csak akkor jelenik meg, ha az entityType kérése megtörtént, és elérhető. |
entryPoints |
Entry |
EntryPoint-tömb. Ezek a helyszínen elérhető bejáratok típusait írják le. A típus lehet "fő" a főbejáratok, mint például a bejárati ajtó, vagy egy előszoba, és a "minor", az oldalsó és hátsó ajtók. |
id |
string |
Id tulajdonság |
info |
string |
Információk az eredmény eredeti adatforrásáról. Támogatási kérelmekhez használatos. |
matchType |
Match |
Az egyezés típusával kapcsolatos információk. Az alábbiak egyike:
|
poi |
Point |
A visszaadott POI részletei, beleértve az olyan információkat, mint a név, a telefon, az URL-cím és a besorolások. |
position |
Lat |
Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid névvel, & "lon". |
score |
number |
Az eredményhalmazon belüli érték, amely az eredmények közötti relatív egyezési pontszámot jelzi. Ezzel megállapíthatja, hogy az x eredmény kétszer akkora valószínűséggel lesz releváns, mint az y, ha az x értéke 2x az y értékével. Az értékek lekérdezésenként eltérőek, és csak egy eredményhalmaz relatív értékeként szolgálnak. |
type |
Search |
Az alábbiak egyike:
|
viewport |
Bounding |
A nézetport bal felső és jobb alsó koordinátái által ábrázolt eredményt lefedő nézetport. |
SearchAddressResultType
Az alábbiak egyike:
- POI
- Utca
- Földrajzi hely
- Pont címe
- Címtartomány
- Kereszt utca
Name | Típus | Description |
---|---|---|
Address Range |
string |
|
Cross Street |
string |
|
Geography |
string |
|
POI |
string |
|
Point Address |
string |
|
Street |
string |
SearchIndexes
Indexek, amelyekhez kiterjesztett irányítószámokat kell felvenni az eredményekbe.
Az elérhető indexek a következők:
Addr = Címtartományok
Geo = Földrajzi helyek
PAD = Pontcímek
POI = Érdekes pontok
Str = Utcák
XStr = Keresztutcák (metszetek)
Az értéknek az indextípusok vesszővel tagolt listájának kell lennie (bármilyen sorrendben), indexek nélkül pedig Nincs .
Alapértelmezés szerint a kiterjesztett irányítószámokat a Geo kivételével minden index tartalmazza. A földrajzi helyekre vonatkozó kiterjesztett irányítószám-listák meglehetősen hosszúak lehetnek, ezért szükség esetén explicit módon kell kérni őket.
Használati példák:
extendedPostalCodesFor=POI
extendedPostalCodesFor=PAD,Addr,POI
extendedPostalCodesFor=None
A kiterjesztett irányítószám egy cím extendedPostalCode tulajdonságaként lesz visszaadva. A rendelkezésre állás régiófüggő.
Name | Típus | Description |
---|---|---|
Addr |
string |
|
Geo |
string |
|
PAD |
string |
|
POI |
string |
|
Str |
string |
|
Xstr |
string |
SearchSummary
Egy Keresés API-válasz összefoglaló objektuma.
Name | Típus | Description |
---|---|---|
fuzzyLevel |
integer |
Az eredmények megadásához szükséges maximális intelligens szint. |
geoBias |
Lat |
Annak jelzése, hogy a belső keresőmotor mikor alkalmazott térinformatikai torzításokat az eredmények rangsorolásának javítása érdekében. Egyes metódusok ezt a lat és a lon paraméterek beállításával befolyásolhatják, ahol elérhetők. Más esetekben ez tisztán belső. |
limit |
integer |
A visszaadott válaszok maximális száma |
numResults |
integer |
A válaszban szereplő eredmények száma. |
offset |
integer |
A visszaadott eredmények kezdő eltolása a teljes eredményhalmazon belül. |
query |
string |
A keresési eredmények létrehozásához használt lekérdezési paraméter. |
queryTime |
integer |
A lekérdezés feloldásával töltött idő ezredmásodpercben. |
queryType |
Query |
A visszaadott lekérdezés típusa: KÖZELI vagy NON_NEAR. |
totalResults |
integer |
A talált eredmények teljes száma. |