Search - Get Search Fuzzy
アドレスと POI トークンの組み合わせを処理できる検索要求が必要な場合に使用します。
Get Search Fuzzy
(Free Form Search) API。POI 検索とジオコーディングの組み合わせをシームレスに処理する HTTP GET
要求です。 これは、アドレストークンまたはPOIトークンの任意の組み合わせを含む入力のあいまいさを正規の「単一行検索」として処理する自由形式のSearch APIです。 また、コンテキスト位置 (lat/lon ペア) で重み付けしたり、座標と半径によって完全に制約したり、地理的バイアスアンカーポイントなしでより一般的に実行することもできます。
"countrySet" パラメーターを使用して、アプリケーションが対象範囲を必要とする国/地域のみを指定することを強くお勧めします。既定の動作では、全世界を検索し、不要な結果が返される可能性があります。
例: countrySet
=US,FR
サポートされているすべての国/地域の完全な一覧については、「Searchカバレッジ」を参照してください。
ほとんどのSearchクエリの既定値は =2 でmaxFuzzyLevel
、パフォーマンスを向上させ、通常とは異なる結果を減らします。 この新しい既定値は、クエリ パラメーター maxFuzzyLevel
=3 または 4 を渡すことによって、要求ごとに必要に応じてオーバーライドできます。
GET https://atlas.microsoft.com/search/fuzzy/{format}?api-version=1.0&query={query}
GET https://atlas.microsoft.com/search/fuzzy/{format}?api-version=1.0&query={query}&typeahead={typeahead}&limit={limit}&ofs={ofs}&categorySet={categorySet}&countrySet={countrySet}&lat={lat}&lon={lon}&radius={radius}&topLeft={topLeft}&btmRight={btmRight}&language={language}&extendedPostalCodesFor={extendedPostalCodesFor}&minFuzzyLevel={minFuzzyLevel}&maxFuzzyLevel={maxFuzzyLevel}&idxSet={idxSet}&brandSet={brandSet}&connectorSet={connectorSet}&entityType={entityType}&view={view}&openingHours=nextSevenDays
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
format
|
path | True |
応答の目的の形式。 値には json または xml を指定できます。 |
|
api-version
|
query | True |
string |
Azure Maps API のバージョン番号。 |
query
|
query | True |
string |
該当するクエリ文字列 (例: "seattle"、"pizza")。 緯度と経度で構成されるコンマ区切りの文字列 (例: "47.641268, -122.125679") として指定 することもできます 。 URL が正しくエンコードされている必要があります。 |
brand
|
query |
string[] |
結果を特定のブランドに制限するために使用できるブランド名のコンマ区切りのリスト。 項目の順序は関係ありません。 複数のブランドが提供されている場合は、指定されたリストの 1 つに属する (少なくとも) 結果のみが返されます。 名前に "," を含むブランドは引用符で囲む必要があります。 使用例: brandSet=Foo brandSet=Foo,Bar brandSet="A,B,C コンマ",Bar |
|
btm
|
query |
string |
境界ボックスの右下の位置。 例: 37.553、-122.453 |
|
category
|
query |
integer[] |
結果を特定のポイント オブ インタレスト カテゴリに制限するために使用できるカテゴリ セット ID のコンマ区切りリスト。 ID の順序は重要ではありません。 要求ごとにサポートされる値の
|
|
connector
|
query |
特定のコネクタの種類をサポートする電気自動車ステーションに結果を制限するために使用できるコネクタの種類のコンマ区切りのリスト。 項目の順序は関係ありません。 複数のコネクタの種類が指定されている場合は、指定されたリストの 1 つ (少なくとも) に属する結果のみが返されます。 使用可能なコネクタの種類は次のとおりです。
使用例: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
||
country
|
query |
string[] |
国/地域コードのコンマ区切り文字列 (FR、ES など)。 これにより、指定した国/地域に検索が制限されます |
|
entity
|
query |
地理に対して実行されるフィルター処理のレベルを指定します。 指定した geography エンティティ型の検索を絞り込みます。たとえば、市区町村のみを返します。 結果の応答には、geography ID および一致したエンティティ型が含まれます。 コンマ区切りリストとして複数のエンティティを指定した場合、エンドポイントは "使用可能な最小エンティティ" を返します。 返された Geometry ID を使用すると、Get Search Polygon API を使用してその地理のジオメトリを取得できます。 entityType が設定されている場合、次のパラメーターは無視されます。
|
||
extended
|
query |
結果に拡張郵便番号を含める必要があるインデックス。 使用可能なインデックスは次のとおりです。 Addr = アドレス範囲 Geo = Geographies PAD = ポイント アドレス POI = 関心のあるポイント Str = Streets XStr = クロス ストリート (交差) 値は、インデックスの種類のコンマ区切りのリスト (任意の順序) またはインデックスがない場合 は None にする必要があります。 既定では、Geo を除くすべてのインデックスに拡張郵便番号が含まれます。 地域の拡張郵便番号リストは非常に長い場合があるため、必要に応じて明示的に要求する必要があります。 使用例: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None 拡張郵便番号は、住所の extendedPostalCode プロパティとして返されます。 可用性はリージョンによって異なります。 |
||
idx
|
query |
検索に使用する必要があるインデックスのコンマ区切りリスト。 項目の順序は関係ありません。 使用可能なインデックスは次のとおりです。Addr = アドレス範囲補間、Geo = Geographies、PAD = Point Addresses、POI = Points of interest、Str = Streets、Xstr = Cross Streets (交差) |
||
language
|
query |
string |
検索結果を返す言語。 サポートされている IETF 言語タグの 1 つである必要があります。大文字と小文字は区別されません。 指定した言語のデータが特定のフィールドで使用できない場合は、既定の言語が使用されます。 詳細については、「 サポートされている言語 」を参照してください。 |
|
lat
|
query |
number double |
結果が偏る緯度。 例: 37.337 |
|
limit
|
query |
integer |
返される応答の最大数。 既定値: 10、最小: 1、最大: 100 |
|
lon
|
query |
number double |
結果を偏る必要がある経度。 例: -121.89 |
|
max
|
query |
integer |
使用する最大めまいレベル。 既定値: 2、最小: 1、最大: 4
検索エンジンは、minFuzzyLevel によって定義されたレベルで一致する検索を開始し、maxFuzzyLevel で指定されたレベルで検索を停止します。 |
|
min
|
query |
integer |
使用する最小ファジーレベル。 既定値: 1、最小: 1、最大: 4
検索エンジンは、minFuzzyLevel によって定義されたレベルで一致する検索を開始し、maxFuzzyLevel で指定されたレベルで検索を停止します。 |
|
ofs
|
query |
integer |
完全な結果セット内の返された結果の開始オフセット。 既定値は0 |
|
opening
|
query |
POI (ポイント オブ インタレスト) の操作時間。 操作時間の可用性は、使用可能なデータによって異なります。 渡されない場合、営業時間情報は返されません。 サポートされている値: nextSevenDays |
||
radius
|
query |
integer |
結果を定義された領域に制限するための半径 (メートル単位) |
|
top
|
query |
string |
境界ボックスの左上の位置。 例: 37.553、-122.453 |
|
typeahead
|
query |
boolean |
ブール型。 typeahead フラグが設定されている場合、クエリは部分的な入力として解釈され、検索は予測モードになります |
|
view
|
query |
View パラメーター ("user region" パラメーターとも呼ばれます) を使用すると、地政学的に紛争が発生している地域の特定の国/地域の正しいマップを表示できます。 このようなリージョンのビューは国や地域によって異なり、View パラメーターを使用すると、アプリケーションが提供する国/地域に必要なビューにアプリケーションを準拠できます。 既定では、要求で定義していない場合でも、View パラメーターは "Unified" に設定されます。 ユーザーの場所を特定し、その場所を正しく View パラメーターを設定するのはユーザーの責任です。 または、要求の IP アドレスに基づいてマップ データを返す 'View = Auto' を設定することもできます。 Azure Mapsの View パラメーターは、マップ、画像、その他のデータ、Azure Maps経由でアクセスする権限を持つ第三者のコンテンツが利用可能になる国/地域のマッピングに関する法律を含む、適用される法律に準拠して使用する必要があります。 例: view=IN。 詳細については、「 サポートされているビュー 」を参照し、使用可能なビューを参照してください。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID セキュリティ モデルと組み合わせて使用するアカウントを指定します。 Azure Maps アカウントの一意の ID を表し、Azure Maps管理プレーン アカウント API から取得できます。 Azure MapsでMicrosoft Entra IDセキュリティを使用するには、ガイダンスについては、次の記事を参照してください。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
予期しないエラーが発生しました。 |
セキュリティ
AADToken
これらは OAuth 2.0 フロー Microsoft Entraです。 Azure ロールベースのアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上のAzure Mapsリソース アカウントまたはサブリソースへのアクセスを指定するために使用されます。 REST API をAzure Mapsするための 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、ユーザー、グループ、またはサービス プリンシパルにアクセス権を付与できます。
シナリオを実装するには、 認証の概念を表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。
注意
- このセキュリティ定義では、 ヘッダーを使用して、
x-ms-client-id
アプリケーションがアクセスを要求しているリソースAzure Maps示す必要があります。 これは、 Maps 管理 API から取得できます。 - は
Authorization URL
、Azure パブリック クラウド インスタンスに固有です。 ソブリン クラウドには、固有の承認 URL とMicrosoft Entra ID構成があります。 - Azure ロールベースのアクセス制御は、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンから構成されます。
- Azure Maps Web SDK を使用すると、複数のユース ケースに対するアプリケーションの構成ベースのセットアップが可能になります。
- Microsoft ID プラットフォームの詳細については、「Microsoft ID プラットフォームの概要」を参照してください。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
これは、Azure portalでAzure Maps アカウントを作成するとき、または PowerShell、CLI、Azure SDK、または REST API を使用してプロビジョニングされる共有キーです。
このキーを使用すると、すべてのアプリケーションですべての REST API にアクセスできます。 つまり、このキーは、発行先のアカウントのマスター キーとして使用できます。
公開されているアプリケーションの場合は、機密クライアント アプリケーション のアプローチを使用して、キーを安全に格納できるように、Azure Maps REST API にアクセスすることをお勧めします。
型:
apiKey
/:
query
SAS Token
これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンを介して、Azure Maps リソースの List SAS 操作から作成される共有アクセス署名トークンです。
このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンに対するきめ細かい制御が許可されます。 言い換えると、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できます。
公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定のリストを構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。
型:
apiKey
/:
header
例
Search City Seattle
要求のサンプル
GET https://atlas.microsoft.com/search/fuzzy/json?api-version=1.0&query=seattle&openingHours=nextSevenDays
応答のサンプル
{
"summary": {
"query": "seattle",
"queryType": "NON_NEAR",
"queryTime": 66,
"numResults": 10,
"offset": 0,
"totalResults": 3720,
"fuzzyLevel": 1
},
"results": [
{
"type": "Geography",
"id": "US/GEO/p0/188055",
"score": 2.531,
"entityType": "Municipality",
"address": {
"municipality": "Seattle",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle",
"countrySubdivisionCode": "WA",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Seattle, WA",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.60323,
"lon": -122.33028
},
"viewport": {
"topLeftPoint": {
"lat": 47.7344,
"lon": -122.4594
},
"btmRightPoint": {
"lat": 47.48106,
"lon": -122.22497
}
},
"dataSources": {
"geometry": {
"id": "00005557-4100-3c00-0000-0000596ae8ed"
}
}
},
{
"type": "Geography",
"id": "US/GEO/p0/183911",
"score": 2.382,
"entityType": "Municipality",
"address": {
"municipality": "Seattle",
"countrySecondarySubdivision": "King",
"countrySubdivisionCode": "WA",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Seattle, WA",
"countrySubdivisionName": "Washington"
},
"position": {
"lat": 47.55342,
"lon": -122.25007
},
"viewport": {
"topLeftPoint": {
"lat": 47.58995,
"lon": -122.26723
},
"btmRightPoint": {
"lat": 47.5169,
"lon": -122.23291
}
},
"dataSources": {
"geometry": {
"id": "00005557-4100-3c00-0000-00006553f33d"
}
}
},
{
"type": "POI",
"id": "ZA/POI/p0/449288",
"score": 2.226,
"info": "search:ta:710009004165863-ZA",
"poi": {
"name": "Seattle Coffee Co - Groote Kerk Sentrum",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetName": "Kloof Street",
"municipalitySubdivision": "Cape Town",
"municipality": "Cape Town",
"countrySecondarySubdivision": "City of Cape Town",
"countrySubdivisionCode": "Western Cape",
"postalCode": "8001",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Kloof Street, Gardens, City of Cape Town, Western Cape, 8001",
"localName": "Gardens"
},
"position": {
"lat": -33.92917,
"lon": 18.41178
},
"viewport": {
"topLeftPoint": {
"lat": -33.92827,
"lon": 18.4107
},
"btmRightPoint": {
"lat": -33.93007,
"lon": 18.41286
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -33.92907,
"lon": 18.41162
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/449396",
"score": 2.226,
"info": "search:ta:710009004163591-ZA",
"poi": {
"name": "Seattle Coffee Co - Pietermaritzburg",
"phone": "+(27)-(33)-3458486",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetNumber": "9",
"streetName": "Armitage Road",
"municipalitySubdivision": "Pietermaritzburg City, Pietermaritzburg",
"municipality": "Pietermaritzburg",
"countrySecondarySubdivision": "The Msunduzi",
"countrySubdivisionCode": "KwaZulu-Natal",
"postalCode": "3201",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Armitage Road 9, Athlone, The Msunduzi, KwaZulu-Natal, 3201",
"localName": "Athlone"
},
"position": {
"lat": -29.58611,
"lon": 30.37508
},
"viewport": {
"topLeftPoint": {
"lat": -29.58521,
"lon": 30.37405
},
"btmRightPoint": {
"lat": -29.58701,
"lon": 30.37611
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -29.58668,
"lon": 30.37531
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/451868",
"score": 2.226,
"info": "search:ta:710009002195538-ZA",
"poi": {
"name": "Seattle Coffee Co - Bedford Village",
"phone": "+(27)-(84)-5451111",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetName": "Van Buuren Road",
"municipalitySubdivision": "Bedfordview",
"municipality": "Germiston",
"countrySecondarySubdivision": "Ekurhuleni",
"countrySubdivisionCode": "Gauteng",
"postalCode": "2007",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Van Buuren Road, Bedfordview, Ekurhuleni, Gauteng, 2007",
"localName": "Bedfordview"
},
"position": {
"lat": -26.18009,
"lon": 28.13544
},
"viewport": {
"topLeftPoint": {
"lat": -26.17919,
"lon": 28.13444
},
"btmRightPoint": {
"lat": -26.18099,
"lon": 28.13644
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -26.18006,
"lon": 28.13636
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/488888",
"score": 2.226,
"info": "search:ta:710009002102639-ZA",
"poi": {
"name": "Seattle Coffee Co - Caltex Starstop Milly's",
"phone": "+(27)-(13)-2560340",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"municipality": "Wonderfontein",
"countrySecondarySubdivision": "Emakhazeni",
"countrySubdivisionCode": "Mpumalanga",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Wonderfontein, Emakhazeni, Mpumalanga"
},
"position": {
"lat": -25.68842,
"lon": 30.21291
},
"viewport": {
"topLeftPoint": {
"lat": -25.68752,
"lon": 30.21191
},
"btmRightPoint": {
"lat": -25.68932,
"lon": 30.21391
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -25.68913,
"lon": 30.21343
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/489433",
"score": 2.226,
"info": "search:ta:710009002184068-ZA",
"poi": {
"name": "Seattle Coffee Co - Southcoast Mall",
"phone": "+(27)-(39)-3150816",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"municipalitySubdivision": "Shelly Beach",
"municipality": "Shelly Beach",
"countrySecondarySubdivision": "Hibiscus Coast",
"countrySubdivisionCode": "KwaZulu-Natal",
"postalCode": "4265",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Shelly Beach, Hibiscus Coast, KwaZulu-Natal, 4265",
"localName": "Shelly Beach"
},
"position": {
"lat": -30.79937,
"lon": 30.40569
},
"viewport": {
"topLeftPoint": {
"lat": -30.79847,
"lon": 30.40464
},
"btmRightPoint": {
"lat": -30.80027,
"lon": 30.40674
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -30.7994,
"lon": 30.40618
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/489976",
"score": 2.226,
"info": "search:ta:710009004261897-ZA",
"poi": {
"name": "Seattle Cofee Co",
"phone": "+(27)-(39)-3150816",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"municipalitySubdivision": "Shelly Beach",
"municipality": "Shelly Beach",
"countrySecondarySubdivision": "Hibiscus Coast",
"countrySubdivisionCode": "KwaZulu-Natal",
"postalCode": "4265",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Shelly Beach, Hibiscus Coast, KwaZulu-Natal, 4265",
"localName": "Shelly Beach"
},
"position": {
"lat": -30.79801,
"lon": 30.40557
},
"viewport": {
"topLeftPoint": {
"lat": -30.79711,
"lon": 30.40452
},
"btmRightPoint": {
"lat": -30.79891,
"lon": 30.40662
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -30.79784,
"lon": 30.40523
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/490056",
"score": 2.226,
"info": "search:ta:710009004149612-ZA",
"poi": {
"name": "Seattle Coffee Co - Constantia Village",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetName": "Constantia Main Road",
"municipalitySubdivision": "Cape Town",
"municipality": "Cape Town",
"countrySecondarySubdivision": "City of Cape Town",
"countrySubdivisionCode": "Western Cape",
"postalCode": "7708",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Constantia Main Road, Constantia, City of Cape Town, Western Cape, 7708",
"localName": "Constantia"
},
"position": {
"lat": -34.02087,
"lon": 18.44503
},
"viewport": {
"topLeftPoint": {
"lat": -34.01997,
"lon": 18.44394
},
"btmRightPoint": {
"lat": -34.02177,
"lon": 18.44612
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -34.02017,
"lon": 18.44476
}
}
]
},
{
"type": "POI",
"id": "ZA/POI/p0/494340",
"score": 2.226,
"info": "search:ta:710009004152570-ZA",
"poi": {
"name": "Seattle Coffee Co - Canal Walk Shopping Centre",
"brands": [
{
"name": "Seattle Coffee Company"
}
],
"categorySet": [
{
"id": 9376006
}
],
"url": "www.seattlecoffeecompany.co.za",
"classifications": [
{
"code": "CAFE_PUB",
"names": [
{
"nameLocale": "en-US",
"name": "coffee shop"
},
{
"nameLocale": "en-US",
"name": "café/pub"
}
]
}
]
},
"address": {
"streetName": "Century Boulevard",
"municipalitySubdivision": "Milnerton",
"municipality": "Cape Town",
"countrySecondarySubdivision": "City of Cape Town",
"countrySubdivisionCode": "Western Cape",
"postalCode": "7441",
"countryCode": "ZA",
"country": "South Africa",
"countryCodeISO3": "ZAF",
"freeformAddress": "Century Boulevard, Century City, City of Cape Town, Western Cape, 7441",
"localName": "Century City"
},
"position": {
"lat": -33.89348,
"lon": 18.5122
},
"viewport": {
"topLeftPoint": {
"lat": -33.89258,
"lon": 18.51112
},
"btmRightPoint": {
"lat": -33.89438,
"lon": 18.51328
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": -33.8943,
"lon": 18.51328
}
}
]
}
]
}
定義
名前 | 説明 |
---|---|
Address |
結果のアドレス |
Address |
検索結果の通りの両側のアドレス範囲について説明します。 アドレス範囲の開始位置と終了位置の座標が含まれます。 |
Bounding |
ビューポートの左上と右下の座標で表される結果をカバーするビューポート。 |
Bounding |
場所の境界ボックス。 |
Brand |
POI に関連付けられているブランド |
Classification |
返される POI の分類 |
Classification |
分類の名前 |
Data |
省略可能なセクション。 Get Search Polygon API で使用する参照 ID。 |
Electric |
特定のコネクタの種類をサポートする電気自動車ステーションに結果を制限するために使用できるコネクタの種類のコンマ区切りのリスト。 項目の順序は関係ありません。 複数のコネクタの種類が指定されている場合は、指定されたリストの 1 つ (少なくとも) に属する結果のみが返されます。 使用可能なコネクタの種類は次のとおりです。
使用例: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
Entity |
境界ボックスのエンティティ型ソース。 逆ジオコーディングの場合、これは常に位置と等しくなります。 |
Entry |
返される POI のエントリ ポイント。 |
Entry |
エントリ ポイントの種類。 値には、メインまたはマイナーのいずれかを指定できます。 |
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Geographic |
Geography エンティティ型。 entityType が要求され、使用可能な場合にのみ表示されます。 |
Geometry |
結果の幾何学的形状に関する情報。 型 == Geography の場合にのみ存在します。 |
Lat |
短い名前 'lat' & 'lon' を使用して緯度と経度として表される場所。 |
Localized |
View パラメーター ("user region" パラメーターとも呼ばれます) を使用すると、地政学的に紛争が発生している地域の特定の国/地域の正しいマップを表示できます。 このようなリージョンのビューは国や地域によって異なります。また、View パラメーターを使用すると、アプリケーションがサービスを提供する国/地域に必要なビューにアプリケーションを準拠できます。 既定では、View パラメーターは、要求で定義していない場合でも "Unified" に設定されます。 ユーザーの場所を特定し、その場所を正しく View パラメーターを設定するのはユーザーの責任です。 または、要求の IP アドレスに基づいてマップ データを返す 'View = Auto' を設定することもできます。 Azure Mapsの View パラメーターは、マップ、画像、その他のデータ、Azure Maps経由でアクセスする権限を持つ第三者のコンテンツが利用可能になる国/地域のマッピングに関するものを含む、適用される法律に準拠して使用する必要があります。 例: view=IN。 詳細については、「 サポートされているビュー」 を参照し、使用可能なビューを参照してください。 |
Match |
逆引きアドレス検索操作の一致の種類。 |
Operating |
POI (ポイント オブ インタレスト) の営業時間。 |
Operating |
POI (ポイント オブ インタレスト) の操作時間。 操作時間の可用性は、使用可能なデータによって異なります。 渡されない場合、営業時間情報は返されません。 サポートされている値: nextSevenDays |
Operating |
日付と時刻を表します |
Operating |
1 日の時間範囲を開く |
Point |
名前、電話番号、URL アドレス、分類などの情報を含む、返される POI の詳細。 |
Point |
POI カテゴリ |
Query |
返されるクエリの種類: NEARBY または NON_NEAR。 |
Response |
応答の目的の形式。 値には json または xml のいずれかを指定できます。 |
Search |
このオブジェクトは、正常なSearch呼び出しから返されます。 |
Search |
Search API 応答の Result オブジェクト。 |
Search |
つぎのいずれかです。
|
Search |
結果に拡張郵便番号を含める必要があるインデックス。 使用可能なインデックスは次のとおりです。 Addr = アドレス範囲 Geo = Geographies PAD = ポイント アドレス POI = 目的地 Str = Streets XStr = クロス ストリート (交差点) 値は、インデックスの種類 (任意の順序) のコンマ区切りのリスト、またはインデックスがない場合は None にする必要があります。 既定では、Geo を除くすべてのインデックスに拡張郵便番号が含まれます。 地域の拡張郵便番号リストは非常に長い場合があるため、必要に応じて明示的に要求する必要があります。 使用例: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None 拡張郵便番号は、住所の extendedPostalCode プロパティとして返されます。 可用性はリージョンに依存します。 |
Search |
Search API 応答の Summary オブジェクト。 |
Address
結果のアドレス
名前 | 型 | 説明 |
---|---|---|
boundingBox |
場所の境界ボックス。 |
|
buildingNumber |
string |
通りの建物番号。 非推奨です。代わりに streetNumber を使用してください。 |
country |
string |
国/地域名 |
countryCode |
string |
国 (注: これは国/地域名ではなく、2 文字のコードです)。 |
countryCodeISO3 |
string |
ISO alpha-3 国コード |
countrySecondarySubdivision |
string |
County |
countrySubdivision |
string |
都道府県 |
countrySubdivisionCode |
string |
|
countrySubdivisionName |
string |
国/地域管理階層の第 1 レベルの完全名。 このフィールドは、countrySubdivision が省略形で表示される場合にのみ表示されます。 米国、カナダ、英国でのみサポートされます。 |
countryTertiarySubdivision |
string |
名前付き領域 |
crossStreet |
string |
交差している通りの名前。 |
extendedPostalCode |
string |
拡張郵便番号 (利用可能時間は地域によって異なります)。 |
freeformAddress |
string |
結果の配信元の国/地域の書式設定規則に従って書式設定された住所行、または国/地域の場合は、その完全な国/地域名。 |
localName |
string |
管理単位を使用せずに、アドレス指定の目的で複数のアドレス指定可能オブジェクトをグループ化する地理的領域または地域の名前を表すアドレス コンポーネント。 このフィールドは、 プロパティのビルドに使用されます |
municipality |
string |
市区町村 |
municipalitySubdivision |
string |
サブ / スーパーシティ |
neighbourhood |
string |
地域は、都市または町内の地理的にローカライズされた地域であり、住民間の独特の特徴と社会的相互作用を持っています。 |
postalCode |
string |
郵便番号/郵便番号 |
routeNumbers |
string[] |
道路を明確に識別するために使用されるコード |
street |
string |
通りの名前。 非推奨です。代わりに streetName を使用してください。 |
streetName |
string |
通りの名前。 |
streetNameAndNumber |
string |
通りの名前と番号。 |
streetNumber |
string |
通りの建物番号。 |
AddressRanges
検索結果の通りの両側のアドレス範囲について説明します。 アドレス範囲の開始位置と終了位置の座標が含まれます。
名前 | 型 | 説明 |
---|---|---|
from |
短い名前 'lat' & 'lon' を使用して緯度と経度として表される場所。 |
|
rangeLeft |
string |
通りの左側の住所範囲。 |
rangeRight |
string |
通りの右側の住所範囲。 |
to |
短い名前 'lat' & 'lon' を使用して緯度と経度として表される場所。 |
BoundingBox
ビューポートの左上と右下の座標で表される結果をカバーするビューポート。
名前 | 型 | 説明 |
---|---|---|
btmRightPoint |
短い名前 'lat' & 'lon' を使用して緯度と経度として表される場所。 |
|
topLeftPoint |
短い名前 'lat' & 'lon' を使用して緯度と経度として表される場所。 |
BoundingBoxCompassNotation
場所の境界ボックス。
名前 | 型 | 説明 |
---|---|---|
entity |
境界ボックスのエンティティ型ソース。 逆ジオコーディングの場合、これは常に位置と等しくなります。 |
|
northEast |
string |
コンマ区切りの浮動小数点数として境界ボックスの北東緯度、経度座標 |
southWest |
string |
境界ボックスの南西緯度、経度座標 (コンマ区切り浮動小数点数) |
Brand
POI に関連付けられているブランド
名前 | 型 | 説明 |
---|---|---|
name |
string |
ブランドの名前 |
Classification
返される POI の分類
名前 | 型 | 説明 |
---|---|---|
code |
string |
code プロパティ |
names |
名前配列 |
ClassificationName
分類の名前
名前 | 型 | 説明 |
---|---|---|
name |
string |
Name プロパティ |
nameLocale |
string |
Name Locale プロパティ |
DataSources
省略可能なセクション。 Get Search Polygon API で使用する参照 ID。
名前 | 型 | 説明 |
---|---|---|
geometry |
結果の幾何学的形状に関する情報。 型 == Geography の場合にのみ存在します。 |
ElectricVehicleConnector
特定のコネクタの種類をサポートする電気自動車ステーションに結果を制限するために使用できるコネクタの種類のコンマ区切りのリスト。 項目の順序は関係ありません。 複数のコネクタの種類が指定されている場合は、指定されたリストの 1 つ (少なくとも) に属する結果のみが返されます。
使用可能なコネクタの種類は次のとおりです。
-
StandardHouseholdCountrySpecific
- これらは、特定のリージョンの標準的な家庭用コネクタです。 これらはすべてAC単相であり、標準電圧と標準アンパージュです。 「 プラグ & ソケットの種類 - World Standards」も参照してください。 -
IEC62196Type1
- IEC 62196-2 標準で定義されているタイプ 1 コネクタ。 最初にそれを公開した標準の後、元のメーカーまたはSAE J1772の後に矢崎とも呼ばれます。 主に120V単相または最大240V単相インフラストラクチャと組み合わせて使用されます。 -
IEC62196Type1CCS
- IEC 62196-3 標準で定義されているタイプ 1 ベースのコンボ コネクタ。 このコネクタは、IEC 62196-2標準で定義されているタイプ1コネクタに基づいており、DC急速充電を可能にする2つの追加の直流(DC)接点を備えます。 -
IEC62196Type2CableAttached
- IEC 62196-2 標準で定義されているタイプ 2 コネクタ。 充電ポイントに取り付けられたケーブルとプラグとして提供されます。 -
IEC62196Type2Outlet
- IEC 62196-2 標準で定義されているタイプ 2 コネクタ。 充電ポイントにセットされたソケットとして提供されます。 -
IEC62196Type2CCS
- IEC 62196-3 標準で定義されているタイプ 2 ベースのコンボ コネクタ。 このコネクタは、IEC 62196-2標準で定義されているタイプ2コネクタに基づいており、DC急速充電を可能にする2つの追加の直流(DC)接点を備えます。 -
IEC62196Type3
- IEC 62196-2 標準で定義されているタイプ 3 コネクタ。 元のメーカーの後にスカメとも呼ばれます。 主に最大240Vの単相または最大420Vの3相インフラストラクチャと組み合わせて使用されます。 -
Chademo
- 東京電力と産業パートナーが設立した協会にちなんだCHAdeMOコネクタ。 このため、東京電力のコネクタとも呼ばれています。 高速DC充電に対応しています。 -
IEC60309AC1PhaseBlue
- Industrial Blue コネクタは、IEC 60309 標準で定義されているコネクタです。 これは、標準の何らかの組み合わせ、色、および単一相コネクタであるという事実によって呼ばれることがあります。 通常、コネクタには "P+N+E, 6h" 構成があります。 -
IEC60309DCWhite
- 産業用ホワイト コネクタは、IEC 60309 標準で定義されている DC コネクタです。 -
Tesla
- Tesla コネクタは、地域固有の Tesla スーパーチャージャー コネクタです。 つまり、テスラ独自のコネクタを指します。テスラポートは、主に北米に限られているか、ヨーロッパでは修正されたタイプ2(DC over Type 2)と呼ばれることもあります。
使用例:
connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached
名前 | 型 | 説明 |
---|---|---|
Chademo |
string |
東京電力と産業パートナーが設立した協会にちなんだCHAdeMOコネクタ。 このため、東京電力のコネクタとも呼ばれています。 高速DC充電に対応しています。 |
IEC60309AC1PhaseBlue |
string |
Industrial Blue コネクタは、IEC 60309 標準で定義されているコネクタです。 これは、標準の何らかの組み合わせ、色、および単一相コネクタであるという事実によって呼ばれることがあります。 通常、コネクタには "P+N+E, 6h" 構成があります。 |
IEC60309DCWhite |
string |
産業用ホワイト コネクタは、IEC 60309 標準で定義されている DC コネクタです。 |
IEC62196Type1 |
string |
IEC 62196-2 標準で定義されている 1 コネクタを入力します。 最初にそれを公開した標準の後、元のメーカーまたはSAE J1772の後に矢崎とも呼ばれます。 主に120V単相または最大240V単相インフラストラクチャと組み合わせて使用されます。 |
IEC62196Type1CCS |
string |
IEC 62196-3 標準で定義されているタイプ 1 ベースのコンボ コネクタ。 このコネクタは、IEC 62196-2標準で定義されているタイプ1コネクタに基づいており、DC急速充電を可能にする2つの追加の直流(DC)接点を備えます。 |
IEC62196Type2CCS |
string |
IEC 62196-3 規格で定義されているタイプ 2 ベースのコンボ コネクタ。 このコネクタは、IEC 62196-2標準で定義されているタイプ2コネクタに基づいており、DC急速充電を可能にする2つの追加の直流(DC)接点を備えます。 |
IEC62196Type2CableAttached |
string |
IEC 62196-2 標準で定義されている 2 コネクタを入力します。 充電ポイントに取り付けられたケーブルとプラグとして提供 |
IEC62196Type2Outlet |
string |
IEC 62196-2 標準で定義されている 2 コネクタを入力します。 充電ポイントにセットされたソケットとして提供されます。 |
IEC62196Type3 |
string |
IEC 62196-2 標準で定義されているタイプ 3 コネクタ。 元のメーカーの後にスカメとも呼ばれます。 主に最大240Vの単相または最大420Vの3相インフラストラクチャと組み合わせて使用されます。 |
StandardHouseholdCountrySpecific |
string |
これらは、特定のリージョンの標準的な家庭用コネクタです。 これらはすべてAC単相であり、標準電圧と標準アンパージュです。 「プラグ & ソケットの種類 - World Standards」も参照してください。 |
Tesla |
string |
Tesla コネクタは、地域固有の Tesla Supercharger コネクタです。 つまり、テスラ独自のコネクタを指します。テスラポートは、主に北米に限られているか、ヨーロッパでは修正されたタイプ2(DC over Type 2)と呼ばれることもあります。 |
Entity
境界ボックスのエンティティ型ソース。 逆ジオコーディングの場合、これは常に位置と等しくなります。
名前 | 型 | 説明 |
---|---|---|
position |
string |
Position エンティティ |
EntryPoint
返される POI のエントリ ポイント。
名前 | 型 | 説明 |
---|---|---|
position |
短い名前 'lat' & 'lon' を使用して緯度と経度として表される場所。 |
|
type |
エントリ ポイントの種類。 値には、メインまたはマイナーのいずれかを指定できます。 |
EntryPointType
エントリ ポイントの種類。 値には、メインまたはマイナーのいずれかを指定できます。
名前 | 型 | 説明 |
---|---|---|
main |
string |
|
minor |
string |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
GeographicEntityType
Geography エンティティ型。 entityType が要求され、使用可能な場合にのみ表示されます。
名前 | 型 | 説明 |
---|---|---|
Country |
string |
国/地域名 |
CountrySecondarySubdivision |
string |
County |
CountrySubdivision |
string |
都道府県 |
CountryTertiarySubdivision |
string |
名前付き領域 |
Municipality |
string |
市区町村 |
MunicipalitySubdivision |
string |
サブ/スーパーシティ |
Neighbourhood |
string |
近所 |
PostalCodeArea |
string |
郵便番号/郵便番号 |
Geometry
結果の幾何学的形状に関する情報。 型 == Geography の場合にのみ存在します。
名前 | 型 | 説明 |
---|---|---|
id |
string |
これを geometryId として Get Search Polygon API に渡して、この結果のジオメトリ情報をフェッチします。 |
LatLongPairAbbreviated
短い名前 'lat' & 'lon' を使用して緯度と経度として表される場所。
名前 | 型 | 説明 |
---|---|---|
lat |
number |
Latitude プロパティ |
lon |
number |
Longitude プロパティ |
LocalizedMapView
View パラメーター ("user region" パラメーターとも呼ばれます) を使用すると、地政学的に紛争が発生している地域の特定の国/地域の正しいマップを表示できます。 このようなリージョンのビューは国や地域によって異なります。また、View パラメーターを使用すると、アプリケーションがサービスを提供する国/地域に必要なビューにアプリケーションを準拠できます。 既定では、View パラメーターは、要求で定義していない場合でも "Unified" に設定されます。 ユーザーの場所を特定し、その場所を正しく View パラメーターを設定するのはユーザーの責任です。 または、要求の IP アドレスに基づいてマップ データを返す 'View = Auto' を設定することもできます。 Azure Mapsの View パラメーターは、マップ、画像、その他のデータ、Azure Maps経由でアクセスする権限を持つ第三者のコンテンツが利用可能になる国/地域のマッピングに関するものを含む、適用される法律に準拠して使用する必要があります。 例: view=IN。
詳細については、「 サポートされているビュー」 を参照し、使用可能なビューを参照してください。
名前 | 型 | 説明 |
---|---|---|
AE |
string |
アラブ首長国連邦、AE |
AR |
string |
アルゼンチン (アルゼンチン ビュー) |
Auto |
string |
要求の IP アドレスに基づいてマップ データを返します。 |
BH |
string |
バーレーン (アラビアのビュー) |
IN |
string |
インド (インド ビュー) |
IQ |
string |
イラク (アラビアのビュー) |
JO |
string |
ヨルダン (アラビアのビュー) |
KW |
string |
クウェート (アラビアのビュー) |
LB |
string |
レバノン (アラビアのビュー) |
MA |
string |
モロッコ (モロッコのビュー) |
OM |
string |
オマーン (アラビアのビュー) |
PK |
string |
パキスタン (パキスタンのビュー) |
PS |
string |
パレスチナ自治政府 (アラビアのビュー) |
QA |
string |
カタール (アラビアのビュー) |
SA |
string |
サウジアラビア (アラビアのビュー) |
SY |
string |
シリア (アラビアのビュー) |
Unified |
string |
統一されたビュー (その他) |
YE |
string |
イエメン (アラビアのビュー) |
MatchType
逆引きアドレス検索操作の一致の種類。
名前 | 型 | 説明 |
---|---|---|
AddressPoint |
string |
|
HouseNumberRange |
string |
|
Street |
string |
OperatingHours
POI (ポイント オブ インタレスト) の営業時間。
名前 | 型 | 説明 |
---|---|---|
mode |
string |
要求で使用される値: none または "nextSevenDays" |
timeRanges |
次の 7 日間の時間範囲の一覧 |
OperatingHoursRange
POI (ポイント オブ インタレスト) の操作時間。 操作時間の可用性は、使用可能なデータによって異なります。 渡されない場合、営業時間情報は返されません。 サポートされている値: nextSevenDays
名前 | 型 | 説明 |
---|---|---|
nextSevenDays |
string |
POI の現地時刻の現在の日から始まる、次の週の操作時間を示します。 |
OperatingHoursTime
日付と時刻を表します
名前 | 型 | 説明 |
---|---|---|
date |
string |
POI タイム ゾーンの現在のカレンダー日付を表します (例: "2019-02-07")。 |
hour |
integer |
時間は、POI の現地時刻の 24 時間形式です。指定できる値は 0 から 23 です。 |
minute |
integer |
分は POI の現地時刻です。指定できる値は 0 から 59 です。 |
OperatingHoursTimeRange
1 日の時間範囲を開く
名前 | 型 | 説明 |
---|---|---|
endTime |
特定の POI が閉じられている次の 7 日間の範囲のポイント、または範囲の前に閉じられた場合は範囲の先頭。 |
|
startTime |
特定の POI が開かれている次の 7 日間の範囲のポイント、または範囲の前に開かれた場合は範囲の先頭。 |
PointOfInterest
名前、電話番号、URL アドレス、分類などの情報を含む、返される POI の詳細。
名前 | 型 | 説明 |
---|---|---|
brands |
Brand[] |
ブランド配列。 返される POI のブランド名。 |
categories |
string[] |
Categories 配列 |
categorySet |
最も具体的な POI カテゴリの一覧 |
|
classifications |
分類配列 |
|
name |
string |
POI プロパティの名前 |
openingHours |
POI (ポイント オブ インタレスト) の営業時間。 |
|
phone |
string |
電話番号プロパティ |
url |
string |
Web サイトの URL プロパティ |
PointOfInterestCategorySet
POI カテゴリ
名前 | 型 | 説明 |
---|---|---|
id |
integer |
カテゴリ ID。 |
QueryType
返されるクエリの種類: NEARBY または NON_NEAR。
名前 | 型 | 説明 |
---|---|---|
NEARBY |
string |
Searchは、定義された半径を持つ特定の緯度と経度を中心に実行されました |
NON_NEAR |
string |
Searchは、特定の緯度と経度に偏らず、半径が定義されていない、グローバルに実行されました |
ResponseFormat
応答の目的の形式。 値には json または xml のいずれかを指定できます。
名前 | 型 | 説明 |
---|---|---|
json |
string |
|
xml |
string |
SearchAddressResult
このオブジェクトは、正常なSearch呼び出しから返されます。
名前 | 型 | 説明 |
---|---|---|
results |
Search API の結果の一覧。 |
|
summary |
Search API 応答の Summary オブジェクト |
SearchAddressResultItem
Search API 応答の Result オブジェクト。
名前 | 型 | 説明 |
---|---|---|
address |
結果のアドレス |
|
addressRanges |
検索結果の通りの両側のアドレス範囲について説明します。 アドレス範囲の開始位置と終了位置の座標が含まれます。 |
|
dataSources |
省略可能なセクション。 Get Search Polygon API で使用する参照ジオメトリ ID。 |
|
detourTime |
integer |
迂回時間 (秒単位)。 Search Along Route API の呼び出しに対してのみ返されます。 |
dist |
number |
結果とジオビアスの位置間の直線距離 (メートル単位)。 |
entityType |
Geography エンティティ型。 entityType が要求され、使用可能な場合にのみ表示されます。 |
|
entryPoints |
EntryPoints の配列。 これらは、場所で利用可能な入り口の種類を説明します。 種類は、フロント ドアやロビーなどのメインの入り口には "メイン"、サイド ドアとバック ドアの場合は "マイナー" です。 |
|
id |
string |
Id プロパティ |
info |
string |
Result の元のデータ ソースに関する情報。 サポート要求に使用されます。 |
matchType |
一致の種類に関する情報。 つぎのいずれかです。
|
|
poi |
名前、電話番号、URL アドレス、分類などの情報を含む、返される POI の詳細。 |
|
position |
短い名前 'lat' & 'lon' を使用して緯度と経度として表される場所。 |
|
score |
number |
結果セット内の値。結果間の相対的な一致スコアを示します。 これを使用すると、x の値が y の値の 2 倍の場合、結果 x が結果 y と同じ 2 倍の関連性を持つ可能性が高いと判断できます。 値はクエリによって異なり、1 つの結果セットの相対値としてのみ使用されます。 |
type |
つぎのいずれかです。
|
|
viewport |
ビューポートの左上と右下の座標で表される結果をカバーするビューポート。 |
SearchAddressResultType
つぎのいずれかです。
- POI
- Street
- [地理的な場所]
- ポイント住所
- アドレス範囲
- 交差道路
名前 | 型 | 説明 |
---|---|---|
Address Range |
string |
|
Cross Street |
string |
|
Geography |
string |
|
POI |
string |
|
Point Address |
string |
|
Street |
string |
SearchIndexes
結果に拡張郵便番号を含める必要があるインデックス。
使用可能なインデックスは次のとおりです。
Addr = アドレス範囲
Geo = Geographies
PAD = ポイント アドレス
POI = 目的地
Str = Streets
XStr = クロス ストリート (交差点)
値は、インデックスの種類 (任意の順序) のコンマ区切りのリスト、またはインデックスがない場合は None にする必要があります。
既定では、Geo を除くすべてのインデックスに拡張郵便番号が含まれます。 地域の拡張郵便番号リストは非常に長い場合があるため、必要に応じて明示的に要求する必要があります。
使用例:
extendedPostalCodesFor=POI
extendedPostalCodesFor=PAD,Addr,POI
extendedPostalCodesFor=None
拡張郵便番号は、住所の extendedPostalCode プロパティとして返されます。 可用性はリージョンに依存します。
名前 | 型 | 説明 |
---|---|---|
Addr |
string |
|
Geo |
string |
|
PAD |
string |
|
POI |
string |
|
Str |
string |
|
Xstr |
string |
SearchSummary
Search API 応答の Summary オブジェクト。
名前 | 型 | 説明 |
---|---|---|
fuzzyLevel |
integer |
結果を提供するために必要な最大あいまいレベル。 |
geoBias |
内部検索エンジンが地理空間バイアスを適用して結果のランク付けが向上したことを示します。 一部のメソッドでは、利用可能な場合に lat パラメーターと lon パラメーターを設定すると、これが影響を受ける可能性があります。 それ以外の場合は、純粋に内部的です。 |
|
limit |
integer |
返される応答の最大数 |
numResults |
integer |
応答の結果の数。 |
offset |
integer |
完全な結果セット内で返される結果の開始オフセット。 |
query |
string |
これらの検索結果の生成に使用されたクエリ パラメーター。 |
queryTime |
integer |
クエリの解決に費やされた時間 (ミリ秒単位)。 |
queryType |
返されるクエリの種類: NEARBY または NON_NEAR。 |
|
totalResults |
integer |
検出された結果の合計数。 |