Udostępnij za pośrednictwem

Search - Post Search Along Route

  • Odwołanie
Usługa:
Maps
Wersja interfejsu API:
1.0

Służy do wykonywania rozmytego wyszukiwania poisu wzdłuż określonej trasy.

Interfejs Post Search Along Route API jest żądaniem HTTP POST , które umożliwia wykonywanie rozmytego wyszukiwania poświadczeń poświadczeń wzdłuż określonej trasy. To wyszukiwanie jest ograniczone przez określenie miary ograniczającej maxDetourTime .

Aby wysłać punkty trasy, użyj POST żądania, w którym treść żądania będzie zawierać route obiekt reprezentowany jako GeoJSON LineString typ, a Content-Type nagłówek zostanie ustawiony na application/jsonwartość . Każdy punkt trasy w route elemecie GeoJSON Position jest reprezentowany jako typ, tj. tablica, w której następuje wartość długości geograficznej, a wartość szerokościgeograficznej jest ignorowana. Element route powinien zawierać co najmniej 2 punkty trasy.

Istnieje możliwość, że oryginalna trasa zostanie zmieniona, niektóre z nich mogą zostać pominięte. Jeśli trasa przechodząca przez znaleziony punkt jest szybsza niż oryginalna, detourTime wartość w odpowiedzi jest ujemna.

POST https://atlas.microsoft.com/search/alongRoute/{format}?api-version=1.0&query={query}&maxDetourTime={maxDetourTime}
Z parametrami opcjonalnymi: 
POST https://atlas.microsoft.com/search/alongRoute/{format}?api-version=1.0&query={query}&maxDetourTime={maxDetourTime}&limit={limit}&brandSet={brandSet}&categorySet={categorySet}&connectorSet={connectorSet}&view={view}&openingHours=nextSevenDays

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
format
 path True

ResponseFormat

Żądany format odpowiedzi. Wartość może być json lub xml.
api-version
 query True

string

Numer wersji interfejsu API Azure Maps.
maxDetourTime
 query True

integer

Maksymalny czas objazdu punktu orientacyjnego w sekundach. Maksymalna wartość to 3600 sekund
query
 query True

string

Nazwa interfejsu użytkownika do wyszukania (np. "statua wolności", "starbucks", "pizza"). Musi być poprawnie zakodowany adres URL.
brandSet
 query

string[]

Rozdzielona przecinkami lista nazw marek, których można użyć do ograniczenia wyniku do określonych marek. Kolejność elementów nie ma znaczenia. Po podaniu wielu marek zostaną zwrócone tylko wyniki należące do (co najmniej) jednej z podanych list. Marki, które zawierają "", w swojej nazwie powinny być umieszczane w cudzysłowie.

Przykłady użycia:

brandSet=Foo

brandSet=Foo,Bar

brandSet="A,B,C Przecinek",Bar
categorySet
 query

integer[]

Rozdzielona przecinkami lista identyfikatorów zestawów kategorii, których można użyć do ograniczenia wyniku do określonych kategorii Punktów orientacyjnych. Kolejność identyfikatorów nie ma znaczenia. Maksymalna liczba obsługiwanych categorySet wartości na żądanie wynosi 10. Po podaniu wielu identyfikatorów kategorii zostaną zwrócone tylko elementy POI należące do (co najmniej) jednej z kategorii z podanej listy. Listę obsługiwanych kategorii można odnaleźć przy użyciu interfejsu API kategorii weryfikacji koncepcji. Przykłady użycia:

  • categorySet=7315 (Search Punkty orientacyjne z kategorii Restauracja)

  • categorySet=7315025,7315017 (Search Punkty orientacyjne kategorii włoskiej lub francuskiej restauracji)
connectorSet
 query

ElectricVehicleConnector[]

Rozdzielona przecinkami lista typów łączników, których można użyć do ograniczenia wyniku do stacji pojazdów elektrycznych obsługujących określone typy łączników. Kolejność elementów nie ma znaczenia. Po podaniu wielu typów łączników zostaną zwrócone tylko wyniki należące do (co najmniej) jednej z podanych list.

Dostępne typy łączników to:

  • StandardHouseholdCountrySpecific - Są to standardowe łączniki gospodarstwa domowego dla określonego regionu. Wszystkie są jednofazowe prądu zmiennego oraz standardowe napięcie i standardowy amperaż. Zobacz również: Plug & socket types - World Standards (Podłącz typy gniazd & — światowe standardy).
  • IEC62196Type1 - Łącznik typu 1 zgodnie z definicją w standardzie IEC 62196-2. Nazwany również Yazaki po oryginalnym producencie lub SAE J1772 po standardzie, który po raz pierwszy go opublikował. Najczęściej używane w połączeniu z pojedynczą fazą 120V lub do 240V pojedynczej infrastruktury fazowej.
  • IEC62196Type1CCS - Łącznik kombi oparty na typie 1 zgodnie z definicją w standardzie IEC 62196-3. Łącznik jest oparty na łączniku typu 1, zgodnie z definicją w standardzie IEC 62196-2, z dwoma dodatkowymi kontaktami prądu bezpośredniego (DC), aby umożliwić szybkie ładowanie prądu DC.
  • IEC62196Type2CableAttached - Łącznik typu 2 zgodnie z definicją w standardzie IEC 62196-2. Dostarczone jako kabel i podłączona do punktu ładowania.
  • IEC62196Type2Outlet - Łącznik typu 2 zgodnie z definicją w standardzie IEC 62196-2. Dostarczone jako gniazdo ustawione w punkcie ładowania.
  • IEC62196Type2CCS - Łącznik kombi oparty na typie 2 zgodnie z definicją w standardzie IEC 62196-3. Łącznik jest oparty na łączniku typu 2, zgodnie z definicją w standardzie IEC 62196-2, z dwoma dodatkowymi kontaktami prądu bezpośredniego (DC), aby umożliwić szybkie ładowanie prądu DC.
  • IEC62196Type3 - Łącznik typu 3 zgodnie z definicją w standardzie IEC 62196-2. Również o nazwie Scame po oryginalnym producencie. Najczęściej używane w połączeniu z maksymalnie 240V pojedynczą fazą lub do 420V trzyfazowej infrastruktury.
  • Chademo - Łącznik CHAdeMO nazwany na cześć stowarzyszenia utworzonego przez Tokyo Electric Power Company i partnerów przemysłowych. Z tego powodu jest również znany jako łącznik TEPCO. Obsługuje szybkie ładowanie prądu stałego.
  • IEC60309AC1PhaseBlue - Łącznik niebieski przemysłowy jest łącznikiem zdefiniowanym w standardzie IEC 60309. Czasami jest ona określana za pomocą kombinacji standardu, koloru i faktu, że jest to jednofazowy łącznik. Łącznik ma zwykle konfigurację "P+N+E, 6h".
  • IEC60309DCWhite - Łącznik przemysłowy Biały jest łącznikiem DC zdefiniowanym w standardzie IEC 60309.
  • Tesla - Łącznik Tesli jest regionalnie specyficzny łącznik Tesla Supercharger. Tj. odnosi się on do zastrzeżonego łącznika Tesli, czasami określanego jako Tesla Port, głównie ograniczone do Ameryka Północna lub zmodyfikowanego typu 2 (DC nad typem 2) w Europie.

