Search - Post Search Inside Geometry

Referensi

Layanan:: Maps

Versi API:: 1.0

Gunakan untuk melakukan pencarian formulir gratis di dalam satu geometri lagi.

API Post Search Inside Geometry adalah dan geometri HTTP POST request that allows you to perform a free form search inside a single geometry or multiple geometries. The search results that fall inside the geometry/geometries will be returned. To send the geometry you will use a POSTrequest where the request body will contain theobject represented as aGeoJSONtype and theaplikasiheader will be set toJenis Konten/json. The geographical features to be searched can be modeled as Polygon and/or Circle geometries represented using any one of the following GeoJSONtypes:<ul><li>**GeoJSON FeatureCollection** Thegeometrican be represented as aGeoJSON FeatureCollectionobject. This is the recommended option if the geometry contains both Polygons and Circles. TheFeatureCollectioncan contain a max of 50GeoJSON Featureobjects. EachFeatureobject should represent either a Polygon or a Circle with the following conditions:<ul style="list-style-type:none"><li>AFeatureobject for the Polygon geometry can have a max of 50 coordinates and it's properties must be empty.</li><li>AFeatureobject for the Circle geometry is composed of a _center_ represented using aGeoJ Geometrirepresentation. </li><li>**GeoJSON GeometryCollection** Thetype and a _radius_ value (in meters) which must be specified in the object's properties along with the _subType_ property whose value should be 'Circle'.</li></ul> Please see the Examples section below for a samplePointrepresentation. </li><li>**GeoJSON GeometryCollection** TheGeometrycan be represented as aCollectionobject. This is the recommended option if the geometry contains a list of Polygons only. TheGeometryCollectioncan contain a max of 50GeoJSON Polygonobjects. EachPolygonobject can have a max of 50 coordinates. Please see the Examples section below for a sampleGeometryCollectionrepresentation. </li><li>**GeoJSON Polygon** Thegeometrican be represented as aGeoJSON Polygonobject. This is the recommended option if the geometry contains a single Polygon. ThePolygonobject can have a max of 50 coordinates. Please see the Examples section below for a samplePolygon' representasi.

.

POST https://atlas.microsoft.com/search/geometry/{format}?api-version=1.0&query={query}

Dengan parameter opsional:

POST https://atlas.microsoft.com/search/geometry/{format}?api-version=1.0&query={query}&limit={limit}&language={language}&categorySet={categorySet}&extendedPostalCodesFor={extendedPostalCodesFor}&idxSet={idxSet}&view={view}&openingHours=nextSevenDays

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
format	path	True	ResponseFormat	Format respons yang diinginkan. Nilai dapat berupa json atau xml .
api-version	query	True	string	Nomor versi Azure Maps API.
query	query	True	string	Nama POI untuk mencari (misalnya, "patung kebebasan", "starbucks", "pizza"). Harus dikodekan url dengan benar.
categorySet	query		integer[]	Daftar ID set kategori yang dipisahkan koma yang dapat digunakan untuk membatasi hasil ke kategori Poin Minat tertentu. Pesanan ID tidak masalah. Jumlah maksimum nilai `categorySet` yang didukung per permintaan adalah 10. Ketika beberapa pengidentifikasi kategori disediakan, hanya POI yang termasuk dalam (setidaknya) salah satu kategori dari daftar yang disediakan yang akan dikembalikan. Daftar kategori yang didukung dapat ditemukan menggunakan KATEGORI POI API. Contoh penggunaan: categorySet=7315 (Search Points of Interest dari kategori Restoran) categorySet=7315025,7315017 (Search Points of Interest kategori baik Restoran Italia atau Prancis)
extendedPostalCodesFor	query		SearchIndexes[]	Indeks yang kode pos yang diperluas harus disertakan dalam hasilnya. Indeks yang tersedia adalah: Addr = Rentang alamat Geo = Geografi PAD = Alamat Titik POI = Tempat Menarik Str = Jalanan XStr = Lintas Jalan (persimpangan) Nilai harus berupa daftar jenis indeks yang dipisahkan koma (dalam urutan apa pun) atau Tidak Ada tanpa indeks. Secara default kode pos yang diperluas disertakan untuk semua indeks kecuali Geo. Daftar kode pos yang diperluas untuk geografi bisa cukup panjang sehingga harus diminta secara eksplisit saat diperlukan. Contoh penggunaan: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Kode pos yang diperluas dikembalikan sebagai properti extendedPostalCode alamat. Ketersediaan bergantung pada wilayah.
idxSet	query		SearchIndexes[]	Daftar indeks yang dipisahkan koma yang harus digunakan untuk pencarian. Urutan item tidak masalah. Indeks yang tersedia adalah: Addr = Interpolasi rentang alamat, Geo = Geografi, PAD = Alamat Titik, POI = Tempat menarik, Str = Jalan, Xstr = Lintas Jalan (persimpangan)
language	query		string	Bahasa tempat hasil pencarian harus dikembalikan. Harus menjadi salah satu tag bahasa IETF yang didukung, tidak peka huruf besar/kecil. Saat data dalam bahasa tertentu tidak tersedia untuk bidang tertentu, bahasa default digunakan. Silakan merujuk ke Bahasa yang Didukung untuk detailnya.
limit	query		integer minimum: 1 maximum: 100	Jumlah maksimum respons yang akan dikembalikan. Default: 10, minimum: 1 dan maksimum: 100
openingHours	query		OperatingHoursRange	Jam operasi untuk POI (Tempat Menarik). Ketersediaan jam operasi akan bervariasi berdasarkan data yang tersedia. Jika tidak lulus, maka tidak ada informasi jam buka yang akan dikembalikan. Nilai yang didukung: nextSevenDays
view	query		LocalizedMapView	Parameter Tampilan (juga disebut parameter "wilayah pengguna") memungkinkan Anda menampilkan peta yang benar untuk negara/wilayah tertentu untuk wilayah yang disengketakan secara geopolitik. Negara/wilayah yang berbeda memiliki tampilan yang berbeda dari wilayah tersebut, dan parameter Tampilan memungkinkan aplikasi Anda untuk mematuhi tampilan yang diperlukan oleh negara/wilayah yang akan dilayani aplikasi Anda. Secara default, parameter Tampilan diatur ke "Terpadu" meskipun Anda belum menentukannya dalam permintaan. Anda bertanggung jawab untuk menentukan lokasi pengguna Anda, lalu mengatur parameter Tampilan dengan benar untuk lokasi tersebut. Atau, Anda memiliki opsi untuk mengatur 'View=Auto', yang akan mengembalikan data peta berdasarkan alamat IP permintaan. Parameter Tampilan di Azure Maps harus digunakan sesuai dengan undang-undang yang berlaku, termasuk yang berkaitan dengan pemetaan, negara/wilayah tempat peta, gambar, dan data lain dan konten pihak ketiga yang diizinkan untuk Anda akses melalui Azure Maps tersedia. Contoh: view=IN. Silakan merujuk ke Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
x-ms-client-id		string	Menentukan akun mana yang ditujukan untuk penggunaan bersama dengan model keamanan ID Microsoft Entra. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun sarana manajemen Azure Maps. Untuk menggunakan keamanan ID Microsoft Entra di Azure Maps, lihat artikel berikut ini untuk panduan.

