查询地图要素

Maps SDK 为您提供查询地图层的工具以获取 GeoJSON 要素的列表，这些要素保存着用于渲染地图的宝贵信息。一个示例用法就是用来查询用户单击或点击地图的位置，并确定用户是否选择地图上显示的 POI。然后，您可以通过提供的 GeoJSON 要素以获取属性。属性以String形式保存着 POI 的名称。重要的是，考虑查询地图并不总是返回您要查找的信息。因此, 可能收到具有 0 个要素列表。

可以考虑屏幕上的特定点，或首先构建边界框并接收该地区内找到的所有要素来查询地图。除了图层，还可以查询源以查找与查询匹配的特定信息，而不管这些项是否实际显示在地图上。

由于要素来自切片的矢量数据，或是在内部转换为切片的 GeoJSON 数据，所以可能会跨切片边界分割或复制要素几何图形，因此在查询结果中，要素可能会多次出现。例如，假设有一条高速公路穿过查询的边界矩形。查询结果将是位于覆盖边界矩形的地图切片内的高速公路部分（即使高速公路延伸到其他切片中），并且每个地图切片内的高速公路部分将返回为单独要素。同样，由于切片缓冲作用，切片边界附近的点要素可能会出现在多个切片中。

查询渲染的要素

查询地图的常见用法是获取用户查看的特定位置的信息。该点必须在用户设备视区内可查看并已经完全渲染出来，然后您就可以访问这些信息。查询地图只接受屏幕像素值而不是 LatLng，因此在许多情况下，您需要事先进行转换。在以下代码段中，单击的地图提供一个 LatLng，我们将其用来查询地图并获取该位置的属性。

@Override
public void onMapClick(@NonNull LatLng point) {
 
  // Convert LatLng coordinates to screen pixel and only query the rendered features.
  final PointF pixel = mapboxMap.getProjection().toScreenLocation(point);
  List<Feature> features = mapboxMap.queryRenderedFeatures(pixel);
 
  // Get the first feature within the list if one exist
  if (features.size() > 0) {
    Feature feature = features.get(0);
 
    // Ensure the feature has properties defined
    if (feature.getProperties() != null) {
      for (Map.Entry<String, JsonElement> entry : feature.getProperties().entrySet()) {
        // Log all the properties
        Log.d(TAG, String.format("%s = %s", entry.getKey(), entry.getValue()));
      }
    }
  }
}

查询边界框内的要素

除了查询地图中的特定点，还可以通过传入 RectF 对象来传递边界框。这可能来自地图顶部当前向用户显示的 Android 视图，或者视区内当前显示的 4 个坐标。以下代码段显示如何获取四个坐标，将它们转换为 PointF 对象，将它们添加到新的 RectF 中，最后将“边界框”传递到 queryRenderedFeatures()中。

RectF rectF = new RectF(
  mapboxMap.getProjection().toScreenLocation(<left coordinate>),
  mapboxMap.getProjection().toScreenLocation(<top coordinate>),
  mapboxMap.getProjection().toScreenLocation(<right coordinate>),
  mapboxMap.getProjection().toScreenLocation(<bottom coordinate>)
);
mapboxMap.queryRenderedFeatures(rectF);

查询数据源的要素

与 mapboxMap#queryRenderedFeatures() 相反，使用 querySourceFeatures 返回与查询参数匹配的所有要素，无论它们是否由当前样式呈现（即可见）。查询的域包括所有当前加载的矢量切片和 GeoJSON 源切片：此函数不会检索当前可见视区之外的切片。

由于要素来自切片的矢量数据，或已在内部转换为切片的 GeoJSON 数据，所以可能会跨切片边界分割或复制要素几何图形，就像您要执行queryRenderedFeatures()一样。若要查询数据源，您必须将查询参数传递为一组Filters，并且只有满足该语句的要素才会添加到返回的要素列表中。例如，在以下代码段中，地图样式包含一个称为population-source的 GeoJSON 源，它包含了定义 population 的每个要素的属性。我们查询时，只想获取拥有大于 100000 的 population 的要素即可。

GeoJsonSource source = mapboxMap.getSourceAs("population-source");
List<Feature> features = source.querySourceFeatures(Filter.gt("population", "100000"))