Przykłady użycia:

connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached
limit
 query

integer

Maksymalna liczba odpowiedzi, które zostaną zwrócone. Wartość domyślna to 10. Maksymalna wartość to 20
openingHours
 query

OperatingHoursRange

Godziny operacji dla weryfikacji koncepcji (punkty orientacyjne). Dostępność godzin pracy będzie się różnić w zależności od dostępnych danych. Jeśli nie upłynął, nie zostaną zwrócone żadne informacje o godzinach otwarcia. Obsługiwana wartość: nextSevenDays
view
 query

LocalizedMapView

Parametr View (nazywany również parametrem "region użytkownika") umożliwia wyświetlanie prawidłowych map dla określonego kraju/regionu dla spornych geopolitycznie regionów. Różne kraje/regiony mają różne widoki takich regionów, a parametr Wyświetl umożliwia aplikacji zachowanie zgodności z widokiem wymaganym przez kraj/region, który będzie obsługiwać aplikacja. Domyślnie parametr Widok jest ustawiony na wartość "Unified", nawet jeśli nie zdefiniowano go w żądaniu. Twoim zadaniem jest określenie lokalizacji użytkowników, a następnie poprawne ustawienie parametru Wyświetl dla tej lokalizacji. Alternatywnie możesz ustawić opcję "View=Auto", która zwróci dane mapy na podstawie adresu IP żądania. Parametr View w Azure Maps musi być używany zgodnie z obowiązującymi przepisami, w tym z przepisami dotyczącymi mapowania, kraju/regionu, w którym udostępniane są mapy, obrazy i inne dane oraz zawartość innych firm, do których masz uprawnienia dostępu za pośrednictwem Azure Maps. Przykład: view=IN.

Aby uzyskać szczegółowe informacje i wyświetlić dostępne widoki, zapoznaj się z tematem Obsługiwane widoki .

Nagłówek żądania

Nazwa Wymagane Typ Opis
x-ms-client-id

string

Określa, które konto jest przeznaczone do użycia w połączeniu z modelem zabezpieczeń Tożsamość Microsoft Entra. Reprezentuje unikatowy identyfikator konta Azure Maps i można go pobrać z interfejsu API konta płaszczyzny zarządzania Azure Maps. Aby użyć zabezpieczeń Tożsamość Microsoft Entra w usłudze Azure Maps, zobacz następujące artykuły, aby uzyskać wskazówki.

Treść żądania

Nazwa Typ Opis
route

GeoJsonLineString

Prawidłowy GeoJSON LineString typ geometrii. Aby uzyskać szczegółowe informacje, zobacz RFC 7946 .

Odpowiedzi

Nazwa Typ Opis
200 OK

SearchAddressResult

OK
Other Status Codes

ErrorResponse

Wystąpił nieoczekiwany błąd.

Zabezpieczenia

AADToken

Są to przepływy protokołu OAuth 2.0 Microsoft Entra. W połączeniu z kontrolą dostępu opartą na rolach platformy Azure może służyć do kontrolowania dostępu do interfejsów API REST Azure Maps. Mechanizmy kontroli dostępu opartej na rolach platformy Azure służą do wyznaczania dostępu do co najmniej jednego konta zasobów Azure Maps lub zasobów podrzędnych. Każdy użytkownik, grupa lub jednostka usługi może mieć dostęp za pośrednictwem wbudowanej roli lub roli niestandardowej składającej się z co najmniej jednego uprawnienia do Azure Maps interfejsów API REST.

Aby zaimplementować scenariusze, zalecamy wyświetlenie pojęć dotyczących uwierzytelniania. Podsumowując, ta definicja zabezpieczeń udostępnia rozwiązanie do modelowania aplikacji za pośrednictwem obiektów, które mogą kontrolować dostęp do określonych interfejsów API i zakresów.

Uwaga

  • Ta definicja zabezpieczeń wymaga użycia nagłówkax-ms-client-id, aby wskazać, do którego zasobu Azure Maps aplikacja żąda dostępu. Można to uzyskać za pomocą interfejsu API zarządzania mapami .
  • Element Authorization URL jest specyficzny dla wystąpienia chmury publicznej platformy Azure. Suwerenne chmury mają unikatowe adresy URL autoryzacji i konfiguracje Tożsamość Microsoft Entra.
  • Kontrola dostępu oparta na rolach platformy Azure jest konfigurowana z poziomu płaszczyzny zarządzania platformy Azure za pośrednictwem Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów AZURE SDK lub interfejsów API REST.
  • Użycie zestawu AZURE MAPS Web SDK umożliwia skonfigurowanie aplikacji na podstawie konfiguracji dla wielu przypadków użycia.
  • Aby uzyskać więcej informacji na temat Platforma tożsamości Microsoft, zobacz omówienie Platforma tożsamości Microsoft.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Jest to klucz współużytkowany podczas tworzenia konta Azure Maps w Azure Portal lub przy użyciu programu PowerShell, interfejsu wiersza polecenia, zestawów AZURE SDK lub interfejsu API REST.

Za pomocą tego klucza każda aplikacja może uzyskiwać dostęp do wszystkich interfejsów API REST. Innymi słowy, ten klucz może służyć jako klucz główny na koncie, w którym są wystawiane.