Isi Permintaan

Nama	Jenis	Deskripsi
geometry	GeoJsonObject: GeoJsonFeature GeoJsonFeatureCollection	Objek `GeoJSON` yang valid. Silakan lihat RFC 7946 untuk detailnya.

Respons

Nama	Jenis	Deskripsi
200 OK	SearchAddressResult	OK
Other Status Codes	ErrorResponse	Terjadi kesalahan tak terduga.

Keamanan

AADToken

Ini adalah Microsoft Entra OAuth 2.0 Flows. Saat dipasangkan dengan akses berbasis peran Azure kontrol dapat digunakan untuk mengontrol akses ke REST API Azure Maps. Kontrol akses berbasis peran Azure digunakan untuk menunjuk akses ke satu atau beberapa akun sumber daya Atau sub-sumber daya Azure Maps. Setiap pengguna, grup, atau perwakilan layanan dapat diberikan akses melalui peran bawaan atau peran kustom yang terdiri dari satu atau beberapa izin ke REST API Azure Maps.

Untuk menerapkan skenario, sebaiknya lihat konsep autentikasi . Singkatnya, definisi keamanan ini menyediakan solusi untuk memodelkan aplikasi melalui objek yang mampu mengontrol akses pada API dan cakupan tertentu.

Nota

Definisi keamanan ini mengharuskan penggunaan header x-ms-client-id untuk menunjukkan sumber daya Azure Maps mana yang diminta akses aplikasi. Ini dapat diperoleh dari api manajemen Maps.
Authorization URL khusus untuk instans cloud publik Azure. Sovereign cloud memiliki URL Otorisasi yang unik dan konfigurasi ID Microsoft Entra.
Kontrol akses berbasis peran Azure dikonfigurasi dari bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.
Penggunaan Azure Maps Web SDK memungkinkan penyiapan berbasis konfigurasi aplikasi untuk beberapa kasus penggunaan.
Untuk informasi selengkapnya tentang platform identitas Microsoft, lihat gambaran umum platform identitas Microsoft .

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Ini adalah kunci bersama yang disediakan saat Anda Membuat akun Azure Maps di portal Microsoft Azure atau menggunakan PowerShell, CLI, Azure SDK, atau REST API.

Dengan kunci ini, aplikasi apa pun dapat mengakses semua REST API. Dengan kata lain, kunci ini dapat digunakan sebagai kunci master di akun tempat kunci tersebut dikeluarkan.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah menggunakan pendekatan aplikasi klien rahasia untuk mengakses REST API Azure Maps sehingga kunci Anda dapat disimpan dengan aman.

Jenis: apiKey
Dalam: query

SAS Token

Ini adalah token tanda tangan akses bersama dibuat dari operasi Daftar SAS pada sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan token ini, aplikasi apa pun berwenang untuk mengakses dengan kontrol akses berbasis peran Azure dan kontrol butir halus ke kedaluwarsa, laju, dan wilayah penggunaan untuk token tertentu. Dengan kata lain, Token SAS dapat digunakan untuk memungkinkan aplikasi mengontrol akses dengan cara yang lebih aman daripada kunci bersama.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah mengonfigurasi daftar spesifik asal yang diizinkan pada sumber daya akun peta untuk membatasi penyalahgunaan penyajian dan memperbarui Token SAS secara teratur.

Jenis: apiKey
Dalam: header

Contoh

Search for burger joints inside a geometry represented as a GeoJSON GeometryCollection type

Search for pizza places inside a geometry represented as a GeoJSON FeatureCollection type

Search for subs joints inside a geometry represented as a GeoJSON Polygon type

Search for burger joints inside a geometry represented as a GeoJSON GeometryCollection type

Permintaan sampel

HTTP

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

{
  "geometry": {
    "type": "GeometryCollection",
    "geometries": [
      {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -122.43576049804686,
              37.7524152343544
            ],
            [
              -122.43301391601562,
              37.70660472542312
            ],
            [
              -122.36434936523438,
              37.712059855877314
            ],
            [
              -122.43576049804686,
              37.7524152343544
            ]
          ]
        ]
      },
      {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -123.43576049804686,
              37.7524152343544
            ],
            [
              -123.43301391601562,
              37.70660472542312
            ],
            [
              -123.36434936523438,
              37.712059855877314
            ],
            [
              -123.43576049804686,
              37.7524152343544
            ]
          ]
        ]
      }
    ]
  }
}

Respon sampel

Kode status:: 200

{
  "summary": {
    "query": "burger",
    "queryType": "NON_NEAR",
    "queryTime": 21,
    "numResults": 2,
    "offset": 0,
    "totalResults": 4,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "9P2i9inRyndAA-_V40J8oA",
      "score": 2.0041828156,
      "info": "search:ta:840061003419653-US",
      "poi": {
        "name": "Burger Joint",
        "phone": "+1 415-349-4331",
        "categorySet": [
          {
            "id": 7315015
          }
        ],
        "categories": [
          "fast food",
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "fast food"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "167",
        "streetName": "Leland Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Visitacion Valley",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94134",
        "extendedPostalCode": "94134-2844",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "167 Leland Avenue, San Francisco, CA 94134",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.712228,
        "lon": -122.407022
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.71313,
          "lon": -122.40816
        },
        "btmRightPoint": {
          "lat": 37.71133,
          "lon": -122.40589
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.71241,
            "lon": -122.40693
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "hkr-N07YS6Gv2dOciQ9lwA",
      "score": 2.0041515827,
      "info": "search:ta:840067000526682-US",
      "poi": {
        "name": "Sound of Burgers",
        "categorySet": [
          {
            "id": 7315
          }
        ],
        "categories": [
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "167",
        "streetName": "Leland Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Visitacion Valley",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivision": "CA",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94134",
        "extendedPostalCode": "94134-2844",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "167 Leland Avenue, San Francisco, CA 94134",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.712228,
        "lon": -122.407022
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.71313,
          "lon": -122.40816
        },
        "btmRightPoint": {
          "lat": 37.71133,
          "lon": -122.40589
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.71241,
            "lon": -122.40693
          }
        }
      ]
    }
  ]
}

