Share via

Search - Get Search Fuzzy

  • Referencia
Service:
Maps
API Version:
1.0

Akkor használja, ha olyan keresési kérelemre van szüksége, amely képes kezelni a címek és a POI-tokenek kombinációit.

Az Get Search Fuzzy (ingyenes űrlap Keresés) API egy HTTP-kérésGET, amely zökkenőmentesen kezeli a POI-keresés és a geokódolás kombinációját. Ez egy ingyenes űrlap-Keresés API, amely a cím- vagy POI-jogkivonatok bármilyen kombinációját tartalmazó bemeneteket kezeli, mint egysoros keresést. A lat/lon pár környezeti pozícióval is súlyozható, vagy egy koordinátával és sugárral teljesen korlátozva van, vagy általában geo elfogult horgonypont nélkül is végrehajtható.

Határozottan javasoljuk, hogy az "countrySet" paramétert használva csak azokat az országokat/régiókat adja meg, amelyekre az alkalmazásnak lefedettségre van szüksége, mivel az alapértelmezett viselkedés az, hogy az egész világon keres, és esetleg felesleges eredményeket ad vissza.

Pl.: countrySet=USA,FR

A támogatott országok/régiók teljes listáját Keresés Lefedettség című témakörben találja.

A legtöbb Keresés a lekérdezések alapértelmezés szerint maxFuzzyLevel=2 értéket adnak a teljesítmény eléréséhez és a szokatlan eredmények csökkentéséhez. Ezt az új alapértelmezett értéket igény szerint felül lehet bírálni kérésenként a lekérdezési param maxFuzzyLevel=3 vagy 4 paraméterének megadásával.

GET https://atlas.microsoft.com/search/fuzzy/{format}?api-version=1.0&query={query}
With optional parameters: 
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-paraméterek

Name In Kötelező Típus Description
format
 path True

ResponseFormat

A válasz kívánt formátuma. Az érték lehet json vagy xml.
api-version
 query True

string

A Azure Maps API verziószáma.
query
 query True

string

A vonatkozó lekérdezési sztring (pl. "seattle", "pizza"). Vesszővel elválasztott sztringként is megadható, amelyet szélesség és hosszúság követ (pl. "47.641268, -122.125679"). Az URL-címnek megfelelően kell kódolva lennie.
brandSet
 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
btmRight
 query

string

A határolókeret jobb alsó helyzete. Pl. 37.553,-122.453
categorySet
 query

integer[]

A kategóriakészlet azonosítóinak vesszővel tagolt listája, amellyel az eredményt meghatározott érdeklődési pontok kategóriáira korlátozhatja. Az azonosító sorrendje nem számít. A kérelemenként támogatott értékek maximális száma categorySet 10. Ha több kategóriaazonosítót ad meg, a rendszer csak azokat a POI-kat adja vissza, amelyek a megadott listában szereplő kategóriák valamelyikéhez tartoznak (legalább). A támogatott kategóriák listája a POI Categories API használatával deríthető fel. Használati példák:

  • categorySet=7315 (Keresés Érdekességek az Étterem kategóriából)

  • categorySet=7315025,7315017 (Keresés kategória érdekes pontjai olasz vagy francia étterem)
connectorSet
 query