W przypadku publicznie uwidocznionych aplikacji zalecamy użycie podejścia do poufnych aplikacji klienckich w celu uzyskania dostępu Azure Maps interfejsów API REST, aby klucz mógł być bezpiecznie przechowywany.

Typ: apiKey
W: query

SAS Token

Jest to token sygnatury dostępu współdzielonego tworzony na podstawie operacji list sygnatur dostępu współdzielonego na zasobie Azure Maps za pośrednictwem płaszczyzny zarządzania platformy Azure za pośrednictwem Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów AZURE SDK lub interfejsów API REST.

Dzięki temu tokenowi każda aplikacja jest autoryzowana do uzyskiwania dostępu za pomocą kontroli dostępu opartej na rolach platformy Azure oraz szczegółowej kontroli wygaśnięcia, szybkości i regionów użycia dla określonego tokenu. Innymi słowy, token SAS może służyć do umożliwienia aplikacjom kontrolowania dostępu w sposób bardziej bezpieczny niż klucz wspólny.

W przypadku publicznie uwidocznionych aplikacji zalecamy skonfigurowanie określonej listy dozwolonych źródeł w zasobie konta mapy w celu ograniczenia nadużyć renderowania i regularnego odnawiania tokenu SAS.

Typ: apiKey
W: header

Przykłady

Search for burger joints along a route

Przykładowe żądanie

POST https://atlas.microsoft.com/search/alongRoute/json?api-version=1.0&query=burger&maxDetourTime=1000&limit=2&openingHours=nextSevenDays

{
  "route": {
    "type": "LineString",
    "coordinates": [
      [
        -122.143035,
        47.653536
      ],
      [
        -122.187164,
        47.617556
      ],
      [
        -122.114981,
        47.570599
      ],
      [
        -122.132756,
        47.654009
      ]
    ]
  }
}

Przykładowa odpowiedź

Kod stanu:
200 
{
  "summary": {
    "query": "burger",
    "queryType": "NON_NEAR",
    "queryTime": 394,
    "numResults": 2,
    "offset": 0,
    "totalResults": 2,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "US/POI/p0/8596348",
      "score": 3.104,
      "dist": 1754.9604168059973,
      "info": "search:ta:840531000465150-US",
      "poi": {
        "name": "BURGER KING",
        "phone": "+(1)-(425)-7467508",
        "brands": [
          {
            "name": "BURGER KING"
          }
        ],
        "categorySet": [
          {
            "id": 7315015
          }
        ],
        "url": "www.burgerking.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "fast food"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "14620",
        "streetName": "NE 24th St",
        "municipalitySubdivision": "Crossroads, Bellevue",
        "municipality": "Bellevue",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle East",
        "countrySubdivisionCode": "WA",
        "postalCode": "98007",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "14620 NE 24th St, Bellevue, WA 98007",
        "localName": "Bellevue",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.63188,
        "lon": -122.14462
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.63278,
          "lon": -122.14595
        },
        "btmRightPoint": {
          "lat": 47.63098,
          "lon": -122.14329
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.63155,
            "lon": -122.14462
          }
        }
      ],
      "detourTime": -55
    },
    {
      "type": "POI",
      "id": "US/POI/p0/8596112",
      "score": 3.111,
      "dist": 161.17565489389224,
      "info": "search:ta:840531000465149-US",
      "poi": {
        "name": "BURGER KING",
        "phone": "+(1)-(425)-4535775",
        "brands": [
          {
            "name": "BURGER KING"
          }
        ],
        "categorySet": [
          {
            "id": 7315015
          }
        ],
        "url": "www.burgerking.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "fast food"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "11723",
        "streetName": "NE 8th St",
        "municipalitySubdivision": "Willburton, Bellevue",
        "municipality": "Bellevue",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle East",
        "countrySubdivisionCode": "WA",
        "postalCode": "98005",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "11723 NE 8th St, Bellevue, WA 98005",
        "localName": "Bellevue",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.61683,
        "lon": -122.18338
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.61773,
          "lon": -122.18471
        },
        "btmRightPoint": {
          "lat": 47.61593,
          "lon": -122.18205
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.61723,
            "lon": -122.1834
          }
        }
      ],
      "detourTime": 12
    }
  ]
}

Definicje

Nazwa Opis
Address

Adres wyniku
AddressRanges

Opisuje zakres adresów po obu stronach ulicy dla wyniku wyszukiwania. Uwzględniane są współrzędne dla lokalizacji początkowych i końcowych zakresu adresów.
BoundingBox

Widokport, który obejmuje wynik reprezentowany przez współrzędne w lewym górnym i prawym dolnym rogu portu widoku.
BoundingBoxCompassNotation

Pole ograniczenia lokalizacji.
Brand

Marka skojarzona z interfejsem POI
Classification

Klasyfikacja zwracanego interfejsu poi
ClassificationName

Nazwa klasyfikacji
DataSources

Sekcja opcjonalna. Identyfikatory odwołań do użycia z interfejsem API Get Search Polygon.
ElectricVehicleConnector

Rozdzielona przecinkami lista typów łączników, których można użyć do ograniczenia wyniku do stacji pojazdów elektrycznych obsługujących określone typy łączników. Kolejność elementów nie ma znaczenia. Po podaniu wielu typów łączników zostaną zwrócone tylko wyniki należące do (co najmniej) jednej z podanych list.