Search for pizza places inside a geometry represented as a GeoJSON FeatureCollection type

Permintaan sampel

HTTP

POST https://atlas.microsoft.com/search/geometry/json?api-version=1.0&query=pizza&limit=2&openingHours=nextSevenDays

{
  "geometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.143035,
                47.653536
              ],
              [
                -122.187164,
                47.617556
              ],
              [
                -122.114981,
                47.570599
              ],
              [
                -122.132756,
                47.654009
              ],
              [
                -122.143035,
                47.653536
              ]
            ]
          ]
        },
        "properties": {}
      },
      {
        "type": "Feature",
        "geometry": {
          "type": "Point",
          "coordinates": [
            -122.126986,
            47.639754
          ]
        },
        "properties": {
          "subType": "Circle",
          "radius": 100
        }
      }
    ]
  }
}

Respon sampel

Kode status:: 200

{
  "summary": {
    "query": "pizza",
    "queryType": "NON_NEAR",
    "queryTime": 34,
    "numResults": 2,
    "offset": 0,
    "totalResults": 21,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "-UuwTye4GGsea4KmCLvoqQ",
      "score": 2.1455535889,
      "info": "search:ta:840537000108972-US",
      "poi": {
        "name": "Biryani & Pizza House",
        "categorySet": [
          {
            "id": 7315036
          }
        ],
        "categories": [
          "pizza",
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "pizza"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "15025",
        "streetName": "Northeast 24th Street",
        "municipality": "Redmond",
        "countrySecondarySubdivision": "King",
        "countrySubdivision": "WA",
        "countrySubdivisionName": "Washington",
        "countrySubdivisionCode": "WA",
        "postalCode": "98052",
        "extendedPostalCode": "98052-5531",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "15025 Northeast 24th Street, Redmond, WA 98052",
        "localName": "Redmond"
      },
      "position": {
        "lat": 47.630786,
        "lon": -122.139302
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.63169,
          "lon": -122.14064
        },
        "btmRightPoint": {
          "lat": 47.62989,
          "lon": -122.13797
        }
      },
      "entryPoints": [
        {
          "type": "minor",
          "position": {
            "lat": 47.63079,
            "lon": -122.13931
          }
        },
        {
          "type": "main",
          "position": {
            "lat": 47.63147,
            "lon": -122.13935
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "7r095LCcCSkdoGoeLcnvsQ",
      "score": 2.1454992294,
      "info": "search:ta:840537000103468-US",
      "poi": {
        "name": "Pagliacci Pizza",
        "categorySet": [
          {
            "id": 7315036
          }
        ],
        "url": "www.pagliacci.com/",
        "categories": [
          "pizza",
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "pizza"
              }
            ]
          }
        ],
        "openingHours": {
          "mode": "nextSevenDays",
          "timeRanges": [
            {
              "startTime": {
                "date": "2024-03-14",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-14",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-17",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-17",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-18",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-18",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-19",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-19",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-20",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-20",
                "hour": 11,
                "minute": 0
              }
            }
          ]
        }
      },
      "address": {
        "streetNumber": "15238",
        "streetName": "Bel Red Road",
        "municipality": "Bellevue",
        "countrySecondarySubdivision": "King",
        "countrySubdivision": "WA",
        "countrySubdivisionName": "Washington",
        "countrySubdivisionCode": "WA",
        "postalCode": "98007",
        "extendedPostalCode": "98007-3815",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "15238 Bel Red Road, Bellevue, WA 98007",
        "localName": "Bellevue"
      },
      "position": {
        "lat": 47.628008,
        "lon": -122.13646
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.62891,
          "lon": -122.13779
        },
        "btmRightPoint": {
          "lat": 47.62711,
          "lon": -122.13513
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.6283,
            "lon": -122.13611
          }
        }
      ]
    }
  ]
}

Search for subs joints inside a geometry represented as a GeoJSON Polygon type

Permintaan sampel

HTTP

POST https://atlas.microsoft.com/search/geometry/json?api-version=1.0&query=subs&limit=2&openingHours=nextSevenDays

{
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -122.43576049804686,
          37.7524152343544
        ],
        [
          -122.43301391601562,
          37.70660472542312
        ],
        [
          -122.36434936523438,
          37.712059855877314
        ],
        [
          -122.43576049804686,
          37.7524152343544
        ]
      ]
    ]
  }
}

Respon sampel

Kode status:: 200

{
  "summary": {
    "query": "subs",
    "queryType": "NON_NEAR",
    "queryTime": 42,
    "numResults": 2,
    "offset": 0,
    "totalResults": 5,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "HOIWGiNwVv0z6bF8MO3EbA",
      "score": 2.1455111504,
      "info": "search:ta:840069009512242-US",
      "poi": {
        "name": "Adams Grub Truck",
        "phone": "+1 415-307-8844",
        "categorySet": [
          {
            "id": 7315042
          }
        ],
        "categories": [
          "restaurant",
          "sandwich"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "sandwich"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "1465",
        "streetName": "Carroll Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Bayview",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94124",
        "extendedPostalCode": "94124-3604",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "1465 Carroll Avenue, San Francisco, CA 94124",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.72328,
        "lon": -122.39091
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.72418,
          "lon": -122.39205
        },
        "btmRightPoint": {
          "lat": 37.72238,
          "lon": -122.38977
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.72348,
            "lon": -122.39073
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "bXbc0QxTRlkSo8GnU7EU-Q",
      "score": 2.1454677582,
      "info": "search:ta:840061001992959-US",
      "poi": {
        "name": "SUBWAY San Francisco San Francisco",
        "phone": "+1 415-657-9898",
        "brands": [
          {
            "name": "SUBWAY"
          }
        ],
        "categorySet": [
          {
            "id": 7315042
          }
        ],
        "categories": [
          "restaurant",
          "sandwich"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "sandwich"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ],
        "openingHours": {
          "mode": "nextSevenDays",
          "timeRanges": [
            {
              "startTime": {
                "date": "2024-03-13",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-13",
                "hour": 21,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-14",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-14",
                "hour": 21,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-15",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-15",
                "hour": 21,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-16",
                "hour": 9,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-16",
                "hour": 21,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-17",
                "hour": 9,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-17",
                "hour": 21,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-18",
                "hour": 8,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-18",
                "hour": 20,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-19",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-19",
                "hour": 21,
                "minute": 30
              }
            }
          ]
        }
      },
      "address": {
        "streetNumber": "2599",
        "streetName": "San Bruno Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Portola",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivision": "CA",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94134",
        "extendedPostalCode": "94134-1504",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "2599 San Bruno Avenue, San Francisco, CA 94134",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.729004,
        "lon": -122.403956
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.7299,
          "lon": -122.40509
        },
        "btmRightPoint": {
          "lat": 37.7281,
          "lon": -122.40282
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.72892,
            "lon": -122.40414
          }
        }
      ]
    }
  ]
}