ElectricVehicleConnector[]

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:

  • StandardHouseholdCountrySpecific - Ezek a szabványos háztartási összekötők egy adott régióban. Ezek mind egyfázisú AC- és standard feszültség- és standard amperage. Lásd még: Plug & szoftvercsatornák típusai – Világszabványok.
  • IEC62196Type1 – Az IEC 62196-2 szabványban meghatározott 1-es összekötő. Más néven Yazaki után 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 240 V-os 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) csatlakozóval, amelyek lehetővé teszik a dc gyors töltését.
  • IEC62196Type2CableAttached – Az IEC 62196-2 szabványban meghatározott 2-es típusú összekötő. A töltési ponthoz csatlakozó kábelként és csatlakozóként van megadva.
  • IEC62196Type2Outlet – Az IEC 62196-2 szabványban meghatározott 2-es típusú összekötő. A töltőponthoz csatlakozóaljzatként van megadva.
  • IEC62196Type2CCS - Típus 2 alapú kombinált összekötő az IEC 62196-3 szabványban meghatározottak szerint. 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) csatlakozóval, amelyek lehetővé teszik a dc gyors töltését.
  • IEC62196Type3 – Írja be a 3. összekötőt az IEC 62196-2 szabványban meghatározottak szerint. 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 együtt használják.
  • Chademo - CHAdeMO-összekötő, amelyet a Tokyo Electric Power Company és az ipari partnerek alapítottak. Emiatt a TEPCO összekötőjeként is ismert. Támogatja a gyors DC töltést.
  • IEC60309AC1PhaseBlue - Az Ipari kék összekötő az IEC 60309 szabványban meghatározott összekötő. Ezt néha a szabvány, a szín és az a tény, hogy egyfázisú összekötő kombinációjaként is említik. 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ő. Vagyis vagy a Tesla saját fejlesztésű összekötőjét, más néven Tesla Portot említi, amely többnyire Észak-Amerika, vagy a módosított 2- es típusra (dc over Type 2) Európában.

Használati példák:

connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached
countrySet
 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
entityType
 query

GeographicEntityType

A földrajzi helyeken végzett szűrés szintjét adja meg. Szűkíti a megadott földrajzi entitástípusok keresését, például csak a települést adja vissza. Az eredményként kapott válasz tartalmazza a földrajzi azonosítót és az entitástípust. Ha egynél több entitást ad meg vesszővel tagolt listaként, a végpont a "legkisebb elérhető entitást" adja vissza. A visszaadott geometria-azonosítóval lekérhető a földrajzi hely geometriája a Get Keresés Polygon API-val. A következő paraméterek figyelmen kívül lesznek hagyva az entityType beállításakor:

  • Címsor
  • szám
  • returnRoadUse
  • returnSpeedLimit
  • roadUse
  • returnMatchType
extendedPostalCodesFor
 query

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ő.
idxSet
 query

SearchIndexes[]

A kereséshez használandó indexek vesszővel tagolt listája. A cikk sorrendje nem számít. Az elérhető indexek a következők: Addr = Címtartomány-interpoláció, Geo = Geographies, PAD = Point Addresses, POI = Points of interest, Str = Streets, Xstr = Cross Streets (metszetek)
language
 query

string

Nyelv, amelyben a keresési eredményeket vissza kell adni. Az egyik támogatott IETF-nyelvi címke, a kis- és nagybetűk nem érzéketlenek. Ha a megadott nyelven megadott adatok nem érhetők el egy adott mezőhöz, a rendszer az alapértelmezett nyelvet használja.

A részletekért tekintse meg a Támogatott nyelvek című témakört .
lat
 query

number

double

Szélesség, ahol az eredményeket torzítani kell. 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ényeknek elfogultnak kell lenniük. Pl. -121.89
maxFuzzyLevel
 query

integer

A használandó maximális fuzziness szint. Alapértelmezett: 2, minimum: 1 és maximum: 4

  • Az 1. szint nem rendelkezik helyesírás-ellenőrzéssel.

  • A 2. szint normál n-gram helyesírás-ellenőrzést használ. A "restrant" lekérdezés például megfeleltethető az "étteremnek".

  • A 3. szint hangszerű helyesírás-ellenőrzést és zsindelyes helyesírás-ellenőrzést használ. A hangszerű helyesírás-ellenőrzés az "rstrnt" és az "étterem" egyezése. Shingle helyesírás-ellenőrzés a "mountainview" a "hegyi nézet" egyezés.

  • A 4. szint nem ad hozzá több helyesírás-ellenőrző függvényt.

A keresőmotor elkezd keresni egyezést a minFuzzyLevel által meghatározott szinten, és leállítja a keresést a maxFuzzyLevel által megadott szinten.
minFuzzyLevel
 query

integer

A használni kívánt minimális fuzziness szint. Alapértelmezett: 1, minimum: 1 és maximum: 4

  • Az 1. szint nem rendelkezik helyesírás-ellenőrzéssel.

  • A 2. szint normál n-gram helyesírás-ellenőrzést használ. A "restrant" lekérdezés például megfeleltethető az "étteremnek".

  • A 3. szint hangszerű helyesírás-ellenőrzést és zsindelyes helyesírás-ellenőrzést használ. A hangszerű helyesírás-ellenőrzés az "rstrnt" és az "étterem" egyezése. Shingle helyesírás-ellenőrzés a "mountainview" a "hegyi nézet" egyezés.

  • A 4. szint nem ad hozzá több helyesírás-ellenőrző függvényt.