Dostępne typy łączników to:

  • StandardHouseholdCountrySpecific - Są to standardowe łączniki gospodarstwa domowego dla określonego regionu. Wszystkie są jednofazowe prądu zmiennego oraz standardowe napięcie i standardowy amperaż. Zobacz również: Plug & socket types - World Standards (Podłącz typy gniazd & — światowe standardy).
  • IEC62196Type1 - Łącznik typu 1 zgodnie z definicją w standardzie IEC 62196-2. Nazwany również Yazaki po oryginalnym producencie lub SAE J1772 po standardzie, który po raz pierwszy go opublikował. Najczęściej używane w połączeniu z pojedynczą fazą 120V lub do 240V pojedynczej infrastruktury fazowej.
  • IEC62196Type1CCS - Łącznik kombi oparty na typie 1 zgodnie z definicją w standardzie IEC 62196-3. Łącznik jest oparty na łączniku typu 1, zgodnie z definicją w standardzie IEC 62196-2, z dwoma dodatkowymi kontaktami prądu bezpośredniego (DC), aby umożliwić szybkie ładowanie prądu DC.
  • IEC62196Type2CableAttached - Łącznik typu 2 zgodnie z definicją w standardzie IEC 62196-2. Dostarczone jako kabel i podłączona do punktu ładowania.
  • IEC62196Type2Outlet - Łącznik typu 2 zgodnie z definicją w standardzie IEC 62196-2. Dostarczone jako gniazdo ustawione w punkcie ładowania.
  • IEC62196Type2CCS - Łącznik kombi oparty na typie 2 zgodnie z definicją w standardzie IEC 62196-3. Łącznik jest oparty na łączniku typu 2, zgodnie z definicją w standardzie IEC 62196-2, z dwoma dodatkowymi kontaktami prądu bezpośredniego (DC), aby umożliwić szybkie ładowanie prądu DC.
  • IEC62196Type3 - Łącznik typu 3 zgodnie z definicją w standardzie IEC 62196-2. Również o nazwie Scame po oryginalnym producencie. Najczęściej używane w połączeniu z maksymalnie 240V pojedynczą fazą lub do 420V trzyfazowej infrastruktury.
  • Chademo - Łącznik CHAdeMO nazwany na cześć stowarzyszenia utworzonego przez Tokyo Electric Power Company i partnerów przemysłowych. Z tego powodu jest również znany jako łącznik TEPCO. Obsługuje szybkie ładowanie prądu stałego.
  • IEC60309AC1PhaseBlue - Łącznik niebieski przemysłowy jest łącznikiem zdefiniowanym w standardzie IEC 60309. Czasami jest ona określana za pomocą kombinacji standardu, koloru i faktu, że jest to jednofazowy łącznik. Łącznik ma zwykle konfigurację "P+N+E, 6h".
  • IEC60309DCWhite - Łącznik przemysłowy Biały jest łącznikiem DC zdefiniowanym w standardzie IEC 60309.
  • Tesla - Łącznik Tesli jest regionalnie specyficzny łącznik Tesla Supercharger. Tj. odnosi się on do zastrzeżonego łącznika Tesli, czasami określanego jako Tesla Port, głównie ograniczone do Ameryka Północna lub zmodyfikowanego typu 2 (DC nad typem 2) w Europie.

Przykłady użycia:

connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached
Entity

Źródło typu jednostki pola ograniczenia. W przypadku odwrotnego geokodowania jest to zawsze równe położenie.
EntryPoint

Punkt wejścia zwracanego interfejsu poI.
EntryPointType

Typ punktu wejścia. Wartość może być główna lub pomocnicza.
ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail

Szczegóły błędu.
ErrorResponse

Odpowiedź na błąd
GeographicEntityType

Typ jednostki Geografia. Występuje tylko wtedy, gdy zażądano parametru entityType i jest dostępny.
GeoJsonLineString

Prawidłowy GeoJSON LineString typ geometrii. Aby uzyskać szczegółowe informacje, zobacz RFC 7946 .
Geometry

Informacje o kształcie geometrycznym wyniku. Występuje tylko wtedy, gdy typ == Geografia.
LatLongPairAbbreviated

Lokalizacja reprezentowana jako szerokość geograficzna i długość geograficzna przy użyciu krótkich nazw "lat" & "lon".
LocalizedMapView

Parametr View (nazywany również parametrem "region użytkownika") umożliwia wyświetlanie prawidłowych map dla określonego kraju/regionu dla spornych geopolitycznie regionów. Różne kraje/regiony mają różne widoki takich regionów, a parametr Wyświetl umożliwia aplikacji zachowanie zgodności z widokiem wymaganym przez kraj/region, który będzie obsługiwać aplikacja. Domyślnie parametr Widok jest ustawiony na wartość "Unified", nawet jeśli nie zdefiniowano go w żądaniu. Twoim zadaniem jest określenie lokalizacji użytkowników, a następnie poprawne ustawienie parametru Wyświetl dla tej lokalizacji. Alternatywnie możesz ustawić opcję "View=Auto", która zwróci dane mapy na podstawie adresu IP żądania. Parametr View w Azure Maps musi być używany zgodnie z obowiązującymi przepisami, w tym z przepisami dotyczącymi mapowania, kraju/regionu, w którym udostępniane są mapy, obrazy i inne dane oraz zawartość innych firm, do których masz uprawnienia dostępu za pośrednictwem Azure Maps. Przykład: view=IN.

Aby uzyskać szczegółowe informacje i wyświetlić dostępne widoki, zapoznaj się z tematem Obsługiwane widoki .
MatchType

Typy dopasowania dla operacji wyszukiwania odwrotnego adresu.
OperatingHours

Godziny otwarcia punktu zakupu (punkty orientacyjne).
OperatingHoursRange

Godziny operacji dla weryfikacji koncepcji (punkty orientacyjne). Dostępność godzin pracy będzie się różnić w zależności od dostępnych danych. Jeśli nie upłynął, nie zostaną zwrócone żadne informacje o godzinach otwarcia. Obsługiwana wartość: nextSevenDays
OperatingHoursTime

Reprezentuje datę i godzinę
OperatingHoursTimeRange

Otwarty zakres czasu dla dnia
PointOfInterest

Szczegóły zwróconego interfejsu użytkownika, w tym informacje, takie jak nazwa, telefon, adres URL i klasyfikacje.
PointOfInterestCategorySet

Kategoria poi
QueryType

Zwracany typ zapytania: NEARBY lub NON_NEAR.
ResponseFormat

Żądany format odpowiedzi. Wartość może być json lub xml.
SearchAddressResult

Ten obiekt jest zwracany z pomyślnych wywołań Search.
SearchAddressResultItem

Wynik obiektu odpowiedzi interfejsu API Search.
SearchAddressResultType

Jeden z:

  • UM
  • Ulica
  • Lokalizacja geograficzna
  • Adres punktu
  • Zakres adresów
  • Ulica krzyżowa
SearchAlongRouteRequest

Ten typ reprezentuje treść żądania dla usługi Search Wzdłuż trasy.
SearchSummary

Obiekt podsumowania odpowiedzi interfejsu API Search.

Address

Adres wyniku

Nazwa Typ Opis
boundingBox

BoundingBoxCompassNotation