Definisi

Nama	Deskripsi
Address	Alamat hasil
AddressRanges	Menjelaskan rentang alamat di kedua sisi jalan untuk hasil pencarian. Koordinat untuk lokasi awal dan akhir rentang alamat disertakan.
BoundingBox	Viewport yang mencakup hasil yang diwakili oleh koordinat kiri atas dan kanan bawah viewport.
BoundingBoxCompassNotation	Kotak pembatas lokasi.
Brand	Merek yang terkait dengan POI
Classification	Klasifikasi untuk POI yang dikembalikan
ClassificationName	Nama untuk klasifikasi
DataSources	Bagian opsional. Id referensi untuk digunakan dengan Get Search Polygon API.
Entity	Sumber jenis entitas dari kotak pembatas. Untuk reverse-geocoding, ini selalu sama dengan posisi.
EntryPoint	Titik masuk untuk POI yang dikembalikan.
EntryPointType	Jenis titik masuk. Nilai dapat berupa utama atau minor .
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
GeographicEntityType	Jenis entitas geografi. Hanya ada ketika entityType diminta dan tersedia.
GeoJsonFeature	Jenis objek `GeoJSON Feature` yang valid. Silakan lihat RFC 7946 untuk detailnya.
GeoJsonFeatureCollection	Jenis objek `GeoJSON FeatureCollection` yang valid. Silakan lihat RFC 7946 untuk detailnya.
GeoJsonGeometry	Objek geometri `GeoJSON` yang valid. Jenisnya harus salah satu dari tujuh jenis geometri GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon dan GeometryCollection. Silakan lihat RFC 7946 untuk detailnya.
GeoJsonGeometryCollection	Jenis objek `GeoJSON GeometryCollection` yang valid. Silakan lihat RFC 7946 untuk detailnya.
GeoJsonLineString	Jenis geometri `GeoJSON LineString` yang valid. Silakan lihat RFC 7946 untuk detailnya.
GeoJsonMultiLineString	Jenis geometri `GeoJSON MultiLineString` yang valid. Silakan lihat RFC 7946 untuk detailnya.
GeoJsonMultiPoint	Jenis geometri `GeoJSON MultiPoint` yang valid. Silakan lihat RFC 7946 untuk detailnya.
GeoJsonMultiPolygon	Jenis objek `GeoJSON MultiPolygon` yang valid. Silakan lihat RFC 7946 untuk detailnya.
GeoJsonPoint	Jenis geometri `GeoJSON Point` yang valid. Silakan lihat RFC 7946 untuk detailnya.
GeoJsonPolygon	Jenis geometri `GeoJSON Polygon` yang valid. Silakan lihat RFC 7946 untuk detailnya.
Geometry	Informasi tentang bentuk geometrik hasil. Hanya ada jika jenis == Geografi.
LatLongPairAbbreviated	Lokasi yang diwakili sebagai garis lintang dan bujur menggunakan nama pendek 'lat' & 'lon'.
LocalizedMapView	Parameter Tampilan (juga disebut parameter "wilayah pengguna") memungkinkan Anda menampilkan peta yang benar untuk negara/wilayah tertentu untuk wilayah yang disengketakan secara geopolitik. Negara/wilayah yang berbeda memiliki tampilan yang berbeda dari wilayah tersebut, dan parameter Tampilan memungkinkan aplikasi Anda untuk mematuhi tampilan yang diperlukan oleh negara/wilayah yang akan dilayani aplikasi Anda. Secara default, parameter Tampilan diatur ke "Terpadu" meskipun Anda belum menentukannya dalam permintaan. Anda bertanggung jawab untuk menentukan lokasi pengguna Anda, lalu mengatur parameter Tampilan dengan benar untuk lokasi tersebut. Atau, Anda memiliki opsi untuk mengatur 'View=Auto', yang akan mengembalikan data peta berdasarkan alamat IP permintaan. Parameter Tampilan di Azure Maps harus digunakan sesuai dengan undang-undang yang berlaku, termasuk yang berkaitan dengan pemetaan, negara/wilayah tempat peta, gambar, dan data lain dan konten pihak ketiga yang diizinkan untuk Anda akses melalui Azure Maps tersedia. Contoh: view=IN. Silakan merujuk ke Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.
MatchType	Jenis kecocokan untuk operasi pencarian alamat terbalik.
OperatingHours	Jam buka untuk POI (Tempat Menarik).
OperatingHoursRange	Jam operasi untuk POI (Tempat Menarik). Ketersediaan jam operasi akan bervariasi berdasarkan data yang tersedia. Jika tidak lulus, maka tidak ada informasi jam buka yang akan dikembalikan. Nilai yang didukung: nextSevenDays
OperatingHoursTime	Mewakili tanggal dan waktu
OperatingHoursTimeRange	Buka rentang waktu selama sehari
PointOfInterest	Detail POI yang dikembalikan termasuk informasi seperti nama, telepon, alamat url, dan klasifikasi.
PointOfInterestCategorySet	Kategori POI
QueryType	Jenis kueri yang dikembalikan: NEARBY atau NON_NEAR.
ResponseFormat	Format respons yang diinginkan. Nilai dapat berupa json atau xml .
SearchAddressResult	Objek ini dikembalikan dari panggilan Pencarian yang berhasil.
SearchAddressResultItem	Objek hasil untuk respons SEARCH API.
SearchAddressResultType	Salah satu dari: POI Jalan Geografi Alamat Titik Rentang Alamat Lintas Jalan
SearchIndexes	Indeks yang kode pos yang diperluas harus disertakan dalam hasilnya. Indeks yang tersedia adalah: Addr = Rentang alamat Geo = Geografi PAD = Alamat Titik POI = Tempat Menarik Str = Jalanan XStr = Lintas Jalan (persimpangan) Nilai harus berupa daftar jenis indeks yang dipisahkan koma (dalam urutan apa pun) atau Tidak Ada tanpa indeks. Secara default kode pos yang diperluas disertakan untuk semua indeks kecuali Geo. Daftar kode pos yang diperluas untuk geografi bisa cukup panjang sehingga harus diminta secara eksplisit saat diperlukan. Contoh penggunaan: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Kode pos yang diperluas dikembalikan sebagai properti extendedPostalCode alamat. Ketersediaan bergantung pada wilayah.
SearchInsideGeometryRequest	Jenis ini mewakili isi permintaan untuk layanan Search Inside Geometry.
SearchSummary	Objek ringkasan untuk respons SEARCH API.