A keresőmotor elkezd keresni egyezést a minFuzzyLevel által meghatározott szinten, és leállítja a keresést a maxFuzzyLevel által megadott szinten.
ofs
 query

integer

A visszaadott eredmények kezdő eltolása a teljes eredményhalmazon belül. Alapértelmezett: 0
openingHours
 query

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
radius
 query

integer

A mérők sugara, hogy az eredmények a meghatározott területre legyenek korlátozva
topLeft
 query

string

A határolókeret bal felső pozíciója. 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ódot ad meg
view
 query

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 különböző nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen az alkalmazás által kiszolgálni kívánt ország/régió által megkövetelt nézetnek. Alapértelmezés szerint a View paraméter "Egyesített" értékre van állítva, még akkor is, ha még nem definiálta a kérelemben. Az Ön felelőssége, hogy meghatározza a felhasználók helyét, majd helyesen állítsa be a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást is, amely a kérés IP-címe alapján adja vissza a térképadatokat. Az Azure Maps View paraméterét a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a térképekkel kapcsolatos jogszabályokat is, azon ország/régió tekintetében, 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

SearchAddressResult

OK
Other Status Codes

ErrorResponse

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ői egy vagy több Azure Maps erőforrásfiókhoz vagy alerőforrásokhoz való hozzáférés kijelölésére szolgálnak. 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, a REST API-khoz Azure Maps engedélyekkel rendelkező 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ások modellezésére olyan objektumokon keresztül, amelyek hozzáférés-vezérlésre képesek adott API-kon és hatókörökön.

Megjegyzés

  • Ez a biztonsági definíció a fejléc használatával x-ms-client-id jelzi, hogy az alkalmazás melyik Azure Maps erőforráshoz kér hozzáférést. Ez a Térképek felügyeleti API-ból szerezhető be.
  • Ez Authorization URL az Azure nyilvános felhőpéldányára jellemző. 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és 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 Webes SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esethez.
  • A Microsoft Identitásplatform kapcsolatos további információkért lásd: Microsoft Identitásplatform áttekintés.

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 a PowerShell, a CLI, az Azure SDK-k vagy a 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ében azt javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítésével férhessen hozzá Azure Maps REST API-khoz, 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, amely a Azure Maps erőforrás SAS listázási műveletéből jön létre 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 jogkivonat lejáratához, sebességéhez és régiójához. Más szóval az SAS-jogkivonattal az alkalmazások biztonságosabb módon szabályozhatják a hozzáférést, mint a megosztott kulcs.

Nyilvánosan közzétett alkalmazások esetében azt javasoljuk, hogy konfigurálja az engedélyezett források adott listáját a Térképfiók erőforráson a megjelenítési visszaélések korlátozása és az SAS-jogkivonat rendszeres megújítása érdekében.

Type: apiKey
In: header

Példák

Search City Seattle

Sample Request

GET https://atlas.microsoft.com/search/fuzzy/json?api-version=1.0&query=seattle&openingHours=nextSevenDays

Sample Response

Status code:
200 
{
  "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
          }
        }
      ]
    }
  ]
}

Definíciók

Name Description
Address

Az eredmény címe
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.
BoundingBox

A nézetport bal felső és jobb alsó koordinátái által képviselt eredményt lefedő nézetport.
BoundingBoxCompassNotation

A hely határolókerete.
Brand

A POI-hoz társított márka
Classification

A visszaadott POI besorolása
ClassificationName

A besorolás neve
DataSources