Pole ograniczenia lokalizacji.
buildingNumber

string

Numer budynku na ulicy. PRZESTARZAŁE, zamiast tego użyj streetNumber.
country

string

nazwa kraju/regionu
countryCode

string

Kraj (Uwaga: jest to dwuliterowy kod, a nie nazwa kraju/regionu).
countryCodeISO3

string

Kod kraju ISO alfa-3
countrySecondarySubdivision

string

Powiat
countrySubdivision

string

Stan lub prowincja
countrySubdivisionCode

string

countrySubdivisionCode prefiks ( countryCode countryCode-countrySubdivisionCode ) i łącznik tworzy kod ISO 3166-2. Przykłady: TX dla Teksasu, SCT dla Szkocji i ON dla Ontario.
countrySubdivisionName

string

Pełna nazwa pierwszego poziomu hierarchii administracyjnej kraju/regionu. To pole jest wyświetlane tylko w przypadku, gdy countrySubdivision jest prezentowana w skróconej formie. Obsługiwane tylko dla Stanów Zjednoczonych, Kanady i Wielkiej Brytanii.
countryTertiarySubdivision

string

Nazwany obszar
crossStreet

string

Nazwa ulicy, która jest przekraczana.
extendedPostalCode

string

Rozszerzony kod pocztowy (dostępność jest zależna od regionu).
freeformAddress

string

Wiersz adresu sformatowany zgodnie z regułami formatowania kraju/regionu wynikowego pochodzenia lub w przypadku kraju/regionu pełna nazwa kraju/regionu.
localName

string

Składnik adresu, który reprezentuje nazwę obszaru geograficznego lub lokalizacji, który grupuje wiele obiektów adresowalnych do celów adresowania, bez jednostki administracyjnej. To pole służy do kompilowania freeformAddress właściwości. localName reprezentuje gminę pocztową. W zależności od lokalizacji localName jest powszechnie znaną nazwą miasta lub miasta. Dla powszechnie znanej nazwy miasta lub miasta należy użyć localName zamiast municipality.
municipality

string

Miasto /Miasto
Uwaga: municipality reprezentuje gminę mieszkalną. W zależności od lokalizacji municipality wartość może się różnić od powszechnie znanej nazwy miasta lub miasta. W przypadku powszechnie znanej nazwy miasta lub miasta sugerowane jest, aby localName wartość była używana zamiast municipality wartości.
municipalitySubdivision

string

Sub / Super City
neighbourhood

string

Dzielnica jest geograficznie zlokalizowanym obszarem w mieście lub mieście z charakterystycznymi cechami i interakcjami społecznymi między mieszkańcami.
postalCode

string

Kod pocztowy/kod pocztowy
routeNumbers

string[]

Kody używane do jednoznacznej identyfikacji ulicy
street

string

Nazwa ulicy. PRZESTARZAŁE, zamiast tego użyj nazwy streetName.
streetName

string

Nazwa ulicy.
streetNameAndNumber

string

Nazwa ulicy i numer.
streetNumber

string

Numer budynku na ulicy.

AddressRanges

Opisuje zakres adresów po obu stronach ulicy dla wyniku wyszukiwania. Uwzględniane są współrzędne dla lokalizacji początkowych i końcowych zakresu adresów.

Nazwa Typ Opis
from

LatLongPairAbbreviated

Lokalizacja reprezentowana jako szerokość geograficzna i długość geograficzna przy użyciu krótkich nazw "lat" & "lon".
rangeLeft

string

Zakres adresów po lewej stronie ulicy.
rangeRight

string

Zakres adresów po prawej stronie ulicy.
to

LatLongPairAbbreviated

Lokalizacja reprezentowana jako szerokość geograficzna i długość geograficzna przy użyciu krótkich nazw "lat" & "lon".

BoundingBox

Widokport, który obejmuje wynik reprezentowany przez współrzędne w lewym górnym i prawym dolnym rogu portu widoku.

Nazwa Typ Opis
btmRightPoint

LatLongPairAbbreviated

Lokalizacja reprezentowana jako szerokość geograficzna i długość geograficzna przy użyciu krótkich nazw "lat" & "lon".
topLeftPoint

LatLongPairAbbreviated

Lokalizacja reprezentowana jako szerokość geograficzna i długość geograficzna przy użyciu krótkich nazw "lat" & "lon".

BoundingBoxCompassNotation

Pole ograniczenia lokalizacji.

Nazwa Typ Opis
entity

Entity

Źródło typu jednostki pola ograniczenia. W przypadku odwrotnego geokodowania jest to zawsze równe położenie.
northEast

string

Szerokość geograficzna północno-wschodnia,współrzędna geograficzna pola ograniczenia jako rozdzielane przecinkami zmiennoprzecinkowe
southWest

string

Szerokość geograficzna południowo-zachodnia,współrzędna geograficzna pola ograniczenia jako rozdzielane przecinkami zmiennoprzecinkowe

Brand

Marka skojarzona z interfejsem POI

Nazwa Typ Opis
name

string

Nazwa marki

Classification

Klasyfikacja zwracanego interfejsu poi

Nazwa Typ Opis
code

string

Właściwość Code
names

ClassificationName[]

Tablica nazw

ClassificationName

Nazwa klasyfikacji

Nazwa Typ Opis
name

string

Name — Właściwość
nameLocale

string

Nazwa właściwości Ustawienia regionalne

DataSources

Sekcja opcjonalna. Identyfikatory odwołań do użycia z interfejsem API Get Search Polygon.

Nazwa Typ Opis
geometry

Geometry

Informacje o kształcie geometrycznym wyniku. Występuje tylko wtedy, gdy typ == Geografia.

ElectricVehicleConnector

Rozdzielona przecinkami lista typów łączników, których można użyć do ograniczenia wyniku do stacji pojazdów elektrycznych obsługujących określone typy łączników. Kolejność elementów nie ma znaczenia. Po podaniu wielu typów łączników zostaną zwrócone tylko wyniki należące do (co najmniej) jednej z podanych list.