Address

Objek

Alamat hasil

Nama	Jenis	Deskripsi
boundingBox	BoundingBoxCompassNotation	Kotak pembatas lokasi.
buildingNumber	string	Nomor bangunan di jalan. TIDAK DIGUNAKAN LAGI, gunakan streetNumber sebagai gantinya.
country	string	nama negara/wilayah
countryCode	string	Negara (Catatan: Ini adalah kode dua huruf, bukan nama negara/wilayah.)
countryCodeISO3	string	Kode negara ISO alpha-3
countrySecondarySubdivision	string	County
countrySubdivision	string	Negara Bagian atau Provinsi
countrySubdivisionCode	string	`countrySubdivisionCode` diawali oleh `countryCode` ( countryCode-countrySubdivisionCode ) dan tanda hubung membentuk kode ISO 3166-2. Contoh: TX untuk Texas, SCT untuk Skotlandia dan ON untuk Ontario.
countrySubdivisionName	string	Nama lengkap hierarki administratif negara/wilayah tingkat pertama. Bidang ini hanya muncul jika countrySubdivision disajikan dalam formulir singkatan. Hanya didukung untuk Amerika Serikat, Kanada, dan Inggris Raya.
countryTertiarySubdivision	string	Area Bernama
crossStreet	string	Nama jalan yang disilangkan.
extendedPostalCode	string	Kode pos yang diperluas (ketersediaan tergantung pada wilayah).
freeformAddress	string	Baris alamat yang diformat sesuai dengan aturan pemformatan negara/wilayah asal Hasil, atau dalam kasus negara/wilayah, nama negara/wilayah lengkapnya.
localName	string	Komponen alamat yang mewakili nama area geografis atau lokalitas yang mengelompokkan beberapa objek yang dapat diatasi untuk tujuan alamat, tanpa menjadi unit administratif. Bidang ini digunakan untuk membangun properti `freeformAddress`. `localName` mewakili kotamadya pos. Tergantung pada lokasinya, `localName` adalah nama kota atau kota yang umum dikenal. Untuk nama kota atau kota yang umum dikenal, gunakan `localName` alih-alih `municipality`.
municipality	string	Kota/Kota Catatan: `municipality` mewakili kotamadya perumahan. Tergantung pada lokasinya, nilai `municipality` mungkin berbeda dari nama kota atau kota yang umum dikenal. Untuk nama kota atau kota yang umum dikenal, disarankan agar nilai `localName` digunakan alih-alih nilai `municipality`.
municipalitySubdivision	string	Sub / Kota Super
neighbourhood	string	Lingkungan adalah area yang dilokalkan secara geografis di dalam kota atau kota dengan karakteristik khas dan interaksi sosial antara penduduk.
postalCode	string	Kode Pos / Kode Pos
routeNumbers	string[]	Kode yang digunakan untuk mengidentifikasi jalan secara tidak ambigu
street	string	Nama jalan. TIDAK DIGUNAKAN LAGI, gunakan streetName sebagai gantinya.
streetName	string	Nama jalan.
streetNameAndNumber	string	Nama dan nomor jalan.
streetNumber	string	Nomor bangunan di jalan.

AddressRanges

Objek

Menjelaskan rentang alamat di kedua sisi jalan untuk hasil pencarian. Koordinat untuk lokasi awal dan akhir rentang alamat disertakan.

Nama	Jenis	Deskripsi
from	LatLongPairAbbreviated	Lokasi yang diwakili sebagai garis lintang dan bujur menggunakan nama pendek 'lat' & 'lon'.
rangeLeft	string	Rentang alamat di sisi kiri jalan.
rangeRight	string	Rentang alamat di sisi kanan jalan.
to	LatLongPairAbbreviated	Lokasi yang diwakili sebagai garis lintang dan bujur menggunakan nama pendek 'lat' & 'lon'.

BoundingBox

Objek

Viewport yang mencakup hasil yang diwakili oleh koordinat kiri atas dan kanan bawah viewport.

Nama	Jenis	Deskripsi
btmRightPoint	LatLongPairAbbreviated	Lokasi yang diwakili sebagai garis lintang dan bujur menggunakan nama pendek 'lat' & 'lon'.
topLeftPoint	LatLongPairAbbreviated	Lokasi yang diwakili sebagai garis lintang dan bujur menggunakan nama pendek 'lat' & 'lon'.

BoundingBoxCompassNotation

Objek

Kotak pembatas lokasi.

Nama	Jenis	Deskripsi
entity	Entity	Sumber jenis entitas dari kotak pembatas. Untuk reverse-geocoding, ini selalu sama dengan posisi.
northEast	string	Garis lintang timur laut, koordinat bujur kotak pembatas sebagai float yang dipisahkan koma
southWest	string	Garis lintang barat daya, koordinat bujur kotak pembatas sebagai float yang dipisahkan koma

Brand

Objek

Merek yang terkait dengan POI

Nama	Jenis	Deskripsi
name	string	Nama merek

Classification

Objek

Klasifikasi untuk POI yang dikembalikan

Nama	Jenis	Deskripsi
code	string	Properti kode
names	ClassificationName[]	Array nama

ClassificationName

Objek

Nama untuk klasifikasi

Nama	Jenis	Deskripsi
name	string	Properti nama
nameLocale	string	Properti Nama Lokal

DataSources

Objek

Bagian opsional. Id referensi untuk digunakan dengan Get Search Polygon API.

