Megosztás a következőn keresztül:


Search - Get Search POI

A használatával név alapján keresheti meg az érdekes pontokat.

Az Points of Interest (POI) Search API egy HTTP-kérés GET , amely lehetővé teszi a POI-eredmények név szerinti lekérését. Emellett további lekérdezési paramétereket is támogat, például a nyelv és az eredmények szűrését az ország/régió vagy a határolókeret által vezérelt érdeklődési terület szerint. A végpont csak a lekérdezési sztringnek megfelelő POI-eredményeket adja vissza. A válasz tartalmazza a POI részleteit, például a címet, a koordináta helyét és a kategóriát.

GET https://atlas.microsoft.com/search/poi/{format}?api-version=1.0&query={query}
GET https://atlas.microsoft.com/search/poi/{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

ResponseFormat

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-névnek (pl. "szabadságszobor", "starbucks" ) megfelelő URL-kódolásúnak kell 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é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 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 Érdekes helyek az Étterem kategóriából)

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

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

extendedPostalCodesFor
query

PointOfInterestExtendedPostalCodes[]

Indexek, amelyekhez kiterjesztett irányítószámokat kell felvenni az eredményekbe.

Az elérhető indexek a következők:

POI = Érdekes pontok

A kiterjesztett irányítószámok letiltásához a POI vagy a None értéknek kell lennie.

Alapértelmezés szerint a kiterjesztett irányítószámokat is tartalmazza a rendszer.

Használati példák:

extendedPostalCodesFor=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

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

Az eredmények meghatározott területre való korlátozásának mérőben megadott sugara

topLeft
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

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

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

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.

Típus: 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.

Típus: apiKey
In: header

Példák

Search for juice bars within 5 miles of Seattle Downtown and limit the response to 5 results

Mintakérelem

GET https://atlas.microsoft.com/search/poi/json?api-version=1.0&query=juice bars&limit=5&lat=47.606038&lon=-122.333345&radius=8046&openingHours=nextSevenDays

Mintaválasz

{
  "summary": {
    "query": "juice bars",
    "queryType": "NON_NEAR",
    "queryTime": 36,
    "numResults": 5,
    "offset": 0,
    "totalResults": 12,
    "fuzzyLevel": 1,
    "geoBias": {
      "lat": 47.606038,
      "lon": -122.333345
    }
  },
  "results": [
    {
      "type": "POI",
      "id": "US/POI/p0/9223158",
      "score": 5.664,
      "dist": 667.2710170950347,
      "info": "search:ta:840539001755244-US",
      "poi": {
        "name": "Pressed Juicery",
        "phone": "+(1)-(206)-6240804",
        "brands": [
          {
            "name": "Pressed Juicery"
          }
        ],
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.pressedjuicery.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "400",
        "streetName": "Pine St",
        "municipalitySubdivision": "Seattle, Central Business District",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98101",
        "extendedPostalCode": "981011628",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "400 Pine St, Seattle, WA 98101",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.61138,
        "lon": -122.3374
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.61228,
          "lon": -122.33873
        },
        "btmRightPoint": {
          "lat": 47.61048,
          "lon": -122.33607
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.61134,
            "lon": -122.33737
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "US/POI/p0/9222534",
      "score": 5.663,
      "dist": 1101.6849025777728,
      "info": "search:ta:840539001760125-US",
      "poi": {
        "name": "Pressed Juicery",
        "phone": "+(1)-(206)-4533785",
        "brands": [
          {
            "name": "Pressed Juicery"
          }
        ],
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.pressedjuicery.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "315",
        "streetName": "E Pine St",
        "municipalitySubdivision": "Seattle, Broadway",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98122",
        "extendedPostalCode": "9812200",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "315 E Pine St, Seattle, WA 98122",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.61518,
        "lon": -122.32768
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.61608,
          "lon": -122.32901
        },
        "btmRightPoint": {
          "lat": 47.61428,
          "lon": -122.32635
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.61523,
            "lon": -122.32768
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "US/POI/p1/9133689",
      "score": 5.659,
      "dist": 2649.8700791555398,
      "info": "search:ta:840539001339220-US",
      "poi": {
        "name": "Pressed Juicery",
        "phone": "+(1)-(206)-2820651",
        "brands": [
          {
            "name": "Pressed Juicery"
          }
        ],
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.pressedjuicery.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "604",
        "streetName": "1st Ave N",
        "municipalitySubdivision": "Seattle, Lower Queen Anne",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98109",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "604 1st Ave N, Seattle, WA 98109",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.6247,
        "lon": -122.35533
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.6256,
          "lon": -122.35666
        },
        "btmRightPoint": {
          "lat": 47.6238,
          "lon": -122.354
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.6247,
            "lon": -122.3554
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "US/POI/p1/9131285",
      "score": 5.646,
      "dist": 5097.757019046541,
      "info": "search:ta:840539001743255-US",
      "poi": {
        "name": "Custom Smoothie & Sports Nutrition",
        "phone": "+(1)-(206)-5475522",
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.customsmoothie.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "462",
        "streetName": "N 34th St",
        "municipalitySubdivision": "Seattle, Fremont",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98103",
        "extendedPostalCode": "981038600",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "462 N 34th St, Seattle, WA 98103",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.65016,
        "lon": -122.35182
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.65106,
          "lon": -122.35315
        },
        "btmRightPoint": {
          "lat": 47.64926,
          "lon": -122.35049
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.64991,
            "lon": -122.3519
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "US/POI/p0/9228250",
      "score": 5.637,
      "dist": 6235.798481758295,
      "info": "search:ta:840531000416784-US",
      "poi": {
        "name": "Jamba Juice",
        "phone": "+(1)-(206)-6322060",
        "brands": [
          {
            "name": "Jamba Juice"
          }
        ],
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.jambajuice.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "4555",
        "streetName": "Stone Way N",
        "municipalitySubdivision": "Wallingford, Seattle",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98103",
        "extendedPostalCode": "981036600",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "4555 Stone Way N, Seattle, WA 98103",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.66179,
        "lon": -122.34233
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.66269,
          "lon": -122.34367
        },
        "btmRightPoint": {
          "lat": 47.66089,
          "lon": -122.34099
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.66188,
            "lon": -122.34211
          }
        }
      ]
    }
  ]
}

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

PointOfInterestExtendedPostalCodes

Indexek, amelyekhez kiterjesztett irányítószámokat kell felvenni az eredményekbe.

Az elérhető indexek a következők:

POI = Érdekes pontok

A kiterjesztett irányítószámok letiltásához a POI vagy a None értéknek kell lennie.

Alapértelmezés szerint a kiterjesztett irányítószámokat is tartalmazza a rendszer.

Használati példák:

extendedPostalCodesFor=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ő.

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
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 vagy alérték.

EntryPointType

A belépési pont típusa. Az érték lehet 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

Névvel ellátott terület

Municipality

string

Város / Város

MunicipalitySubdivision

string

Al/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 (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

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ó

PointOfInterestExtendedPostalCodes

Indexek, amelyekhez kiterjesztett irányítószámokat kell felvenni az eredményekbe.

Az elérhető indexek a következők:

POI = Érdekes pontok

A kiterjesztett irányítószámok letiltásához a POI vagy a None értéknek kell lennie.

Alapértelmezés szerint a kiterjesztett irányítószámokat is tartalmazza a rendszer.

Használati példák:

extendedPostalCodesFor=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
None

string

POI

string

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

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.