Dostępne typy łączników to:

  • StandardHouseholdCountrySpecific - Są to standardowe łączniki gospodarstwa domowego dla określonego regionu. Wszystkie są jednofazowe prądu zmiennego oraz standardowe napięcie i standardowy amperaż. Zobacz również: Plug & socket types - World Standards (Podłącz typy gniazd & — światowe standardy).
  • IEC62196Type1 - Łącznik typu 1 zgodnie z definicją w standardzie IEC 62196-2. Nazwany również Yazaki po oryginalnym producencie lub SAE J1772 po standardzie, który po raz pierwszy go opublikował. Najczęściej używane w połączeniu z pojedynczą fazą 120V lub do 240V pojedynczej infrastruktury fazowej.
  • IEC62196Type1CCS - Łącznik kombi oparty na typie 1 zgodnie z definicją w standardzie IEC 62196-3. Łącznik jest oparty na łączniku typu 1, zgodnie z definicją w standardzie IEC 62196-2, z dwoma dodatkowymi kontaktami prądu bezpośredniego (DC), aby umożliwić szybkie ładowanie prądu DC.
  • IEC62196Type2CableAttached - Łącznik typu 2 zgodnie z definicją w standardzie IEC 62196-2. Dostarczone jako kabel i podłączona do punktu ładowania.
  • IEC62196Type2Outlet - Łącznik typu 2 zgodnie z definicją w standardzie IEC 62196-2. Dostarczone jako gniazdo ustawione w punkcie ładowania.
  • IEC62196Type2CCS - Łącznik kombi oparty na typie 2 zgodnie z definicją w standardzie IEC 62196-3. Łącznik jest oparty na łączniku typu 2, zgodnie z definicją w standardzie IEC 62196-2, z dwoma dodatkowymi kontaktami prądu bezpośredniego (DC), aby umożliwić szybkie ładowanie prądu DC.
  • IEC62196Type3 - Łącznik typu 3 zgodnie z definicją w standardzie IEC 62196-2. Również o nazwie Scame po oryginalnym producencie. Najczęściej używane w połączeniu z maksymalnie 240V pojedynczą fazą lub do 420V trzyfazowej infrastruktury.
  • Chademo - Łącznik CHAdeMO nazwany na cześć stowarzyszenia utworzonego przez Tokyo Electric Power Company i partnerów przemysłowych. Z tego powodu jest również znany jako łącznik TEPCO. Obsługuje szybkie ładowanie prądu stałego.
  • IEC60309AC1PhaseBlue - Łącznik niebieski przemysłowy jest łącznikiem zdefiniowanym w standardzie IEC 60309. Czasami jest ona określana za pomocą kombinacji standardu, koloru i faktu, że jest to jednofazowy łącznik. Łącznik ma zwykle konfigurację "P+N+E, 6h".
  • IEC60309DCWhite - Łącznik przemysłowy Biały jest łącznikiem DC zdefiniowanym w standardzie IEC 60309.
  • Tesla - Łącznik Tesli jest regionalnie specyficzny łącznik Tesla Supercharger. Tj. odnosi się on do zastrzeżonego łącznika Tesli, czasami określanego jako Tesla Port, głównie ograniczone do Ameryka Północna lub zmodyfikowanego typu 2 (DC nad typem 2) w Europie.

Przykłady użycia:

connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached

Nazwa Typ Opis
Chademo

string

Łącznik CHAdeMO nazwany na cześć stowarzyszenia utworzonego przez Tokyo Electric Power Company i partnerów przemysłowych. Z tego powodu jest również znany jako łącznik TEPCO. Obsługuje szybkie ładowanie prądu stałego.
IEC60309AC1PhaseBlue

string

Łącznik Industrial Blue jest łącznikiem zdefiniowanym w standardzie IEC 60309. Czasami jest ona określana za pomocą kombinacji standardu, koloru i faktu, że jest to jednofazowy łącznik. Łącznik ma zwykle konfigurację "P+N+E, 6h".
IEC60309DCWhite

string

Łącznik Industrial White jest łącznikiem DC zdefiniowanym w standardzie IEC 60309.
IEC62196Type1

string

Łącznik typu 1 zgodnie z definicją w standardzie IEC 62196-2. Nazwany również Yazaki po oryginalnym producencie lub SAE J1772 po standardzie, który po raz pierwszy go opublikował. Najczęściej używane w połączeniu z pojedynczą fazą 120V lub do 240V pojedynczej infrastruktury fazowej.
IEC62196Type1CCS

string

Łącznik kombi oparty na typie 1 zgodnie z definicją w standardzie IEC 62196-3. Łącznik jest oparty na łączniku typu 1, zgodnie z definicją w standardzie IEC 62196-2, z dwoma dodatkowymi kontaktami prądu bezpośredniego (DC), aby umożliwić szybkie ładowanie prądu DC.
IEC62196Type2CCS

string

Łącznik kombi oparty na typie 2 zgodnie z definicją w standardzie IEC 62196-3. Łącznik jest oparty na łączniku typu 2, zgodnie z definicją w standardzie IEC 62196-2, z dwoma dodatkowymi kontaktami prądu bezpośredniego (DC), aby umożliwić szybkie ładowanie prądu DC.
IEC62196Type2CableAttached

string

Łącznik typu 2 zgodnie z definicją w standardzie IEC 62196-2. Dostarczone jako kabel i podłączona do punktu ładowania
IEC62196Type2Outlet

string

Łącznik typu 2 zgodnie z definicją w standardzie IEC 62196-2. Dostarczone jako gniazdo ustawione w punkcie ładowania.
IEC62196Type3

string

Łącznik typu 3 zgodnie z definicją w standardzie IEC 62196-2. Również o nazwie Scame po oryginalnym producencie. Najczęściej używane w połączeniu z maksymalnie 240V pojedynczą fazą lub do 420V trzyfazowej infrastruktury.
StandardHouseholdCountrySpecific

string

Są to standardowe łączniki gospodarstwa domowego dla określonego regionu. Wszystkie są jednofazowe prądu zmiennego oraz standardowe napięcie i standardowy amperaż.

Zobacz również: Plug & socket types - World Standards
Tesla

string

Łącznik Tesli jest regionalnym łącznikiem Tesla Supercharger. Tj. odnosi się on do zastrzeżonego łącznika Tesli, czasami określanego jako Tesla Port, głównie ograniczone do Ameryka Północna lub zmodyfikowanego typu 2 (DC nad typem 2) w Europie.

Entity

Źródło typu jednostki pola ograniczenia. W przypadku odwrotnego geokodowania jest to zawsze równe położenie.

Nazwa Typ Opis
position

string

Pozycja jednostki

EntryPoint

Punkt wejścia zwracanego interfejsu poI.

Nazwa Typ Opis
position

LatLongPairAbbreviated

Lokalizacja reprezentowana jako szerokość geograficzna i długość geograficzna przy użyciu krótkich nazw "lat" & "lon".
type

EntryPointType

Typ punktu wejścia. Wartość może być główna lub pomocnicza.

EntryPointType

Typ punktu wejścia. Wartość może być główna lub pomocnicza.

Nazwa Typ Opis
main

string

minor

string

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.
type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.
code

string

Kod błędu.
details

ErrorDetail[]

Szczegóły błędu.
message

string

Komunikat o błędzie.
target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt error.

GeographicEntityType

Typ jednostki Geografia. Występuje tylko wtedy, gdy zażądano parametru entityType i jest dostępny.

Nazwa Typ Opis
Country

string

nazwa kraju/regionu
CountrySecondarySubdivision

string

Powiat
CountrySubdivision

string

Stan lub prowincja
CountryTertiarySubdivision

string

Nazwany obszar
Municipality

string

Miasto/Miasto
MunicipalitySubdivision

string

Sub/Super City
Neighbourhood

string

Sąsiedztwa
PostalCodeArea

string

Kod pocztowy/kod pocztowy

GeoJsonLineString

Prawidłowy GeoJSON LineString typ geometrii. Aby uzyskać szczegółowe informacje, zobacz RFC 7946 .

Nazwa Typ Opis
coordinates

number[]

Współrzędne geometrii GeoJson LineString .
type string:

LineString

Określa GeoJSON typ. Musi być jednym z dziewięciu prawidłowych typów obiektów GeoJSON — Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature i FeatureCollection.

Geometry

Informacje o kształcie geometrycznym wyniku. Występuje tylko wtedy, gdy typ == Geografia.

Nazwa Typ Opis
id

string

Przekaż ten identyfikator geometryId do interfejsu API get Search Polygon, aby pobrać informacje o geometrii dla tego wyniku.

LatLongPairAbbreviated

Lokalizacja reprezentowana jako szerokość geograficzna i długość geograficzna przy użyciu krótkich nazw "lat" & "lon".

Nazwa Typ Opis
lat

number

Właściwość Szerokość geograficzna
lon

number

Właściwość Długość geograficzna

LocalizedMapView

Parametr View (nazywany również parametrem "region użytkownika") umożliwia wyświetlanie prawidłowych map dla określonego kraju/regionu dla spornych geopolitycznie regionów. Różne kraje/regiony mają różne widoki takich regionów, a parametr Wyświetl umożliwia aplikacji zachowanie zgodności z widokiem wymaganym przez kraj/region, który będzie obsługiwać aplikacja. Domyślnie parametr Widok jest ustawiony na wartość "Unified", nawet jeśli nie zdefiniowano go w żądaniu. Twoim zadaniem jest określenie lokalizacji użytkowników, a następnie poprawne ustawienie parametru Wyświetl dla tej lokalizacji. Alternatywnie możesz ustawić opcję "View=Auto", która zwróci dane mapy na podstawie adresu IP żądania. Parametr View w Azure Maps musi być używany zgodnie z obowiązującymi przepisami, w tym z przepisami dotyczącymi mapowania, kraju/regionu, w którym udostępniane są mapy, obrazy i inne dane oraz zawartość innych firm, do których masz uprawnienia dostępu za pośrednictwem Azure Maps. Przykład: view=IN.

Aby uzyskać szczegółowe informacje i wyświetlić dostępne widoki, zapoznaj się z tematem Obsługiwane widoki .

Nazwa Typ Opis
AE

string

Zjednoczone Emiraty Arabskie (widok arabski)
AR

string

Argentyna (widok argentyński)
Auto

string

Zwróć dane mapy na podstawie adresu IP żądania.
BH

string

Bahrajn (widok arabski)
IN

string

Indie (Widok indyjski)
IQ

string

Irak (widok arabski)
JO

string

Jordania (widok arabski)
KW

string

Kuwejt (widok arabski)
LB

string

Liban (widok arabski)
MA

string

Maroko (widok marokański)
OM

string

Oman (widok arabski)
PK

string

Pakistan (Pakistani View)
PS

string

Autonomia Palestyńska (widok arabski)
QA

string

Katar (widok arabski)
SA

string

Arabia Saudyjska (widok arabski)
SY

string

Syria (widok arabski)
Unified

string

Ujednolicony widok (inne)
YE

string

Jemen (widok arabski)

MatchType

Typy dopasowania dla operacji wyszukiwania odwrotnego adresu.

Nazwa Typ Opis
AddressPoint

string

HouseNumberRange

string

Street

string

OperatingHours

Godziny otwarcia punktu zakupu (punkty orientacyjne).

Nazwa Typ Opis
mode

string

Wartość używana w żądaniu: none lub "nextSevenDays"
timeRanges

OperatingHoursTimeRange[]

Lista zakresów czasu dla następnych 7 dni

OperatingHoursRange

Godziny operacji dla weryfikacji koncepcji (punkty orientacyjne). Dostępność godzin pracy będzie się różnić w zależności od dostępnych danych. Jeśli nie upłynął, nie zostaną zwrócone żadne informacje o godzinach otwarcia. Obsługiwana wartość: nextSevenDays

Nazwa Typ Opis
nextSevenDays

string

Pokazuje godziny operacji dla następnego tygodnia, począwszy od bieżącego dnia w czasie lokalnym interfejsu użytkownika.

OperatingHoursTime

Reprezentuje datę i godzinę

Nazwa Typ Opis
date

string

Reprezentuje bieżącą datę kalendarza w strefie czasowej poi, np. "2019-02-07".
hour

integer

Godziny są w formacie 24 godziny w czasie lokalnym poi; możliwe wartości to 0–23.
minute

integer

Minuty są w czasie lokalnym interfejsu użytkownika; możliwe wartości to 0–59.

OperatingHoursTimeRange

Otwarty zakres czasu dla dnia

Nazwa Typ Opis
endTime

OperatingHoursTime

Punkt w ciągu najbliższych 7 dni, gdy dany poi jest zamykany, lub początek zakresu, jeśli został zamknięty przed zakresem.
startTime

OperatingHoursTime

Punkt w ciągu najbliższych 7 dni od otwarcia danego punktu zakupu lub początku zakresu, jeśli został otwarty przed zakresem.

PointOfInterest

Szczegóły zwróconego interfejsu użytkownika, w tym informacje, takie jak nazwa, telefon, adres URL i klasyfikacje.

Nazwa Typ Opis
brands

Brand[]

Tablica marek. Nazwa marki zwracanej przez weryfikację koncepcji.
categories

string[]

Tablica kategorii
categorySet

PointOfInterestCategorySet[]

Lista najbardziej określonych kategorii poi
classifications

Classification[]

Tablica klasyfikacji
name

string

Nazwa właściwości POI
openingHours

OperatingHours

Godziny otwarcia dla weryfikacji koncepcji (punkty orientacyjne).
phone

string

Właściwość numeru telefonu
url

string

Właściwość adresu URL witryny sieci Web

PointOfInterestCategorySet

Kategoria poi

Nazwa Typ Opis
id

integer

Identyfikator kategorii

QueryType

Zwracany typ zapytania: NEARBY lub NON_NEAR.

Nazwa Typ Opis
NEARBY

string

Search wykonano wokół określonej szerokości i długości geograficznej ze zdefiniowanym promieniem
NON_NEAR

string

Search wykonano globalnie bez uprzedzeń do określonej szerokości i długości geograficznej oraz bez zdefiniowanego promienia

ResponseFormat

Żądany format odpowiedzi. Wartość może być json lub xml.

Nazwa Typ Opis
json

string

Format wymiany danych notacji obiektów JavaScript
xml

string

The Extensible Markup Language

SearchAddressResult

Ten obiekt jest zwracany z pomyślnych wywołań Search.

Nazwa Typ Opis
results

SearchAddressResultItem[]

Lista wyników interfejsu API Search.
summary

SearchSummary

Obiekt podsumowania odpowiedzi interfejsu API Search

SearchAddressResultItem

Wynik obiektu odpowiedzi interfejsu API Search.

Nazwa Typ Opis
address

Address

Adres wyniku
addressRanges

AddressRanges

Opisuje zakres adresów po obu stronach ulicy dla wyniku wyszukiwania. Uwzględniane są współrzędne dla lokalizacji początkowej i końcowej zakresu adresów.
dataSources

DataSources

Sekcja opcjonalna. Dokumentacja identyfikatora geometrii do użycia z interfejsem API Get Search Polygon.
detourTime

integer

Czas objazdu w sekundach. Zwracane tylko w przypadku wywołań interfejsu API Search Wzdłuż trasy.
dist

number

Odległość linii prostej między wynikiem a lokalizacją geobiazy w metrach.
entityType

GeographicEntityType

Typ jednostki Geografia. Występuje tylko wtedy, gdy zażądano parametru entityType i jest dostępny.
entryPoints

EntryPoint[]

Tablica punktów wejścia. Opisują one typy wejść dostępnych w lokalizacji. Typ może być "główny" dla głównych wejść, takich jak drzwi wejściowe, lub hol, i "drobne", dla drzwi bocznych i tylnych.
id

string

Właściwość Id
info

string

Informacje o oryginalnym źródle danych wyniku. Służy do obsługi żądań pomocy technicznej.
matchType

MatchType

Informacje o typie dopasowania.

Jeden z:

  • Punkt adresu
  • HouseNumberRange
  • Ulica
poi

PointOfInterest

Szczegóły zwróconego interfejsu użytkownika, w tym informacje, takie jak nazwa, telefon, adres URL i klasyfikacje.
position

LatLongPairAbbreviated

Lokalizacja reprezentowana jako szerokość geograficzna i długość geograficzna przy użyciu krótkich nazw "lat" & "lon".
score

number

Wartość w zestawie wyników wskazująca względny wynik dopasowania między wynikami. Można użyć tej funkcji, aby określić, że wynik x jest dwa razy bardziej prawdopodobny w wyniku y, jeśli wartość x jest 2x wartością y. Wartości różnią się między zapytaniami i są przeznaczone tylko jako wartość względna dla jednego zestawu wyników.
type

SearchAddressResultType

Jeden z:

  • UM
  • Ulica
  • Lokalizacja geograficzna
  • Adres punktu
  • Zakres adresów
  • Ulica krzyżowa
viewport

BoundingBox

Port widoków, który obejmuje wynik reprezentowany przez współrzędne w lewym górnym i prawym dolnym rogu panelu widoków.

SearchAddressResultType

Jeden z:

  • UM
  • Ulica
  • Lokalizacja geograficzna
  • Adres punktu
  • Zakres adresów
  • Ulica krzyżowa
Nazwa Typ Opis
Address Range

string

Cross Street

string

Geography

string

POI

string

Point Address

string

Street

string

SearchAlongRouteRequest

Ten typ reprezentuje treść żądania dla usługi Search Wzdłuż trasy.

Nazwa Typ Opis
route

GeoJsonLineString

Prawidłowy GeoJSON LineString typ geometrii. Aby uzyskać szczegółowe informacje, zobacz RFC 7946 .

SearchSummary

Obiekt podsumowania odpowiedzi interfejsu API Search.

Nazwa Typ Opis
fuzzyLevel

integer

Maksymalny poziom rozmyty wymagany do dostarczenia wyników.
geoBias

LatLongPairAbbreviated

Wskazanie, kiedy wewnętrzna wyszukiwarka zastosowała stronniczość geoprzestrzenną, aby poprawić klasyfikację wyników. W niektórych metodach może to mieć wpływ na ustawienie parametrów lat i lon, jeśli są dostępne. W innych przypadkach jest to wyłącznie wewnętrzne.
limit

integer

Maksymalna liczba odpowiedzi, które zostaną zwrócone
numResults

integer

Liczba wyników w odpowiedzi.
offset

integer

Przesunięcie początkowe zwróconych wyników w pełnym zestawie wyników.
query

string

Parametr zapytania, który został użyty do wygenerowania tych wyników wyszukiwania.
queryTime

integer

Czas spędzony na rozpoznawaniu zapytania w milisekundach.
queryType

QueryType

Zwracany typ zapytania: NEARBY lub NON_NEAR.
totalResults

integer

Łączna liczba znalezionych wyników.