Nama	Jenis	Deskripsi
geometry	Geometry	Informasi tentang bentuk geometrik hasil. Hanya ada jika jenis == Geografi.

Entity

Enumeration

Sumber jenis entitas dari kotak pembatas. Untuk reverse-geocoding, ini selalu sama dengan posisi.

Nilai	Deskripsi
position	Entitas posisi

EntryPoint

Objek

Titik masuk untuk POI yang dikembalikan.

Nama	Jenis	Deskripsi
position	LatLongPairAbbreviated	Lokasi yang diwakili sebagai garis lintang dan bujur menggunakan nama pendek 'lat' & 'lon'.
type	EntryPointType	Jenis titik masuk. Nilai dapat berupa utama atau minor .

EntryPointType

Enumeration

Jenis titik masuk. Nilai dapat berupa utama atau minor .

Nilai	Deskripsi
main
minor

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

GeographicEntityType

Enumeration

Jenis entitas geografi. Hanya ada ketika entityType diminta dan tersedia.

Nilai	Deskripsi
Country	nama negara/wilayah
CountrySecondarySubdivision	County
CountrySubdivision	Negara Bagian atau Provinsi
CountryTertiarySubdivision	Area Bernama
Municipality	Kota/Kota
MunicipalitySubdivision	Sub / Kota Super
Neighbourhood	Lingkungan
PostalCodeArea	Kode Pos / Kode Pos

GeoJsonFeature

Objek

Jenis objek GeoJSON Feature yang valid. Silakan lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
featureType	string	Jenis fitur. Nilai tergantung pada model data, fitur saat ini adalah bagian dari. Beberapa model data mungkin memiliki nilai kosong.
geometry	GeoJsonGeometry: GeoJsonGeometryCollection GeoJsonLineString GeoJsonMultiLineString GeoJsonMultiPoint GeoJsonMultiPolygon GeoJsonPoint GeoJsonPolygon	Objek geometri `GeoJSON` yang valid. Jenisnya harus salah satu dari tujuh jenis geometri GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon dan GeometryCollection. Silakan lihat RFC 7946 untuk detailnya.
id	string	Pengidentifikasi untuk fitur tersebut.
type	string: Feature	Menentukan jenis `GeoJSON`. Harus salah satu dari sembilan jenis objek GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature dan FeatureCollection.

GeoJsonFeatureCollection

Objek

Jenis objek GeoJSON FeatureCollection yang valid. Silakan lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
features	GeoJsonFeature[]	Berisi daftar objek `GeoJSON Feature` yang valid.
type	string: FeatureCollection	Menentukan jenis `GeoJSON`. Harus salah satu dari sembilan jenis objek GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature dan FeatureCollection.

GeoJsonGeometry

Objek

Objek geometri GeoJSON yang valid. Jenisnya harus salah satu dari tujuh jenis geometri GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon dan GeometryCollection. Silakan lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
type	GeoJsonObjectType	Menentukan jenis `GeoJSON`. Harus salah satu dari sembilan jenis objek GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature dan FeatureCollection.

GeoJsonGeometryCollection

Objek

Jenis objek GeoJSON GeometryCollection yang valid. Silakan lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
geometries	GeoJsonGeometry[]: GeoJsonGeometryCollection[] GeoJsonLineString[] GeoJsonMultiLineString[] GeoJsonMultiPoint[] GeoJsonMultiPolygon[] GeoJsonPoint[] GeoJsonPolygon[]	Berisi daftar objek geometri `GeoJSON` yang valid. Catatan bahwa koordinat di GeoJSON dalam urutan x, y (bujur, lintang).
type	string: GeometryCollection	Menentukan jenis `GeoJSON`. Harus salah satu dari sembilan jenis objek GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature dan FeatureCollection.

GeoJsonLineString

Objek

Jenis geometri GeoJSON LineString yang valid. Silakan lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
coordinates	number[] (double)	Koordinat untuk geometri `GeoJson LineString`.
type	string: LineString	Menentukan jenis `GeoJSON`. Harus salah satu dari sembilan jenis objek GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature dan FeatureCollection.

GeoJsonMultiLineString

Objek

Jenis geometri GeoJSON MultiLineString yang valid. Silakan lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
coordinates	number[] (double)	Koordinat untuk geometri `GeoJson MultiLineString`.
type	string: MultiLineString	Menentukan jenis `GeoJSON`. Harus salah satu dari sembilan jenis objek GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature dan FeatureCollection.

GeoJsonMultiPoint

Objek

Jenis geometri GeoJSON MultiPoint yang valid. Silakan lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
coordinates	number[] (double)	Koordinat untuk geometri `GeoJson MultiPoint`.
type	string: MultiPoint	Menentukan jenis `GeoJSON`. Harus salah satu dari sembilan jenis objek GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature dan FeatureCollection.

GeoJsonMultiPolygon

Objek

Jenis objek GeoJSON MultiPolygon yang valid. Silakan lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
coordinates	number[] (double)	Berisi daftar objek `GeoJSON Polygon` yang valid. Catatan bahwa koordinat di GeoJSON dalam urutan x, y (bujur, lintang).
type	string: MultiPolygon	Menentukan jenis `GeoJSON`. Harus salah satu dari sembilan jenis objek GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature dan FeatureCollection.

GeoJsonPoint

Objek

Jenis geometri GeoJSON Point yang valid. Silakan lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
coordinates	number[] (double)	`Position` adalah array angka dengan dua elemen atau lebih. Dua elemen pertama adalah bujur dan garis lintang, tepatnya dalam urutan tersebut. Altitude/Elevation adalah elemen ketiga opsional. Silakan lihat RFC 7946 untuk detailnya.
type	string: Point	Menentukan jenis `GeoJSON`. Harus salah satu dari sembilan jenis objek GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature dan FeatureCollection.

GeoJsonPolygon

Objek

Jenis geometri GeoJSON Polygon yang valid. Silakan lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
coordinates	number[] (double)	Koordinat untuk jenis geometri `GeoJson Polygon`.
type	string: Polygon	Menentukan jenis `GeoJSON`. Harus salah satu dari sembilan jenis objek GeoJSON yang valid - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature dan FeatureCollection.

Geometry

Objek

Informasi tentang bentuk geometrik hasil. Hanya ada jika jenis == Geografi.

Nama	Jenis	Deskripsi
id	string	Teruskan ini sebagai geometryId ke Get Search Polygon API untuk mengambil informasi geometri untuk hasil ini.