Nem kötelező szakasz. Referenciaazonosítók a Get Keresés Polygon API-hoz.
ElectricVehicleConnector

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:

  • StandardHouseholdCountrySpecific - Ezek a szabványos háztartási összekötők egy adott régióban. Ezek mind egyfázisú AC- és standard feszültség- és standard amperage. Lásd még: Plug & szoftvercsatornák típusai – Világszabványok.
  • IEC62196Type1 – Az IEC 62196-2 szabványban meghatározott 1-es összekötő. Más néven Yazaki után 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 240 V-os 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) csatlakozóval, amelyek lehetővé teszik a dc gyors töltését.
  • IEC62196Type2CableAttached – Az IEC 62196-2 szabványban meghatározott 2-es típusú összekötő. A töltési ponthoz csatlakozó kábelként és csatlakozóként van megadva.
  • IEC62196Type2Outlet – Az IEC 62196-2 szabványban meghatározott 2-es típusú összekötő. A töltőponthoz csatlakozóaljzatként van megadva.
  • IEC62196Type2CCS - Típus 2 alapú kombinált összekötő az IEC 62196-3 szabványban meghatározottak szerint. 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) csatlakozóval, amelyek lehetővé teszik a dc gyors töltését.
  • IEC62196Type3 – Írja be a 3. összekötőt az IEC 62196-2 szabványban meghatározottak szerint. 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 együtt használják.
  • Chademo - CHAdeMO-összekötő, amelyet a Tokyo Electric Power Company és az ipari partnerek alapítottak. Emiatt a TEPCO összekötőjeként is ismert. Támogatja a gyors DC töltést.
  • IEC60309AC1PhaseBlue - Az Ipari kék összekötő az IEC 60309 szabványban meghatározott összekötő. Ezt néha a szabvány, a szín és az a tény, hogy egyfázisú összekötő kombinációjaként is említik. 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ő. Vagyis vagy a Tesla saját fejlesztésű összekötőjét, más néven Tesla Portot említi, amely többnyire Észak-Amerika, vagy a módosított 2- es típusra (dc over Type 2) Európában.

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.
EntryPoint

A visszaadott POI belépési pontja.
EntryPointType

A belépési pont típusa. Az érték lehet fő vagy alérték.
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.
ErrorDetail

A hiba részletei.
ErrorResponse

Hibaválasz
GeographicEntityType

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.
LatLongPairAbbreviated

Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid nevek használatával & "lon".
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 különböző nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen az alkalmazás által kiszolgálni kívánt ország/régió által megkövetelt nézetnek. Alapértelmezés szerint a View paraméter "Egyesített" értékre van állítva, még akkor is, ha még nem definiálta a kérelemben. Az Ön felelőssége, hogy meghatározza a felhasználók helyét, majd helyesen állítsa be a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást is, amely a kérés IP-címe alapján adja vissza a térképadatokat. Az Azure Maps View paraméterét a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a térképekkel kapcsolatos jogszabályokat is, azon ország/régió tekintetében, 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.
MatchType

A fordított címkeresési művelet egyezésének típusai.
OperatingHours

A POI nyitvatartási ideje (érdekes pontok).
OperatingHoursRange

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
OperatingHoursTime

Dátumot és időpontot jelöl
OperatingHoursTimeRange

Nyitott időtartomány egy napra
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.
PointOfInterestCategorySet

POI-kategória
QueryType

A visszaadott lekérdezés típusa: KÖZELI vagy NON_NEAR.
ResponseFormat

A válasz kívánt formátuma. Az érték lehet json vagy xml.
SearchAddressResult

Ezt az objektumot egy sikeres Keresés hívás adja vissza.
SearchAddressResultItem

Eredményobjektum egy Keresés API-válaszhoz.
SearchAddressResultType

