README

测试；稳定，但可能有少量错误；

安装

通过 Composer

composer require streltcov/yandex-geocoder

基本用法

执行对 Yandex 地理编码器的请求，并提供 GeoObject 选择流畅的接口

获取地理集合中找到的所有结果

<?php

use streltcov\YandexUtils\GeoCoder;

// returns array of GeoObjects (numeration begins from 0)
$response = GeoCoder::search($address)->all();

获取单个 GeoObject

<?php

use streltcov\YandexUtils\GeoCoder;

// returns first instance if number is not specified
$geoobject = GeoCoder::search($address)->one();

// returns GeoObject with specified number (numeration from 0)
$geoobject = GeoCoder::search($address)->one(1);
// returns 5 element in geoobjects array
$response = GeoCoder::search($address)->one(5);

获取具有精确精度的 GeoObject

// exact()
// returns GeoObject with precision property set to exact
$response = GeoCoder::search($address)->exact();


// searching geocontext with coordinates
// will return first instance in geoobjects array
$response = GeoCoder::searchPoint($coordinates)->one();

// parameters:
// may be set globally by GeoCoder methods setLocality, setKind and SetSkip
// or in array for single request
// skip parameter:
GeoCoder::setSkip(10); // setting globally for all requests
$response = GeoCoder::search($address)->all(); // will skip first 10 results and return next 10
$response = GeoCoder::search($address, ['skip' => 10])->all(); // the same for single request

// parameters 'skip' and 'lang' will be used in both cases (searching address or coordinates)
// parameter 'kind' will be applied only for point coordinates;

参数

有三个可用参数 - 跳过、类型和位置

• 跳过

  • 通常返回多个（最多10个）具有不同精度（例如，“精确”、“数字”或“街道”等）的结果

• 位置

• 类型

参数可以是全局的（对所有请求）或局部的（对单个请求）

公共方法

GeoCoder

静态方法

• search(string $address)

  • search requested address without parameters and returns GeoCollection

• searchPoint(string $coordinates, array $parameters = null)

  • search requested coordinates and returns GeoCollection
  • parameters: 'kind', 'skip', 'lang'

• setLocality(string $locality)

  • sets global language parameter

• setSkip(int $skip)

  • sets global parameter 'skip'

• setKind(string $kind)

  • sets global parameter 'kind' (parameter ignored while requesting address)

GeoCollection

基本

• exact()

  • returns GeoObject with "exact" precision (if exists in collection); else returns null

• one(int $index = null)

  • returns GeoObject with requested id (index in array); returns first instance with null parameter

• all()

  • returns array of GeoObjects (numerated from 0)

Geo 对象选择流畅接口

• select(array $parameters)

  • filters geoobjects by kind and/or id (index in array)

• find($substring)

  • filters geoobjects using substring (search matches in GeoObject properties)

GeoObject

• isExact()

  • returns true if current precision is exact; false if not

• getKind()

  • returns string

• getPrecision()

  • returns string

• getName()

  • returns string

• getDescription()

  • returns string

• getAddress()

  • returns string

• getCoordinates()

  • returns string

• getPostalCode()

  • returns string or null

• getCountry()

  • returns string

• getCountryCode()

  • returns string

• getProvince()

  • returns string or null

• getLocality()

  • returns string or null

• getStreet()

  • returns string or null

• getPoint()

  • returns array containing upper and lower corner coordinates

• getData()

  • returns array of geoobject public properties

可用的参数值

类型

    'house',
    'street',
    'metro',
    'district',
    'locality',
    'province',
    'country',
    'hydro'
    
    (other values will be ignored)

位置

    'RU' => russian
    'US' => english (american)
    'EN' => english
    'UA' => ukrainian
    'BY' => belorussian
    'TR' => turkish
    
    (other values will be ignored)

示例

// the following request will set locale to en_US, skip first 5 results, return GeoObjects with kind = metro and
// select objects with indexes 0, 1 and 2
$response = GeoCoder::searchPoint($coordinates, ['kind'=> 'metro', 'skip' => 5, 'lang' => 'US'])
->select(['id' => [0, 1, 2]])
->all();