LatLongPairAbbreviated

Objek

Lokasi yang diwakili sebagai garis lintang dan bujur menggunakan nama pendek 'lat' & 'lon'.

Nama	Jenis	Deskripsi
lat	number (double)	Properti garis lintang
lon	number (double)	Properti garis bujur

LocalizedMapView

Enumeration

Parameter Tampilan (juga disebut parameter "wilayah pengguna") memungkinkan Anda menampilkan peta yang benar untuk negara/wilayah tertentu untuk wilayah yang disengketakan secara geopolitik. Negara/wilayah yang berbeda memiliki tampilan yang berbeda dari wilayah tersebut, dan parameter Tampilan memungkinkan aplikasi Anda untuk mematuhi tampilan yang diperlukan oleh negara/wilayah yang akan dilayani aplikasi Anda. Secara default, parameter Tampilan diatur ke "Terpadu" meskipun Anda belum menentukannya dalam permintaan. Anda bertanggung jawab untuk menentukan lokasi pengguna Anda, lalu mengatur parameter Tampilan dengan benar untuk lokasi tersebut. Atau, Anda memiliki opsi untuk mengatur 'View=Auto', yang akan mengembalikan data peta berdasarkan alamat IP permintaan. Parameter Tampilan di Azure Maps harus digunakan sesuai dengan undang-undang yang berlaku, termasuk yang berkaitan dengan pemetaan, negara/wilayah tempat peta, gambar, dan data lain dan konten pihak ketiga yang diizinkan untuk Anda akses melalui Azure Maps tersedia. Contoh: view=IN.

Silakan merujuk ke Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.

Nilai	Deskripsi
AE	Uni Emirat Arab (Tampilan Arab)
AR	Argentina (Pemandangan Argentina)
Auto	Mengembalikan data peta berdasarkan alamat IP permintaan.
BH	Bahrain (Tampilan Arab)
IN	India (Tampilan India)
IQ	Irak (Tampilan Arab)
JO	Yordania (Tampilan Arab)
KW	Kuwait (Tampilan Arab)
LB	Lebanon (Tampilan Arab)
MA	Maroko (Tampilan Maroko)
OM	Oman (Tampilan Arab)
PK	Pakistan (Tampilan Pakistan)
PS	Otoritas Palestina (Tampilan Arab)
QA	Qatar (Tampilan Arab)
SA	Arab Saudi (Tampilan Arab)
SY	Suriah (Tampilan Arab)
Unified	Tampilan Terpadu (Lainnya)
YE	Yaman (Tampilan Arab)

MatchType

Enumeration

Jenis kecocokan untuk operasi pencarian alamat terbalik.

Nilai	Deskripsi
AddressPoint
HouseNumberRange
Street

OperatingHours

Objek

Jam buka untuk POI (Tempat Menarik).

Nama	Jenis	Deskripsi
mode	string	Nilai yang digunakan dalam permintaan: tidak ada atau "nextSevenDays"
timeRanges	OperatingHoursTimeRange[]	Daftar rentang waktu selama 7 hari ke depan

OperatingHoursRange

Enumeration

Jam operasi untuk POI (Tempat Menarik). Ketersediaan jam operasi akan bervariasi berdasarkan data yang tersedia. Jika tidak lulus, maka tidak ada informasi jam buka yang akan dikembalikan. Nilai yang didukung: nextSevenDays

Nilai	Deskripsi
nextSevenDays	Menunjukkan jam operasi untuk minggu berikutnya, dimulai dengan hari ini di waktu lokal POI.

OperatingHoursTime

Objek

Mewakili tanggal dan waktu

Nama	Jenis	Deskripsi
date	string	Mewakili tanggal kalender saat ini di zona waktu POI, misalnya "2019-02-07".
hour	integer	Jam dalam format 24 jam dalam waktu lokal POI; nilai yang mungkin adalah 0 - 23.
minute	integer	Menit berada di waktu lokal POI; nilai yang mungkin adalah 0 - 59.

OperatingHoursTimeRange

Objek

Buka rentang waktu selama sehari

Nama	Jenis	Deskripsi
endTime	OperatingHoursTime	Titik dalam rentang 7 hari berikutnya ketika POI tertentu sedang ditutup, atau awal rentang jika ditutup sebelum rentang.
startTime	OperatingHoursTime	Titik dalam rentang 7 hari berikutnya ketika POI tertentu sedang dibuka, atau awal rentang jika dibuka sebelum rentang.

PointOfInterest

Objek

Detail POI yang dikembalikan termasuk informasi seperti nama, telepon, alamat url, dan klasifikasi.

Nama	Jenis	Deskripsi
brands	Brand[]	Array merek. Nama merek untuk POI yang dikembalikan.
categories	string[]	Array kategori
categorySet	PointOfInterestCategorySet[]	Daftar kategori POI yang paling spesifik
classifications	Classification[]	Array klasifikasi
name	string	Nama properti POI
openingHours	OperatingHours	Jam buka untuk POI (Tempat Menarik).
phone	string	Properti nomor telepon
url	string	Properti URL Situs Web

PointOfInterestCategorySet

Objek

Kategori POI

Nama	Jenis	Deskripsi
id	integer	ID Kategori

QueryType

Enumeration

Jenis kueri yang dikembalikan: NEARBY atau NON_NEAR.

Nilai	Deskripsi
NEARBY	Pencarian dilakukan di sekitar garis lintang dan bujur tertentu dengan radius yang ditentukan
NON_NEAR	Pencarian dilakukan secara global, tanpa bias pada garis lintang dan bujur tertentu, dan tidak ada radius yang ditentukan

ResponseFormat

Enumeration

Format respons yang diinginkan. Nilai dapat berupa json atau xml .

Nilai	Deskripsi
json	Format Pertukaran Data Notasi Objek JavaScript
xml	Bahasa Markup yang Dapat Diperluas

SearchAddressResult

Objek

Objek ini dikembalikan dari panggilan Pencarian yang berhasil.

Nama	Jenis	Deskripsi
results	SearchAddressResultItem[]	Daftar hasil Search API.
summary	SearchSummary	Objek ringkasan untuk respons SEARCH API

SearchAddressResultItem

Objek

Objek hasil untuk respons SEARCH API.