Az alábbiak egyike:

  • POI
  • Utca
  • Földrajzi hely
  • Pont címe
  • Címtartomány
  • Kereszt utca
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 (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ő.
SearchSummary

Egy Keresés API-válasz összefoglaló objektuma.

Address

Az eredmény címe

Name Típus Description
boundingBox

BoundingBoxCompassNotation

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

countrySubdivisionCode előtagja countryCode ( countryCode-countrySubdivisionCode ) és a kötőjel alkotja az ISO 3166-2 kódot. Példák: TX For Texas, SCT for Scotland és ON for Ontario.
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 freeformAddress használható. localName a postai önkormányzatot jelöli. A helytől localName függően egy város vagy város általánosan ismert neve. Egy város vagy város általánosan ismert nevére a helyett használja a következőt localNamemunicipality: .
municipality

string

Város / Város
Megjegyzés: municipality a lakótelepet jelöli. A helytől függően az municipality érték eltérhet egy város vagy város általánosan ismert nevétől. A város vagy város általánosan ismert neve esetén azt javasoljuk, hogy az localName értéket használja az municipality érték helyett.
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

LatLongPairAbbreviated

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

LatLongPairAbbreviated

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

LatLongPairAbbreviated

Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid nevek használatával & "lon".
topLeftPoint

LatLongPairAbbreviated

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

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

ClassificationName[]

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

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 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:

  • StandardHouseholdCountrySpecific - Ezek a szabványos háztartási összekötők egy adott régióban. Ezek mind egyfázisú AC- és standard feszültség- és standard amperage. Lásd még: Plug & szoftvercsatornák típusai – Világszabványok.
  • IEC62196Type1 – Az IEC 62196-2 szabványban meghatározott 1-es összekötő. Más néven Yazaki után 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 240 V-os 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) csatlakozóval, amelyek lehetővé teszik a dc gyors töltését.
  • IEC62196Type2CableAttached – Az IEC 62196-2 szabványban meghatározott 2-es típusú összekötő. A töltési ponthoz csatlakozó kábelként és csatlakozóként van megadva.
  • IEC62196Type2Outlet – Az IEC 62196-2 szabványban meghatározott 2-es típusú összekötő. A töltőponthoz csatlakozóaljzatként van megadva.
  • IEC62196Type2CCS - Típus 2 alapú kombinált összekötő az IEC 62196-3 szabványban meghatározottak szerint. 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) csatlakozóval, amelyek lehetővé teszik a dc gyors töltését.
  • IEC62196Type3 – Írja be a 3. összekötőt az IEC 62196-2 szabványban meghatározottak szerint. 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 együtt használják.
  • Chademo - CHAdeMO-összekötő, amelyet a Tokyo Electric Power Company és az ipari partnerek alapítottak. Emiatt a TEPCO összekötőjeként is ismert. Támogatja a gyors DC töltést.
  • IEC60309AC1PhaseBlue - Az Ipari kék összekötő az IEC 60309 szabványban meghatározott összekötő. Ezt néha a szabvány, a szín és az a tény, hogy egyfázisú összekötő kombinációjaként is említik. 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ő. Vagyis vagy a Tesla saját fejlesztésű összekötőjét, más néven Tesla Portot említi, amely többnyire Észak-Amerika, vagy a módosított 2- es típusra (dc over Type 2) 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 Ipari kék összekötő az IEC 60309 szabványban meghatározott összekötő. Ezt néha a szabvány, a szín és az a tény, hogy egyfázisú összekötő kombinációjaként is említik. 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. Más néven Yazaki után 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 240 V-os 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) csatlakozóval, 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) csatlakozóval, amelyek lehetővé teszik a dc gyors töltését.
IEC62196Type2CableAttached

string

Az IEC 62196-2 szabványban meghatározott 2. típusú összekötő. A töltési ponthoz csatlakozó kábelként és csatlakozóként van megadva
IEC62196Type2Outlet

string

Az IEC 62196-2 szabványban meghatározott 2. típusú összekötő. 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 együtt használják.
StandardHouseholdCountrySpecific

string

Ezek a szabványos háztartási összekötők egy adott régióban. Ezek mind egyfázisú AC- és standard feszültség- és standard amperage.

Lásd még: Plug & szoftvercsatornák típusai – Világszabványok
Tesla

string

A Tesla-összekötő a régióspecifikus Tesla Supercharger-összekötő. Vagyis vagy a Tesla saját fejlesztésű összekötőjét, más néven Tesla Portot említi, amely többnyire Észak-Amerika, vagy a módosított 2- es típusra (dc over Type 2) 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

LatLongPairAbbreviated

Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid nevek használatával & "lon".
type

EntryPointType

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

ErrorAdditionalInfo[]

A hiba további információi.
code

string

A hibakód.
details

ErrorDetail[]

A hiba részletei.
message

string

A hibaüzenet.
target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

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 nevek használatával & "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 különböző nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen az alkalmazás által kiszolgálni kívánt ország/régió által megkövetelt nézetnek. Alapértelmezés szerint a View paraméter "Egyesített" értékre van állítva, még akkor is, ha még nem definiálta a kérelemben. Az Ön felelőssége, hogy meghatározza a felhasználók helyét, majd helyesen állítsa be a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást is, amely a kérés IP-címe alapján adja vissza a térképadatokat. Az Azure Maps View paraméterét a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a térképekkel kapcsolatos jogszabályokat is, azon ország/régió tekintetében, 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 (egyéb)
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

OperatingHoursTimeRange[]

A következő 7 nap időtartományainak listája

OperatingHoursRange

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

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

OperatingHoursTime

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

OperatingHoursTime

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

PointOfInterestCategorySet[]

A legspecifikusabb POI-kategóriák listája
classifications

Classification[]

Besorolási tömb
name

string

A POI tulajdonság neve
openingHours

OperatingHours

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 végezték el
NON_NEAR

string

Keresés globálisan végezték el, anélkül, hogy torzítanak egy bizonyos szélességre és hosszúságra, és nincs meghatározott sugár

ResponseFormat

A válasz kívánt formátuma. Az érték lehet json vagy xml.

Name Típus Description
json

string

A JavaScript object Notation Data Interchange formátuma
xml

string

Az extensible Markup Language (Bővíthető korrektúranyelv)

SearchAddressResult

Ezt az objektumot egy sikeres Keresés hívás adja vissza.

Name Típus Description
results

SearchAddressResultItem[]

Keresés API-eredmények listája.
summary

SearchSummary

Keresés API-válasz összefoglaló objektuma

SearchAddressResultItem

Eredményobjektum egy Keresés API-válaszhoz.

Name Típus Description
address

Address

Az eredmény címe
addressRanges

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.
dataSources

DataSources

Nem kötelező szakasz. Referenciageometriai azonosító a Get Keresés Polygon API-hoz.
detourTime

integer

Kitérő másodpercben. Csak a Keresés Route API-ra irányuló hívások esetén ad vissza.
dist

number

Egyenes vonal távolsága az eredmény és a geobiák helye között méterben.
entityType

GeographicEntityType

Földrajzi entitás típusa. Csak akkor jelenik meg, ha az entityType kérése megtörtént, és elérhető.
entryPoints

EntryPoint[]

EntryPoint-tömb. Ezek a helyszínen elérhető bejáratok típusait írják le. A típus lehet "fő" a főbejáratokhoz, például a bejárati ajtóhoz vagy az előszobához, valamint "minor" az oldalsó és hátsó ajtókhoz.
id

string

Id tulajdonság
info

string

Információ az eredmény eredeti adatforrásáról. Támogatási kérelmekhez használható.
matchType

MatchType

Az egyezés típusára vonatkozó információk.

Az alábbiak egyike:

  • AddressPoint
  • HouseNumberRange
  • Utca
poi

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.
position

LatLongPairAbbreviated

Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid nevek használatával & "lon".
score

number

Az eredményhalmazon belüli érték, amely az eredmények közötti relatív egyező pontszámot jelzi. Ezzel megállapíthatja, hogy az x eredmény kétszer akkora valószínűséggel lesz releváns, mint 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 értik.
type

SearchAddressResultType

Az alábbiak egyike:

  • POI
  • Utca
  • Földrajzi hely
  • Pont címe
  • Címtartomány
  • Kereszt utca
viewport

BoundingBox

A nézetport bal felső és jobb alsó koordinátái által képviselt 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 (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ő.

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 fuzzy szint.
geoBias

LatLongPairAbbreviated

Annak jelzése, hogy a belső keresőmotor térinformatikai torzításokat alkalmazott az eredmények rangsorolásának javítására. Egyes metódusok ezt a lat és a lon paraméterek beállításával befolyásolhatják, ahol elérhető. Más esetekben ez tisztán belső.
limit

integer

A visszaadott válaszok maximális száma
numResults

integer

A válasz eredményeinek száma.
offset

integer

A visszaadott eredmények kezdő eltolása a teljes eredménykészleten belül.
query

string

A keresési eredmények előállítá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

QueryType

A visszaadott lekérdezés típusa: KÖZELI vagy NON_NEAR.
totalResults

integer

A talált eredmények teljes száma.