def matrix(self, coordinates, profile='mapbox/driving', 
               sources=None, destinations=None, annotations=None):
        """Request a directions matrix for trips between coordinates

        In the default case, the matrix returns a symmetric matrix,
        using all input coordinates as sources and destinations. You may
        also generate an asymmetric matrix, with only some coordinates
        as sources or destinations:

        Parameters
        ----------
        coordinates : sequence
            A sequence of coordinates, which may be represented as
            GeoJSON features, GeoJSON geometries, or (longitude,
            latitude) pairs.
        profile : str
            The trip travel mode. Valid modes are listed in the class's
            valid_profiles attribute.
        annotations : list
            Used to specify the resulting matrices. Possible values are
            listed in the class's valid_annotations attribute.
        sources : list
            Indices of source coordinates to include in the matrix.
            Default is all coordinates.
        destinations : list
            Indices of destination coordinates to include in the
            matrix. Default is all coordinates.

        Returns
        -------
        requests.Response

        Note: the directions matrix itself is obtained by calling the
        response's json() method. The resulting mapping has a code,
        the destinations and the sources, and depending of the
        annotations specified, it can also contain a durations matrix,
        a distances matrix or both of them (by default, only the
        durations matrix is provided).

        code : str
            Status of the response
        sources : list
            Results of snapping selected coordinates to the nearest
            addresses.
        destinations : list
            Results of snapping selected coordinates to the nearest
            addresses.
        durations : list
            An array of arrays representing the matrix in row-major
            order.  durations[i][j] gives the travel time from the i-th
            source to the j-th destination. All values are in seconds.
            The duration between the same coordinate is always 0. If
            a duration can not be found, the result is null.
        distances : list
            An array of arrays representing the matrix in row-major
            order.  distances[i][j] gives the distance from the i-th
            source to the j-th destination. All values are in meters.
            The distance between the same coordinate is always 0. If
            a distance can not be found, the result is null.

        """
        annotations = self._validate_annotations(annotations)
        profile = self._validate_profile(profile)
        coords = encode_waypoints(coordinates)

        params = self._make_query(sources, destinations)

        if annotations is not None:
            params.update({'annotations': ','.join(annotations)})

        uri = '{0}/{1}/{2}'.format(self.baseuri, profile, coords)
        res = self.session.get(uri, params=params)
        self.handle_http_error(res)
        return res
def matrix ( self , coordinates , profile = 'mapbox/driving' , sources = None , destinations = None , annotations = None ) : annotations = self . _validate_annotations ( annotations ) profile = self . _validate_profile ( profile ) coords = encode_waypoints ( coordinates ) params = self . _make_query ( sources , destinations ) if annotations is not None : params . update ( { 'annotations' : ',' . join ( annotations ) } ) uri = '{0}/{1}/{2}' . format ( self . baseuri , profile , coords ) res = self . session . get ( uri , params = params ) self . handle_http_error ( res ) return res
Request a directions matrix for trips between coordinates

        In the default case, the matrix returns a symmetric matrix,
        using all input coordinates as sources and destinations. You may
        also generate an asymmetric matrix, with only some coordinates
        as sources or destinations:

        Parameters
        ----------
        coordinates : sequence
            A sequence of coordinates, which may be represented as
            GeoJSON features, GeoJSON geometries, or (longitude,
            latitude) pairs.
        profile : str
            The trip travel mode. Valid modes are listed in the class's
            valid_profiles attribute.
        annotations : list
            Used to specify the resulting matrices. Possible values are
            listed in the class's valid_annotations attribute.
        sources : list
            Indices of source coordinates to include in the matrix.
            Default is all coordinates.
        destinations : list
            Indices of destination coordinates to include in the
            matrix. Default is all coordinates.

        Returns
        -------
        requests.Response

        Note: the directions matrix itself is obtained by calling the
        response's json() method. The resulting mapping has a code,
        the destinations and the sources, and depending of the
        annotations specified, it can also contain a durations matrix,
        a distances matrix or both of them (by default, only the
        durations matrix is provided).

        code : str
            Status of the response
        sources : list
            Results of snapping selected coordinates to the nearest
            addresses.
        destinations : list
            Results of snapping selected coordinates to the nearest
            addresses.
        durations : list
            An array of arrays representing the matrix in row-major
            order.  durations[i][j] gives the travel time from the i-th
            source to the j-th destination. All values are in seconds.
            The duration between the same coordinate is always 0. If
            a duration can not be found, the result is null.
        distances : list
            An array of arrays representing the matrix in row-major
            order.  distances[i][j] gives the distance from the i-th
            source to the j-th destination. All values are in meters.
            The distance between the same coordinate is always 0. If
            a distance can not be found, the result is null.