Nama	Jenis	Deskripsi
address	Address	Alamat hasil
addressRanges	AddressRanges	Menjelaskan rentang alamat di kedua sisi jalan untuk hasil pencarian. Koordinat untuk lokasi awal dan akhir rentang alamat disertakan.
dataSources	DataSources	Bagian opsional. Mereferensikan id geometri untuk digunakan dengan Get Search Polygon API.
detourTime	integer	Waktu memutar dalam detik. Hanya dikembalikan untuk panggilan ke Search Along Route API.
dist	number (double)	Jarak garis lurus antara lokasi hasil dan geobias dalam meter.
entityType	GeographicEntityType	Jenis entitas geografi. Hanya ada ketika entityType diminta dan tersedia.
entryPoints	EntryPoint[]	Array of EntryPoints. Mereka menjelaskan jenis pintu masuk yang tersedia di lokasi. Jenisnya bisa menjadi "utama" untuk pintu masuk utama seperti pintu depan, atau lobi, dan "kecil", untuk pintu samping dan belakang.
id	string	Properti id
info	string	Informasi tentang sumber data asli Hasil. Digunakan untuk permintaan dukungan.
matchType	MatchType	Informasi tentang jenis kecocokan. Salah satu dari: AddressPoint HouseNumberRange Jalan
poi	PointOfInterest	Detail POI yang dikembalikan termasuk informasi seperti nama, telepon, alamat url, dan klasifikasi.
position	LatLongPairAbbreviated	Lokasi yang diwakili sebagai garis lintang dan bujur menggunakan nama pendek 'lat' & 'lon'.
score	number (double)	Nilai dalam hasil diatur untuk menunjukkan skor pencocokan relatif antara hasil. Anda dapat menggunakan ini untuk menentukan bahwa hasil x dua kali lebih mungkin relevan sebagai hasil y jika nilai x adalah 2x nilai y. Nilai bervariasi di antara kueri dan hanya dimaksudkan sebagai nilai relatif untuk satu tataan hasil.
type	SearchAddressResultType	Salah satu dari: POI Jalan Geografi Alamat Titik Rentang Alamat Lintas Jalan
viewport	BoundingBox	Viewport yang mencakup hasil yang diwakili oleh koordinat kiri atas dan kanan bawah viewport.

SearchAddressResultType

Enumeration

Salah satu dari:

POI
Jalan
Geografi
Alamat Titik
Rentang Alamat
Lintas Jalan

Nilai	Deskripsi
Address Range
Cross Street
Geography
POI
Point Address
Street

SearchIndexes

Enumeration

Indeks yang kode pos yang diperluas harus disertakan dalam hasilnya.

Indeks yang tersedia adalah:

Addr = Rentang alamat

Geo = Geografi

PAD = Alamat Titik

POI = Tempat Menarik

Str = Jalanan

XStr = Lintas Jalan (persimpangan)

Nilai harus berupa daftar jenis indeks yang dipisahkan koma (dalam urutan apa pun) atau Tidak Ada tanpa indeks.

Secara default kode pos yang diperluas disertakan untuk semua indeks kecuali Geo. Daftar kode pos yang diperluas untuk geografi bisa cukup panjang sehingga harus diminta secara eksplisit saat diperlukan.

Contoh penggunaan:

extendedPostalCodesFor=POI

extendedPostalCodesFor=PAD,Addr,POI

extendedPostalCodesFor=None

Kode pos yang diperluas dikembalikan sebagai properti extendedPostalCode alamat. Ketersediaan bergantung pada wilayah.

Nilai	Deskripsi
Addr
Geo
PAD
POI
Str
Xstr

SearchInsideGeometryRequest

Objek

Jenis ini mewakili isi permintaan untuk layanan Search Inside Geometry.

Nama	Jenis	Deskripsi
geometry	GeoJsonObject: GeoJsonFeature GeoJsonFeatureCollection	Objek `GeoJSON` yang valid. Silakan lihat RFC 7946 untuk detailnya.

SearchSummary

Objek

Objek ringkasan untuk respons SEARCH API.

Nama	Jenis	Deskripsi
fuzzyLevel	integer	Tingkat fuzzy maksimum yang diperlukan untuk memberikan Hasil.
geoBias	LatLongPairAbbreviated	Indikasi ketika mesin pencari internal telah menerapkan bias geospasial untuk meningkatkan peringkat hasil. Dalam beberapa metode, ini dapat dipengaruhi dengan mengatur parameter lat dan lon jika tersedia. Dalam kasus lain itu murni internal.
limit	integer	Jumlah maksimum respons yang akan dikembalikan
numResults	integer	Jumlah hasil dalam respons.
offset	integer	Offset awal dari Hasil yang dikembalikan dalam kumpulan Hasil lengkap.
query	string	Parameter kueri yang digunakan untuk menghasilkan hasil pencarian ini.
queryTime	integer	Waktu yang dihabiskan untuk menyelesaikan kueri, dalam milidetik.
queryType	QueryType	Jenis kueri yang dikembalikan: NEARBY atau NON_NEAR.
totalResults	integer	Jumlah total Hasil yang ditemukan.

Bagikan melalui

Search - Post Search Inside Geometry

Parameter URI

Header Permintaan

Isi Permintaan

Respons

Keamanan

AADToken

Cakupan

subscription-key

SAS Token

Contoh

Search for burger joints inside a geometry represented as a GeoJSON GeometryCollection type

Permintaan sampel

Respon sampel

Search for pizza places inside a geometry represented as a GeoJSON FeatureCollection type

Permintaan sampel

Respon sampel

Search for subs joints inside a geometry represented as a GeoJSON Polygon type

Permintaan sampel

Respon sampel

Definisi

Address

AddressRanges

BoundingBox

BoundingBoxCompassNotation

Brand

Classification

ClassificationName

DataSources

Entity

EntryPoint

EntryPointType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GeographicEntityType

GeoJsonFeature

GeoJsonFeatureCollection

GeoJsonGeometry

GeoJsonGeometryCollection

GeoJsonLineString

GeoJsonMultiLineString

GeoJsonMultiPoint

GeoJsonMultiPolygon

GeoJsonPoint

GeoJsonPolygon

Geometry

LatLongPairAbbreviated

LocalizedMapView

MatchType

OperatingHours

OperatingHoursRange

OperatingHoursTime

OperatingHoursTimeRange

PointOfInterest

PointOfInterestCategorySet

QueryType

ResponseFormat

SearchAddressResult

SearchAddressResultItem

SearchAddressResultType

SearchIndexes

SearchInsideGeometryRequest

SearchSummary

Sumber Daya Tambahan: